From 3075719963bc01dd86c905c6d0582b55d865b657 Mon Sep 17 00:00:00 2001
From: "N0\\A" <n0va@krzak.org>
Date: Thu, 26 Mar 2026 13:16:34 +0100
Subject: [PATCH] feat: might be actually feature-complete by now

---
 awk/definition_lists.awk   |  62 +++
 awk/emoji.awk              | 857 +++++++++++++++++++++++++++++++++++++
 awk/footnotes.awk          |  51 +++
 awk/markdown_inline.awk    |   2 +
 awk/paragraphs.awk         |   2 +-
 awk/toc.awk                |  50 +++
 kewt.sh                    | 215 ++++++++--
 markdown.sh                |   7 +
 site/Docs/configuration.md |  26 +-
 site/Docs/usage.md         |   6 +
 site/index.md              |   9 +-
 styles/kewt.css            |  23 +
 12 files changed, 1274 insertions(+), 36 deletions(-)
 create mode 100644 awk/definition_lists.awk
 create mode 100644 awk/emoji.awk
 create mode 100644 awk/footnotes.awk
 create mode 100644 awk/toc.awk

diff --git a/awk/definition_lists.awk b/awk/definition_lists.awk
new file mode 100644
index 0000000..13ed75d
--- /dev/null
+++ b/awk/definition_lists.awk
@@ -0,0 +1,62 @@
+BEGIN {
+    in_dl = 0
+    has_prev = 0
+    prev_line = ""
+    in_pre = 0
+}
+{
+    if ($0 ~ /^<pre>/) {
+        if (!in_pre) in_pre = 1
+    }
+    
+    if (!in_pre && $0 ~ /^:[ \t]+[^ \t]/) {
+        if (!in_dl) {
+            in_dl = 1
+            print "<dl>"
+            print "<dt>" prev_line "</dt>"
+            has_prev = 0
+        } else {
+            if (has_prev && prev_line != "") {
+                print "<dt>" prev_line "</dt>"
+                has_prev = 0
+            }
+        }
+        def_text = $0
+        sub(/^:[ \t]+/, "", def_text)
+        print "<dd>" def_text "</dd>"
+        
+        if ($0 ~ /<\/pre>/) {
+            if (in_pre) in_pre = 0
+        }
+        next
+    } else {
+        if (in_dl) {
+            if ($0 == "") {
+                # End of definition list
+                print "</dl>"
+                in_dl = 0
+                print ""
+                has_prev = 0
+                next
+            }
+        }
+        if (has_prev) {
+            print prev_line
+        }
+        prev_line = $0
+        has_prev = 1
+    }
+    
+    if ($0 ~ /<\/pre>/) {
+        if (in_pre) in_pre = 0
+    }
+}
+END {
+    if (in_dl) {
+        print "</dl>"
+    } else {
+        if (has_prev) {
+            print prev_line
+        }
+    }
+}
diff --git a/awk/emoji.awk b/awk/emoji.awk
new file mode 100644
index 0000000..2324174
--- /dev/null
+++ b/awk/emoji.awk
@@ -0,0 +1,857 @@
+BEGIN {
+    map[":+1:"] = "👍"
+    map[":100:"] = "💯"
+    map[":1234:"] = "🔢"
+    map[":8ball:"] = "🎱"
+    map[":a:"] = "🅰️"
+    map[":ab:"] = "🆎"
+    map[":abc:"] = "🔤"
+    map[":abcd:"] = "🔡"
+    map[":accept:"] = "🉑"
+    map[":aerial_tramway:"] = "🚡"
+    map[":airplane:"] = "✈️"
+    map[":alarm_clock:"] = "⏰"
+    map[":alien:"] = "👽"
+    map[":ambulance:"] = "🚑"
+    map[":anchor:"] = "⚓"
+    map[":angel:"] = "👼"
+    map[":anger:"] = "💢"
+    map[":angry:"] = "😠"
+    map[":anguished:"] = "😧"
+    map[":ant:"] = "🐜"
+    map[":apple:"] = "🍎"
+    map[":aquarius:"] = "♒"
+    map[":aries:"] = "♈"
+    map[":arrow_backward:"] = "◀️"
+    map[":arrow_double_down:"] = "⏬"
+    map[":arrow_double_up:"] = "⏫"
+    map[":arrow_down:"] = "⬇️"
+    map[":arrow_down_small:"] = "🔽"
+    map[":arrow_forward:"] = "▶️"
+    map[":arrow_heading_down:"] = "⤵️"
+    map[":arrow_heading_up:"] = "⤴️"
+    map[":arrow_left:"] = "⬅️"
+    map[":arrow_lower_left:"] = "↙️"
+    map[":arrow_lower_right:"] = "↘️"
+    map[":arrow_right:"] = "➡️"
+    map[":arrow_right_hook:"] = "↪️"
+    map[":arrow_up:"] = "⬆️"
+    map[":arrow_up_down:"] = "↕️"
+    map[":arrow_up_small:"] = "🔼"
+    map[":arrow_upper_left:"] = "↖️"
+    map[":arrow_upper_right:"] = "↗️"
+    map[":arrows_clockwise:"] = "🔃"
+    map[":arrows_counterclockwise:"] = "🔄"
+    map[":art:"] = "🎨"
+    map[":articulated_lorry:"] = "🚛"
+    map[":astonished:"] = "😲"
+    map[":atm:"] = "🏧"
+    map[":b:"] = "🅱️"
+    map[":baby:"] = "👶"
+    map[":baby_bottle:"] = "🍼"
+    map[":baby_chick:"] = "🐤"
+    map[":baby_symbol:"] = "🚼"
+    map[":baggage_claim:"] = "🛄"
+    map[":balloon:"] = "🎈"
+    map[":ballot_box_with_check:"] = "☑️"
+    map[":bamboo:"] = "🎍"
+    map[":banana:"] = "🍌"
+    map[":bangbang:"] = "‼️"
+    map[":bank:"] = "🏦"
+    map[":bar_chart:"] = "📊"
+    map[":barber:"] = "💈"
+    map[":baseball:"] = "⚾"
+    map[":basketball:"] = "🏀"
+    map[":bath:"] = "🛀"
+    map[":bathtub:"] = "🛁"
+    map[":battery:"] = "🔋"
+    map[":bear:"] = "🐻"
+    map[":beer:"] = "🍺"
+    map[":beers:"] = "🍻"
+    map[":beetle:"] = "🪲"
+    map[":beginner:"] = "🔰"
+    map[":bell:"] = "🔔"
+    map[":bento:"] = "🍱"
+    map[":bicyclist:"] = "🚴"
+    map[":bike:"] = "🚲"
+    map[":bikini:"] = "👙"
+    map[":bird:"] = "🐦"
+    map[":birthday:"] = "🎂"
+    map[":black_circle:"] = "⚫"
+    map[":black_joker:"] = "🃏"
+    map[":black_nib:"] = "✒️"
+    map[":black_square_button:"] = "🔲"
+    map[":blossom:"] = "🌼"
+    map[":blowfish:"] = "🐡"
+    map[":blue_book:"] = "📘"
+    map[":blue_car:"] = "🚙"
+    map[":blue_heart:"] = "💙"
+    map[":blush:"] = "😊"
+    map[":boar:"] = "🐗"
+    map[":boat:"] = "⛵"
+    map[":bomb:"] = "💣"
+    map[":book:"] = "📖"
+    map[":bookmark:"] = "🔖"
+    map[":bookmark_tabs:"] = "📑"
+    map[":books:"] = "📚"
+    map[":boom:"] = "💥"
+    map[":boot:"] = "👢"
+    map[":bouquet:"] = "💐"
+    map[":bow:"] = "🙇"
+    map[":bowling:"] = "🎳"
+    map[":boy:"] = "👦"
+    map[":bread:"] = "🍞"
+    map[":bride_with_veil:"] = "👰‍♀️"
+    map[":bridge_at_night:"] = "🌉"
+    map[":briefcase:"] = "💼"
+    map[":broken_heart:"] = "💔"
+    map[":bug:"] = "🐛"
+    map[":bulb:"] = "💡"
+    map[":bullettrain_front:"] = "🚅"
+    map[":bullettrain_side:"] = "🚄"
+    map[":bus:"] = "🚌"
+    map[":busstop:"] = "🚏"
+    map[":bust_in_silhouette:"] = "👤"
+    map[":busts_in_silhouette:"] = "👥"
+    map[":cactus:"] = "🌵"
+    map[":cake:"] = "🍰"
+    map[":calendar:"] = "📆"
+    map[":calling:"] = "📲"
+    map[":camel:"] = "🐫"
+    map[":camera:"] = "📷"
+    map[":cancer:"] = "♋"
+    map[":candy:"] = "🍬"
+    map[":capital_abcd:"] = "🔠"
+    map[":capricorn:"] = "♑"
+    map[":car:"] = "🚗"
+    map[":card_index:"] = "📇"
+    map[":carousel_horse:"] = "🎠"
+    map[":cat2:"] = "🐈"
+    map[":cat:"] = "🐱"
+    map[":cd:"] = "💿"
+    map[":chart:"] = "💹"
+    map[":chart_with_downwards_trend:"] = "📉"
+    map[":chart_with_upwards_trend:"] = "📈"
+    map[":checkered_flag:"] = "🏁"
+    map[":cherries:"] = "🍒"
+    map[":cherry_blossom:"] = "🌸"
+    map[":chestnut:"] = "🌰"
+    map[":chicken:"] = "🐔"
+    map[":children_crossing:"] = "🚸"
+    map[":chocolate_bar:"] = "🍫"
+    map[":christmas_tree:"] = "🎄"
+    map[":church:"] = "⛪"
+    map[":cinema:"] = "🎦"
+    map[":circus_tent:"] = "🎪"
+    map[":city_sunrise:"] = "🌇"
+    map[":city_sunset:"] = "🌆"
+    map[":cl:"] = "🆑"
+    map[":clap:"] = "👏"
+    map[":clapper:"] = "🎬"
+    map[":clipboard:"] = "📋"
+    map[":clock1030:"] = "🕥"
+    map[":clock10:"] = "🕙"
+    map[":clock1130:"] = "🕦"
+    map[":clock11:"] = "🕚"
+    map[":clock1230:"] = "🕧"
+    map[":clock12:"] = "🕛"
+    map[":clock130:"] = "🕜"
+    map[":clock1:"] = "🕐"
+    map[":clock230:"] = "🕝"
+    map[":clock2:"] = "🕑"
+    map[":clock330:"] = "🕞"
+    map[":clock3:"] = "🕒"
+    map[":clock430:"] = "🕟"
+    map[":clock4:"] = "🕓"
+    map[":clock530:"] = "🕠"
+    map[":clock5:"] = "🕔"
+    map[":clock630:"] = "🕡"
+    map[":clock6:"] = "🕕"
+    map[":clock730:"] = "🕢"
+    map[":clock7:"] = "🕖"
+    map[":clock830:"] = "🕣"
+    map[":clock8:"] = "🕗"
+    map[":clock930:"] = "🕤"
+    map[":clock9:"] = "🕘"
+    map[":closed_book:"] = "📕"
+    map[":closed_lock_with_key:"] = "🔐"
+    map[":closed_umbrella:"] = "🌂"
+    map[":cloud:"] = "☁️"
+    map[":clubs:"] = "♣️"
+    map[":cn:"] = "🇨🇳"
+    map[":cocktail:"] = "🍸"
+    map[":coffee:"] = "☕"
+    map[":cold_sweat:"] = "😰"
+    map[":computer:"] = "💻"
+    map[":confetti_ball:"] = "🎊"
+    map[":confounded:"] = "😖"
+    map[":confused:"] = "😕"
+    map[":congratulations:"] = "㊗️"
+    map[":construction:"] = "🚧"
+    map[":construction_worker:"] = "👷"
+    map[":convenience_store:"] = "🏪"
+    map[":cookie:"] = "🍪"
+    map[":cool:"] = "🆒"
+    map[":cop:"] = "👮"
+    map[":copyright:"] = "©️"
+    map[":corn:"] = "🌽"
+    map[":couple:"] = "👫"
+    map[":couple_with_heart:"] = "💑"
+    map[":couplekiss:"] = "💏"
+    map[":cow2:"] = "🐄"
+    map[":cow:"] = "🐮"
+    map[":credit_card:"] = "💳"
+    map[":crocodile:"] = "🐊"
+    map[":crossed_flags:"] = "🎌"
+    map[":crown:"] = "👑"
+    map[":cry:"] = "😢"
+    map[":crying_cat_face:"] = "😿"
+    map[":crystal_ball:"] = "🔮"
+    map[":cupid:"] = "💘"
+    map[":curly_loop:"] = "➰"
+    map[":currency_exchange:"] = "💱"
+    map[":curry:"] = "🍛"
+    map[":custard:"] = "🍮"
+    map[":customs:"] = "🛃"
+    map[":cyclone:"] = "🌀"
+    map[":dancer:"] = "💃"
+    map[":dancers:"] = "👯"
+    map[":dango:"] = "🍡"
+    map[":dart:"] = "🎯"
+    map[":dash:"] = "💨"
+    map[":date:"] = "📅"
+    map[":de:"] = "🇩🇪"
+    map[":deciduous_tree:"] = "🌳"
+    map[":department_store:"] = "🏬"
+    map[":diamond_shape_with_a_dot_inside:"] = "💠"
+    map[":diamonds:"] = "♦️"
+    map[":disappointed:"] = "😞"
+    map[":disappointed_relieved:"] = "😥"
+    map[":dizzy:"] = "💫"
+    map[":dizzy_face:"] = "😵"
+    map[":do_not_litter:"] = "🚯"
+    map[":dog2:"] = "🐕"
+    map[":dog:"] = "🐶"
+    map[":dollar:"] = "💵"
+    map[":dolls:"] = "🎎"
+    map[":dolphin:"] = "🐬"
+    map[":door:"] = "🚪"
+    map[":doughnut:"] = "🍩"
+    map[":dragon:"] = "🐉"
+    map[":dragon_face:"] = "🐲"
+    map[":dress:"] = "👗"
+    map[":dromedary_camel:"] = "🐪"
+    map[":droplet:"] = "💧"
+    map[":dvd:"] = "📀"
+    map[":ear:"] = "👂"
+    map[":ear_of_rice:"] = "🌾"
+    map[":earth_africa:"] = "🌍"
+    map[":earth_americas:"] = "🌎"
+    map[":earth_asia:"] = "🌏"
+    map[":egg:"] = "🥚"
+    map[":eggplant:"] = "🍆"
+    map[":eight:"] = "8️⃣"
+    map[":eight_pointed_black_star:"] = "✴️"
+    map[":eight_spoked_asterisk:"] = "✳️"
+    map[":electric_plug:"] = "🔌"
+    map[":elephant:"] = "🐘"
+    map[":email:"] = "📧"
+    map[":end:"] = "🔚"
+    map[":envelope:"] = "✉️"
+    map[":es:"] = "🇪🇸"
+    map[":euro:"] = "💶"
+    map[":european_castle:"] = "🏰"
+    map[":european_post_office:"] = "🏤"
+    map[":evergreen_tree:"] = "🌲"
+    map[":exclamation:"] = "❗"
+    map[":expressionless:"] = "😑"
+    map[":eyeglasses:"] = "👓"
+    map[":eyes:"] = "👀"
+    map[":factory:"] = "🏭"
+    map[":fallen_leaf:"] = "🍂"
+    map[":family:"] = "👪"
+    map[":fast_forward:"] = "⏩"
+    map[":fax:"] = "📠"
+    map[":fearful:"] = "😨"
+    map[":feet:"] = "🐾"
+    map[":ferris_wheel:"] = "🎡"
+    map[":file_folder:"] = "📁"
+    map[":fire:"] = "🔥"
+    map[":fire_engine:"] = "🚒"
+    map[":fireworks:"] = "🎆"
+    map[":first_quarter_moon:"] = "🌓"
+    map[":first_quarter_moon_with_face:"] = "🌛"
+    map[":fish:"] = "🐟"
+    map[":fish_cake:"] = "🍥"
+    map[":fishing_pole_and_fish:"] = "🎣"
+    map[":fist:"] = "✊"
+    map[":five:"] = "5️⃣"
+    map[":flags:"] = "🎏"
+    map[":flashlight:"] = "🔦"
+    map[":floppy_disk:"] = "💾"
+    map[":flower_playing_cards:"] = "🎴"
+    map[":flushed:"] = "😳"
+    map[":foggy:"] = "🌁"
+    map[":football:"] = "🏈"
+    map[":fork_and_knife:"] = "🍴"
+    map[":fountain:"] = "⛲"
+    map[":four:"] = "4️⃣"
+    map[":four_leaf_clover:"] = "🍀"
+    map[":fr:"] = "🇫🇷"
+    map[":free:"] = "🆓"
+    map[":fried_shrimp:"] = "🍤"
+    map[":fries:"] = "🍟"
+    map[":frog:"] = "🐸"
+    map[":frowning:"] = "😦"
+    map[":fuelpump:"] = "⛽"
+    map[":full_moon:"] = "🌕"
+    map[":full_moon_with_face:"] = "🌝"
+    map[":game_die:"] = "🎲"
+    map[":gem:"] = "💎"
+    map[":gemini:"] = "♊"
+    map[":ghost:"] = "👻"
+    map[":gift:"] = "🎁"
+    map[":gift_heart:"] = "💝"
+    map[":girl:"] = "👧"
+    map[":globe_with_meridians:"] = "🌐"
+    map[":goat:"] = "🐐"
+    map[":golf:"] = "⛳"
+    map[":grapes:"] = "🍇"
+    map[":green_apple:"] = "🍏"
+    map[":green_book:"] = "📗"
+    map[":green_heart:"] = "💚"
+    map[":grey_exclamation:"] = "❕"
+    map[":grey_question:"] = "❔"
+    map[":grimacing:"] = "😬"
+    map[":grin:"] = "😁"
+    map[":grinning:"] = "😀"
+    map[":guardsman:"] = "💂‍♂️"
+    map[":guitar:"] = "🎸"
+    map[":gun:"] = "🔫"
+    map[":haircut:"] = "💇"
+    map[":hamburger:"] = "🍔"
+    map[":hammer:"] = "🔨"
+    map[":hamster:"] = "🐹"
+    map[":handbag:"] = "👜"
+    map[":hankey:"] = "💩"
+    map[":hash:"] = "#️⃣"
+    map[":hatched_chick:"] = "🐥"
+    map[":hatching_chick:"] = "🐣"
+    map[":headphones:"] = "🎧"
+    map[":hear_no_evil:"] = "🙉"
+    map[":heart:"] = "❤️"
+    map[":heart_decoration:"] = "💟"
+    map[":heart_eyes:"] = "😍"
+    map[":heart_eyes_cat:"] = "😻"
+    map[":heartbeat:"] = "💓"
+    map[":hearts:"] = "♥️"
+    map[":heavy_check_mark:"] = "✔️"
+    map[":heavy_division_sign:"] = "➗"
+    map[":heavy_dollar_sign:"] = "💲"
+    map[":heavy_minus_sign:"] = "➖"
+    map[":heavy_multiplication_x:"] = "✖️"
+    map[":heavy_plus_sign:"] = "➕"
+    map[":helicopter:"] = "🚁"
+    map[":herb:"] = "🌿"
+    map[":hibiscus:"] = "🌺"
+    map[":high_brightness:"] = "🔆"
+    map[":high_heel:"] = "👠"
+    map[":honey_pot:"] = "🍯"
+    map[":horse:"] = "🐴"
+    map[":horse_racing:"] = "🏇"
+    map[":hospital:"] = "🏥"
+    map[":hotel:"] = "🏨"
+    map[":hotsprings:"] = "♨️"
+    map[":hourglass:"] = "⌛"
+    map[":hourglass_flowing_sand:"] = "⏳"
+    map[":house:"] = "🏠"
+    map[":house_with_garden:"] = "🏡"
+    map[":hushed:"] = "😯"
+    map[":ice_cream:"] = "🍨"
+    map[":icecream:"] = "🍦"
+    map[":id:"] = "🆔"
+    map[":ideograph_advantage:"] = "🉐"
+    map[":imp:"] = "👿"
+    map[":inbox_tray:"] = "📥"
+    map[":incoming_envelope:"] = "📨"
+    map[":information_desk_person:"] = "💁"
+    map[":information_source:"] = "ℹ️"
+    map[":innocent:"] = "😇"
+    map[":interrobang:"] = "⁉️"
+    map[":iphone:"] = "📱"
+    map[":it:"] = "🇮🇹"
+    map[":izakaya_lantern:"] = "🏮"
+    map[":jack_o_lantern:"] = "🎃"
+    map[":japan:"] = "🗾"
+    map[":japanese_castle:"] = "🏯"
+    map[":japanese_goblin:"] = "👺"
+    map[":japanese_ogre:"] = "👹"
+    map[":jeans:"] = "👖"
+    map[":joy:"] = "😂"
+    map[":joy_cat:"] = "😹"
+    map[":jp:"] = "🇯🇵"
+    map[":key:"] = "🔑"
+    map[":keycap_ten:"] = "🔟"
+    map[":kimono:"] = "👘"
+    map[":kiss:"] = "💋"
+    map[":kissing:"] = "😗"
+    map[":kissing_cat:"] = "😽"
+    map[":kissing_closed_eyes:"] = "😚"
+    map[":kissing_heart:"] = "😘"
+    map[":kissing_smiling_eyes:"] = "😙"
+    map[":koala:"] = "🐨"
+    map[":koko:"] = "🈁"
+    map[":kr:"] = "🇰🇷"
+    map[":large_blue_diamond:"] = "🔷"
+    map[":large_orange_diamond:"] = "🔶"
+    map[":last_quarter_moon:"] = "🌗"
+    map[":last_quarter_moon_with_face:"] = "🌜"
+    map[":laughing:"] = "😆"
+    map[":leaves:"] = "🍃"
+    map[":ledger:"] = "📒"
+    map[":left_luggage:"] = "🛅"
+    map[":left_right_arrow:"] = "↔️"
+    map[":leftwards_arrow_with_hook:"] = "↩️"
+    map[":lemon:"] = "🍋"
+    map[":leo:"] = "♌"
+    map[":leopard:"] = "🐆"
+    map[":libra:"] = "♎"
+    map[":light_rail:"] = "🚈"
+    map[":link:"] = "🔗"
+    map[":lips:"] = "👄"
+    map[":lipstick:"] = "💄"
+    map[":lock:"] = "🔒"
+    map[":lock_with_ink_pen:"] = "🔏"
+    map[":lollipop:"] = "🍭"
+    map[":loop:"] = "➿"
+    map[":loudspeaker:"] = "📢"
+    map[":love_hotel:"] = "🏩"
+    map[":love_letter:"] = "💌"
+    map[":low_brightness:"] = "🔅"
+    map[":m:"] = "Ⓜ️"
+    map[":mag:"] = "🔍"
+    map[":mag_right:"] = "🔎"
+    map[":mahjong:"] = "🀄"
+    map[":mailbox:"] = "📫"
+    map[":mailbox_closed:"] = "📪"
+    map[":mailbox_with_mail:"] = "📬"
+    map[":mailbox_with_no_mail:"] = "📭"
+    map[":man:"] = "👨"
+    map[":man_with_gua_pi_mao:"] = "👲"
+    map[":man_with_turban:"] = "👳‍♂️"
+    map[":mans_shoe:"] = "👞"
+    map[":maple_leaf:"] = "🍁"
+    map[":mask:"] = "😷"
+    map[":massage:"] = "💆"
+    map[":meat_on_bone:"] = "🍖"
+    map[":mega:"] = "📣"
+    map[":melon:"] = "🍈"
+    map[":memo:"] = "📝"
+    map[":mens:"] = "🚹"
+    map[":metal:"] = "🤘"
+    map[":metro:"] = "🚇"
+    map[":microphone:"] = "🎤"
+    map[":microscope:"] = "🔬"
+    map[":milky_way:"] = "🌌"
+    map[":minibus:"] = "🚐"
+    map[":minidisc:"] = "💽"
+    map[":mobile_phone_off:"] = "📴"
+    map[":money_with_wings:"] = "💸"
+    map[":moneybag:"] = "💰"
+    map[":monkey:"] = "🐒"
+    map[":monkey_face:"] = "🐵"
+    map[":monorail:"] = "🚝"
+    map[":mortar_board:"] = "🎓"
+    map[":mount_fuji:"] = "🗻"
+    map[":mountain_bicyclist:"] = "🚵"
+    map[":mountain_cableway:"] = "🚠"
+    map[":mountain_railway:"] = "🚞"
+    map[":mouse2:"] = "🐁"
+    map[":mouse:"] = "🐭"
+    map[":movie_camera:"] = "🎥"
+    map[":moyai:"] = "🗿"
+    map[":muscle:"] = "💪"
+    map[":mushroom:"] = "🍄"
+    map[":musical_keyboard:"] = "🎹"
+    map[":musical_note:"] = "🎵"
+    map[":musical_score:"] = "🎼"
+    map[":mute:"] = "🔇"
+    map[":nail_care:"] = "💅"
+    map[":name_badge:"] = "📛"
+    map[":necktie:"] = "👔"
+    map[":negative_squared_cross_mark:"] = "❎"
+    map[":neutral_face:"] = "😐"
+    map[":new:"] = "🆕"
+    map[":new_moon:"] = "🌑"
+    map[":new_moon_with_face:"] = "🌚"
+    map[":newspaper:"] = "📰"
+    map[":ng:"] = "🆖"
+    map[":nine:"] = "9️⃣"
+    map[":no_bell:"] = "🔕"
+    map[":no_bicycles:"] = "🚳"
+    map[":no_entry:"] = "⛔"
+    map[":no_entry_sign:"] = "🚫"
+    map[":no_good:"] = "🙅"
+    map[":no_mobile_phones:"] = "📵"
+    map[":no_mouth:"] = "😶"
+    map[":no_pedestrians:"] = "🚷"
+    map[":no_smoking:"] = "🚭"
+    map[":nose:"] = "👃"
+    map[":notebook:"] = "📓"
+    map[":notebook_with_decorative_cover:"] = "📔"
+    map[":notes:"] = "🎶"
+    map[":nut_and_bolt:"] = "🔩"
+    map[":o2:"] = "🅾️"
+    map[":o:"] = "⭕"
+    map[":ocean:"] = "🌊"
+    map[":octopus:"] = "🐙"
+    map[":oden:"] = "🍢"
+    map[":office:"] = "🏢"
+    map[":ok:"] = "🆗"
+    map[":ok_hand:"] = "👌"
+    map[":ok_woman:"] = "🙆‍♀️"
+    map[":older_man:"] = "👴"
+    map[":older_woman:"] = "👵"
+    map[":on:"] = "🔛"
+    map[":oncoming_automobile:"] = "🚘"
+    map[":oncoming_bus:"] = "🚍"
+    map[":oncoming_police_car:"] = "🚔"
+    map[":oncoming_taxi:"] = "🚖"
+    map[":one:"] = "1️⃣"
+    map[":open_file_folder:"] = "📂"
+    map[":open_hands:"] = "👐"
+    map[":open_mouth:"] = "😮"
+    map[":ophiuchus:"] = "⛎"
+    map[":orange_book:"] = "📙"
+    map[":outbox_tray:"] = "📤"
+    map[":ox:"] = "🐂"
+    map[":page_facing_up:"] = "📄"
+    map[":page_with_curl:"] = "📃"
+    map[":pager:"] = "📟"
+    map[":palm_tree:"] = "🌴"
+    map[":panda_face:"] = "🐼"
+    map[":paperclip:"] = "📎"
+    map[":parking:"] = "🅿️"
+    map[":part_alternation_mark:"] = "〽️"
+    map[":partly_sunny:"] = "⛅"
+    map[":passport_control:"] = "🛂"
+    map[":paw_prints:"] = "🐾"
+    map[":peach:"] = "🍑"
+    map[":pear:"] = "🍐"
+    map[":pencil2:"] = "✏️"
+    map[":pencil:"] = "📝"
+    map[":penguin:"] = "🐧"
+    map[":pensive:"] = "😔"
+    map[":performing_arts:"] = "🎭"
+    map[":persevere:"] = "😣"
+    map[":pig2:"] = "🐖"
+    map[":pig:"] = "🐷"
+    map[":pig_nose:"] = "🐽"
+    map[":pill:"] = "💊"
+    map[":pineapple:"] = "🍍"
+    map[":pisces:"] = "♓"
+    map[":pizza:"] = "🍕"
+    map[":point_down:"] = "👇"
+    map[":point_left:"] = "👈"
+    map[":point_right:"] = "👉"
+    map[":point_up:"] = "☝️"
+    map[":point_up_2:"] = "👆"
+    map[":police_car:"] = "🚓"
+    map[":poodle:"] = "🐩"
+    map[":poop:"] = "💩"
+    map[":post_office:"] = "🏣"
+    map[":postal_horn:"] = "📯"
+    map[":postbox:"] = "📮"
+    map[":potable_water:"] = "🚰"
+    map[":pouch:"] = "👝"
+    map[":poultry_leg:"] = "🍗"
+    map[":pound:"] = "💷"
+    map[":pouting_cat:"] = "😾"
+    map[":pray:"] = "🙏"
+    map[":princess:"] = "👸"
+    map[":punch:"] = "👊"
+    map[":purple_heart:"] = "💜"
+    map[":purse:"] = "👛"
+    map[":pushpin:"] = "📌"
+    map[":put_litter_in_its_place:"] = "🚮"
+    map[":question:"] = "❓"
+    map[":rabbit2:"] = "🐇"
+    map[":rabbit:"] = "🐰"
+    map[":racehorse:"] = "🐎"
+    map[":radio:"] = "📻"
+    map[":radio_button:"] = "🔘"
+    map[":rage:"] = "😡"
+    map[":railway_car:"] = "🚃"
+    map[":rainbow:"] = "🌈"
+    map[":raised_hand:"] = "✋"
+    map[":raised_hands:"] = "🙌"
+    map[":raising_hand:"] = "🙋"
+    map[":ram:"] = "🐏"
+    map[":ramen:"] = "🍜"
+    map[":rat:"] = "🐀"
+    map[":recycle:"] = "♻️"
+    map[":red_car:"] = "🚗"
+    map[":red_circle:"] = "🔴"
+    map[":registered:"] = "®️"
+    map[":relaxed:"] = "☺️"
+    map[":relieved:"] = "😌"
+    map[":repeat:"] = "🔁"
+    map[":repeat_one:"] = "🔂"
+    map[":restroom:"] = "🚻"
+    map[":revolving_hearts:"] = "💞"
+    map[":rewind:"] = "⏪"
+    map[":ribbon:"] = "🎀"
+    map[":rice:"] = "🍚"
+    map[":rice_ball:"] = "🍙"
+    map[":rice_cracker:"] = "🍘"
+    map[":rice_scene:"] = "🎑"
+    map[":ring:"] = "💍"
+    map[":rocket:"] = "🚀"
+    map[":roller_coaster:"] = "🎢"
+    map[":rooster:"] = "🐓"
+    map[":rose:"] = "🌹"
+    map[":rotating_light:"] = "🚨"
+    map[":round_pushpin:"] = "📍"
+    map[":rowboat:"] = "🚣"
+    map[":ru:"] = "🇷🇺"
+    map[":rugby_football:"] = "🏉"
+    map[":runner:"] = "🏃"
+    map[":running_shirt_with_sash:"] = "🎽"
+    map[":sa:"] = "🈂️"
+    map[":sagittarius:"] = "♐"
+    map[":sailboat:"] = "⛵"
+    map[":sake:"] = "🍶"
+    map[":sandal:"] = "👡"
+    map[":santa:"] = "🎅"
+    map[":satellite:"] = "📡"
+    map[":satisfied:"] = "😆"
+    map[":saxophone:"] = "🎷"
+    map[":school:"] = "🏫"
+    map[":school_satchel:"] = "🎒"
+    map[":scissors:"] = "✂️"
+    map[":scorpius:"] = "♏"
+    map[":scream:"] = "😱"
+    map[":scream_cat:"] = "🙀"
+    map[":scroll:"] = "📜"
+    map[":seat:"] = "💺"
+    map[":secret:"] = "㊙️"
+    map[":see_no_evil:"] = "🙈"
+    map[":seedling:"] = "🌱"
+    map[":seven:"] = "7️⃣"
+    map[":shaved_ice:"] = "🍧"
+    map[":sheep:"] = "🐑"
+    map[":shell:"] = "🐚"
+    map[":ship:"] = "🚢"
+    map[":shirt:"] = "👕"
+    map[":shit:"] = "💩"
+    map[":shower:"] = "🚿"
+    map[":signal_strength:"] = "📶"
+    map[":six:"] = "6️⃣"
+    map[":six_pointed_star:"] = "🔯"
+    map[":ski:"] = "🎿"
+    map[":skull:"] = "💀"
+    map[":sleeping:"] = "😴"
+    map[":sleepy:"] = "😪"
+    map[":slot_machine:"] = "🎰"
+    map[":small_blue_diamond:"] = "🔹"
+    map[":small_orange_diamond:"] = "🔸"
+    map[":small_red_triangle:"] = "🔺"
+    map[":small_red_triangle_down:"] = "🔻"
+    map[":smile:"] = "😄"
+    map[":smile_cat:"] = "😸"
+    map[":smiley:"] = "😃"
+    map[":smiley_cat:"] = "😺"
+    map[":smiling_imp:"] = "😈"
+    map[":smirk:"] = "😏"
+    map[":smirk_cat:"] = "😼"
+    map[":smoking:"] = "🚬"
+    map[":snail:"] = "🐌"
+    map[":snake:"] = "🐍"
+    map[":snowboarder:"] = "🏂"
+    map[":snowflake:"] = "❄️"
+    map[":snowman:"] = "⛄"
+    map[":sob:"] = "😭"
+    map[":soccer:"] = "⚽"
+    map[":soon:"] = "🔜"
+    map[":sos:"] = "🆘"
+    map[":sound:"] = "🔉"
+    map[":space_invader:"] = "👾"
+    map[":spades:"] = "♠️"
+    map[":spaghetti:"] = "🍝"
+    map[":sparkler:"] = "🎇"
+    map[":sparkles:"] = "✨"
+    map[":sparkling_heart:"] = "💖"
+    map[":speak_no_evil:"] = "🙊"
+    map[":speaker:"] = "🔈"
+    map[":speech_balloon:"] = "💬"
+    map[":speedboat:"] = "🚤"
+    map[":star2:"] = "🌟"
+    map[":star:"] = "⭐"
+    map[":stars:"] = "🌠"
+    map[":station:"] = "🚉"
+    map[":statue_of_liberty:"] = "🗽"
+    map[":steam_locomotive:"] = "🚂"
+    map[":stew:"] = "🍲"
+    map[":straight_ruler:"] = "📏"
+    map[":strawberry:"] = "🍓"
+    map[":stuck_out_tongue:"] = "😛"
+    map[":stuck_out_tongue_closed_eyes:"] = "😝"
+    map[":stuck_out_tongue_winking_eye:"] = "😜"
+    map[":sun_with_face:"] = "🌞"
+    map[":sunflower:"] = "🌻"
+    map[":sunglasses:"] = "😎"
+    map[":sunny:"] = "☀️"
+    map[":sunrise:"] = "🌅"
+    map[":sunrise_over_mountains:"] = "🌄"
+    map[":surfer:"] = "🏄"
+    map[":sushi:"] = "🍣"
+    map[":suspension_railway:"] = "🚟"
+    map[":sweat:"] = "😓"
+    map[":sweat_drops:"] = "💦"
+    map[":sweat_smile:"] = "😅"
+    map[":sweet_potato:"] = "🍠"
+    map[":swimmer:"] = "🏊"
+    map[":symbols:"] = "🔣"
+    map[":syringe:"] = "💉"
+    map[":tada:"] = "🎉"
+    map[":tanabata_tree:"] = "🎋"
+    map[":tangerine:"] = "🍊"
+    map[":taurus:"] = "♉"
+    map[":taxi:"] = "🚕"
+    map[":tea:"] = "🍵"
+    map[":telephone:"] = "☎️"
+    map[":telephone_receiver:"] = "📞"
+    map[":telescope:"] = "🔭"
+    map[":tennis:"] = "🎾"
+    map[":tent:"] = "⛺"
+    map[":thought_balloon:"] = "💭"
+    map[":three:"] = "3️⃣"
+    map[":thumbsdown:"] = "👎"
+    map[":thumbsup:"] = "👍"
+    map[":ticket:"] = "🎫"
+    map[":tiger2:"] = "🐅"
+    map[":tiger:"] = "🐯"
+    map[":tired_face:"] = "😫"
+    map[":tm:"] = "™️"
+    map[":toilet:"] = "🚽"
+    map[":tokyo_tower:"] = "🗼"
+    map[":tomato:"] = "🍅"
+    map[":tongue:"] = "👅"
+    map[":top:"] = "🔝"
+    map[":tophat:"] = "🎩"
+    map[":tractor:"] = "🚜"
+    map[":traffic_light:"] = "🚥"
+    map[":train2:"] = "🚆"
+    map[":train:"] = "🚋"
+    map[":tram:"] = "🚊"
+    map[":triangular_flag_on_post:"] = "🚩"
+    map[":triangular_ruler:"] = "📐"
+    map[":trident:"] = "🔱"
+    map[":triumph:"] = "😤"
+    map[":trolleybus:"] = "🚎"
+    map[":trophy:"] = "🏆"
+    map[":tropical_drink:"] = "🍹"
+    map[":tropical_fish:"] = "🐠"
+    map[":truck:"] = "🚚"
+    map[":trumpet:"] = "🎺"
+    map[":tulip:"] = "🌷"
+    map[":turtle:"] = "🐢"
+    map[":tv:"] = "📺"
+    map[":twisted_rightwards_arrows:"] = "🔀"
+    map[":two:"] = "2️⃣"
+    map[":two_men_holding_hands:"] = "👬"
+    map[":two_women_holding_hands:"] = "👭"
+    map[":u5272:"] = "🈹"
+    map[":u5408:"] = "🈴"
+    map[":u55b6:"] = "🈺"
+    map[":u6307:"] = "🈯"
+    map[":u6708:"] = "🈷️"
+    map[":u6709:"] = "🈶"
+    map[":u6e80:"] = "🈵"
+    map[":u7121:"] = "🈚"
+    map[":u7533:"] = "🈸"
+    map[":u7981:"] = "🈲"
+    map[":u7a7a:"] = "🈳"
+    map[":umbrella:"] = "☔"
+    map[":unamused:"] = "😒"
+    map[":underage:"] = "🔞"
+    map[":unlock:"] = "🔓"
+    map[":up:"] = "🆙"
+    map[":us:"] = "🇺🇸"
+    map[":v:"] = "✌️"
+    map[":vertical_traffic_light:"] = "🚦"
+    map[":vhs:"] = "📼"
+    map[":vibration_mode:"] = "📳"
+    map[":video_camera:"] = "📹"
+    map[":video_game:"] = "🎮"
+    map[":violin:"] = "🎻"
+    map[":virgo:"] = "♍"
+    map[":volcano:"] = "🌋"
+    map[":vs:"] = "🆚"
+    map[":walking:"] = "🚶"
+    map[":waning_crescent_moon:"] = "🌘"
+    map[":waning_gibbous_moon:"] = "🌖"
+    map[":warning:"] = "⚠️"
+    map[":watch:"] = "⌚"
+    map[":water_buffalo:"] = "🐃"
+    map[":watermelon:"] = "🍉"
+    map[":wave:"] = "👋"
+    map[":wavy_dash:"] = "〰️"
+    map[":waxing_crescent_moon:"] = "🌒"
+    map[":waxing_gibbous_moon:"] = "🌔"
+    map[":wc:"] = "🚾"
+    map[":weary:"] = "😩"
+    map[":wedding:"] = "💒"
+    map[":whale2:"] = "🐋"
+    map[":whale:"] = "🐳"
+    map[":wheelchair:"] = "♿"
+    map[":white_check_mark:"] = "✅"
+    map[":white_circle:"] = "⚪"
+    map[":white_flower:"] = "💮"
+    map[":white_square_button:"] = "🔳"
+    map[":wind_chime:"] = "🎐"
+    map[":wine_glass:"] = "🍷"
+    map[":wink:"] = "😉"
+    map[":wolf:"] = "🐺"
+    map[":woman:"] = "👩"
+    map[":womans_clothes:"] = "👚"
+    map[":womans_hat:"] = "👒"
+    map[":womens:"] = "🚺"
+    map[":worried:"] = "😟"
+    map[":wrench:"] = "🔧"
+    map[":x:"] = "❌"
+    map[":yellow_heart:"] = "💛"
+    map[":yen:"] = "💴"
+    map[":yum:"] = "😋"
+    map[":zap:"] = "⚡"
+    map[":zero:"] = "0️⃣"
+    map[":zzz:"] = "💤"
+}
+{
+    if ($0 ~ /<pre>/) in_pre = 1
+    if (!in_pre) {
+        code_count = 0
+        line = $0
+        out = ""
+        while (match(line, /<code>[^<]*<\/code>/)) {
+            code_count++
+            code_store[code_count] = substr(line, RSTART, RLENGTH)
+            out = out substr(line, 1, RSTART - 1) "\034EC" code_count "\034"
+            line = substr(line, RSTART + RLENGTH)
+        }
+        out = out line
+
+        for (sc in map) {
+            if (index(out, sc)) {
+                gsub(sc, map[sc], out)
+            }
+        }
+
+        for (i = 1; i <= code_count; i++) {
+            gsub("\034EC" i "\034", code_store[i], out)
+        }
+        $0 = out
+    }
+    if ($0 ~ /<\/pre>/) in_pre = 0
+    print
+}
diff --git a/awk/footnotes.awk b/awk/footnotes.awk
new file mode 100644
index 0000000..79bd712
--- /dev/null
+++ b/awk/footnotes.awk
@@ -0,0 +1,51 @@
+BEGIN { fn_count = 0 }
+
+# Match [^id]: text
+/^\[\^[a-zA-Z0-9_-]+\]:/ {
+    id_start = index($0, "[^") + 2
+    id_end = index($0, "]:")
+    id = substr($0, id_start, id_end - id_start)
+    text = substr($0, id_end + 2)
+    # Trim leading space
+    sub(/^[ \t]+/, "", text)
+    
+    fn_ids[++fn_count] = id
+    fn_texts[id] = text
+    next
+}
+
+{
+    lines[++line_count] = $0
+}
+
+END {
+    for (i = 1; i <= line_count; i++) {
+        line = lines[i]
+        
+        for (j = 1; j <= fn_count; j++) {
+            id = fn_ids[j]
+            marker = "[^" id "]"
+            repl = "<sup><a href=\"#fn:" id "\" id=\"fnref:" id "\">" id "</a></sup>"
+            
+            while ((pos = index(line, marker)) > 0) {
+                line = substr(line, 1, pos - 1) repl substr(line, pos + length(marker))
+            }
+        }
+        print line
+    }
+    
+    if (fn_count > 0) {
+        print "<hr />"
+        print "<section class=\"footnotes\">"
+        print "<ol>"
+        for (j = 1; j <= fn_count; j++) {
+            id = fn_ids[j]
+            text = fn_texts[id]
+            print "<li id=\"fn:" id "\">"
+            print "<p>" text " <a href=\"#fnref:" id "\" class=\"reversefootnote\">&#8617;</a></p>"
+            print "</li>"
+        }
+        print "</ol>"
+        print "</section>"
+    }
+}
diff --git a/awk/markdown_inline.awk b/awk/markdown_inline.awk
index 66e7ee7..9b05a7a 100644
--- a/awk/markdown_inline.awk
+++ b/awk/markdown_inline.awk
@@ -230,5 +230,7 @@ function restore_html_tags(s,    i, val) {
         }
     }
 
+    gsub(/<a href="https?:\/\/[^"]*"/, "& rel=\"noopener noreferrer\"", line)
+
     print line
 }
diff --git a/awk/paragraphs.awk b/awk/paragraphs.awk
index f5b0ba2..ef56265 100644
--- a/awk/paragraphs.awk
+++ b/awk/paragraphs.awk
@@ -13,7 +13,7 @@ BEGIN {
         next
     }
 
-    if ($0 ~ /^<\/?(div|table|p|[ou]l|h[1-6]|[bh]r|blockquote|li|hr)/) {
+    if ($0 ~ /^<\/?(div|table|p|[ou]l|h[1-6]|[bh]r|blockquote|li|hr|section|article|nav|aside|header|footer|dl|dt|dd)/) {
         if (in_p) {
             print "</p>"
             in_p = 0
diff --git a/awk/toc.awk b/awk/toc.awk
new file mode 100644
index 0000000..c35e2e1
--- /dev/null
+++ b/awk/toc.awk
@@ -0,0 +1,50 @@
+BEGIN {
+    toc_str = "<ol class=\"toc\">\n"
+    has_toc = 0
+}
+{
+    lines[++n] = $0
+    if ($0 ~ /<pre>/) in_pre = 1
+    if (!in_pre && $0 ~ /\{\{TOC\}\}/) {
+        has_toc = 1
+        toc_lines[n] = 1
+    }
+    if ($0 ~ /<\/pre>/) in_pre = 0
+    if (match($0, /<h[23][^>]*>/)) {
+        tag_len = RLENGTH
+        title_start = RSTART + tag_len
+        title_str = substr($0, title_start)
+        title_end = index(title_str, "</h")
+        if (title_end > 0) {
+            title = substr(title_str, 1, title_end - 1)
+            gsub(/<[^>]+>/, "", title)
+            
+            # extract id
+            id_start = match($0, /id="[^"]*"/)
+            if (id_start > 0) {
+                id_str = substr($0, id_start + 4)
+                id_end = index(id_str, "\"")
+                id = substr(id_str, 1, id_end - 1)
+                
+                # what tag? level
+                level = substr($0, match($0, /<h[23]/) + 2, 1)
+                
+                if (level == "2") {
+                    toc_str = toc_str "<li class=\"toc-h2\"><a href=\"#" id "\">" title "</a></li>\n"
+                } else if (level == "3") {
+                    toc_str = toc_str "<li class=\"toc-h3\"><a href=\"#" id "\">" title "</a></li>\n"
+                }
+            }
+        }
+    }
+}
+END {
+    toc_str = toc_str "</ol>"
+    for (i = 1; i <= n; i++) {
+        if (has_toc && toc_lines[i] && lines[i] ~ /^[[:space:]]*\{\{TOC\}\}[[:space:]]*$/) {
+            toc_lines[i] = 0 # Mark as processed if we want, but not strictly needed
+            sub(/\{\{TOC\}\}/, toc_str, lines[i])
+        }
+        print lines[i]
+    }
+}
diff --git a/kewt.sh b/kewt.sh
index 6928c6c..3633ab1 100755
--- a/kewt.sh
+++ b/kewt.sh
@@ -26,6 +26,8 @@ Options:
   --version                  Show version information.
   --from <src>               Source directory (default: site)
   --to <out>                 Output directory (default: out)
+  --watch, -w                Watch for file changes and rebuild automatically.
+  --serve, -s [port]         Start a local HTTP server after building (default port: 8000).
 EOF
 }
 
@@ -33,7 +35,8 @@ script_dir=$(CDPATH="" cd -- "$(dirname -- "$0")" && pwd)
 awk_dir="$script_dir/awk"
 
 KEWT_TMPDIR=$(mktemp -d "/tmp/kewt_run.XXXXXX")
-trap 'rm -rf "$KEWT_TMPDIR"' EXIT HUP INT TERM
+trap 'rm -rf "$KEWT_TMPDIR"' EXIT
+trap 'exit 0' HUP INT TERM
 
 DEFAULT_CONF='title = "kewt"
 style = "kewt"
@@ -59,6 +62,7 @@ base_url = ""
 generate_feed = false
 feed_file = "rss.xml"
 posts_dir = ""
+posts_per_page = 12
 custom_admonitions = ""'
 
 DEFAULT_TMPL='<!doctype html>
@@ -73,8 +77,10 @@ DEFAULT_TMPL='<!doctype html>
     </head>
 
     <body>
+        <input type="checkbox" id="nav-toggle" class="nav-toggle" aria-hidden="true" />
         <header>
             <h1>{{HEADER_BRAND}}</h1>
+            <label for="nav-toggle" class="nav-toggle-label" aria-hidden="true">&#9776;</label>
         </header>
 
         <nav id="side-bar">{{NAV}}</nav>
@@ -201,8 +207,6 @@ update_site() {
     exit 0
 }
 
-
-
 src=""
 out=""
 new_mode="false"
@@ -210,6 +214,8 @@ new_title=""
 post_mode="false"
 post_title=""
 positional_count=0
+watch_mode="false"
+serve_mode="false"
 
 while [ $# -gt 0 ]; do
     case "$1" in
@@ -261,6 +267,16 @@ while [ $# -gt 0 ]; do
             out="$2"
             shift
             ;;
+        --watch|-w)
+            watch_mode="true"
+            ;;
+        --serve|-s)
+            serve_mode="true"
+            if [ $# -ge 2 ] && echo "$2" | grep -qE '^[0-9]+$'; then
+                serve_port="$2"
+                shift
+            fi
+            ;;
         --*)
             die "Unknown option: $1"
             ;;
@@ -427,6 +443,7 @@ base_url=""
 generate_feed="false"
 feed_file="rss.xml"
 posts_dir=""
+posts_per_page="12"
 custom_admonitions=""
 
 load_config() {
@@ -479,6 +496,7 @@ load_config() {
             generate_feed) generate_feed="$val" ;;
             feed_file) feed_file="${val#/}" ;;
             posts_dir) posts_dir="${val#/}" ;;
+            posts_per_page) posts_per_page="$val" ;;
             custom_admonitions) custom_admonitions="$val" ;;
         esac
     done < "$1"
@@ -521,11 +539,13 @@ parse_frontmatter() {
     fm_title=""
     fm_date=""
     fm_draft=""
+    fm_description=""
     while IFS='=' read -r _fk _fv; do
         case "$_fk" in
             title) fm_title="$_fv" ;;
             date) fm_date="$_fv" ;;
             draft) fm_draft="$_fv" ;;
+            description) fm_description="$_fv" ;;
         esac
     done < "$_fm_out"
     rm -f "$_fm_out"
@@ -721,6 +741,22 @@ render_markdown() {
         fi
     fi
 
+    head_extra_og="<meta property=\"og:title\" content=\"$(escape_html_attr "$page_title")\" />"
+    if [ -n "$fm_description" ]; then
+        head_extra_og="$head_extra_og
+        <meta property=\"og:description\" content=\"$(escape_html_attr "$fm_description")\" />"
+    fi
+    og_url="${base_url%/}${current_url}"
+    head_extra_og="$head_extra_og
+        <meta property=\"og:url\" content=\"$(escape_html_attr "$og_url")\" />"
+
+    if [ -n "$head_extra" ]; then
+        head_extra="$head_extra
+        $head_extra_og"
+    else
+        head_extra="$head_extra_og"
+    fi
+
     ENABLE_HEADER_LINKS="$enable_header_links" CUSTOM_ADMONITIONS="$custom_admonitions" MARKDOWN_SITE_ROOT="$src" MARKDOWN_FALLBACK_FILE="$script_dir/styles/$style.css" sh "$script_dir/markdown.sh" "$content_file" | AWK_CURRENT_URL="$current_url" AWK_TITLE="$page_title" AWK_NAV="$nav" AWK_FOOTER="$footer" AWK_STYLE_PATH="${style_path}${asset_version}" AWK_HEADER_BRAND="$header_brand" AWK_HEAD_EXTRA="$head_extra" awk -f "$awk_dir/render_template.awk" "$local_template"
 }
 
@@ -736,6 +772,7 @@ needs_rebuild() {
     return 1
 }
 
+build_site() {
 echo "Building site from '$src' to '$out'..."
 
 eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while read -r dir; do
@@ -883,29 +920,94 @@ eval "find \"$src\" \( $IGNORE_ARGS \) -prune -o -type d -print" | sort | while
             fi
         done
         
-        if [ "$has_custom_index" = "true" ]; then
-            awk '
-                /^[[:space:]]*\{\{LIST\}\}[[:space:]]*$/ {
-                    while((getline line < "'"$temp_list"'") > 0) print line
-                    close("'"$temp_list"'")
-                    next
-                }
-                { print }
-            ' "$dir/index.md" > "$temp_index"
-        else
-            cat "$temp_list" >> "$temp_index"
-        fi
-
         is_home="false"; [ "$dir" = "$src" ] && is_home="true"
         target_url="/$rel_dir/index.html"
         [ "$rel_dir" = "." ] && target_url="/index.html"
 
-        do_rebuild="false"
-        needs_rebuild "$dir" "$out_dir/index.html" && do_rebuild="true"
-        [ "$has_custom_index" = "true" ] && needs_rebuild "$dir/index.md" "$out_dir/index.html" && do_rebuild="true"
+        num_items=$(wc -l < "$temp_list")
+        if [ "$is_posts_dir" = "true" ] && [ -n "$posts_per_page" ] && [ "$posts_per_page" -gt 0 ] && [ "$num_items" -gt "$posts_per_page" ]; then
+            num_pages=$(( (num_items + posts_per_page - 1) / posts_per_page ))
+            for p in $(seq 1 $num_pages); do
+                chunk_list="$KEWT_TMPDIR/chunk.md"
+                start_line=$(( (p - 1) * posts_per_page + 1 ))
+                tail -n +$start_line "$temp_list" | head -n "$posts_per_page" > "$chunk_list"
 
-        if [ "$do_rebuild" = "true" ]; then
-            render_markdown "$temp_index" "$is_home" "$target_url" > "$out_dir/index.html"
+                base_url_dir="$(dirname "$target_url")"
+                [ "$base_url_dir" = "/" ] && base_url_dir=""
+
+                nav_html="<div class=\"pagination\">"
+                if [ "$p" -gt 1 ]; then
+                    if [ "$p" -eq 2 ]; then
+                        nav_html="$nav_html <a href=\"$base_url_dir/index.html\" class=\"prev-page\">&laquo; Prev</a> "
+                    else
+                        nav_html="$nav_html <a href=\"$base_url_dir/page/$((p-1))/index.html\" class=\"prev-page\">&laquo; Prev</a> "
+                    fi
+                fi
+                nav_html="$nav_html <span class=\"page-number\">Page $p of $num_pages</span> "
+                if [ "$p" -lt "$num_pages" ]; then
+                    nav_html="$nav_html <a href=\"$base_url_dir/page/$((p+1))/index.html\" class=\"next-page\">Next &raquo;</a> "
+                fi
+                nav_html="$nav_html</div>"
+
+                echo "" >> "$chunk_list"
+                echo "$nav_html" >> "$chunk_list"
+
+                temp_index_p="$KEWT_TMPDIR/index_p$p.md"
+                if [ "$has_custom_index" = "false" ]; then
+                    display_dir="${rel_dir#.}"
+                    [ -z "$display_dir" ] && display_dir="/"
+                    echo "# Index of $display_dir" > "$temp_index_p"
+                    echo "" >> "$temp_index_p"
+                else
+                    : > "$temp_index_p"
+                fi
+
+                if [ "$has_custom_index" = "true" ]; then
+                    awk '
+                        /^[[:space:]]*\{\{LIST\}\}[[:space:]]*$/ {
+                            while((getline line < "'"$chunk_list"'") > 0) print line
+                            close("'"$chunk_list"'")
+                            next
+                        }
+                        { print }
+                    ' "$dir/index.md" >> "$temp_index_p"
+                else
+                    cat "$chunk_list" >> "$temp_index_p"
+                fi
+
+                if [ "$p" -eq 1 ]; then
+                    out_file="$out_dir/index.html"
+                    target_url_p="$target_url"
+                else
+                    out_file="$out_dir/page/$p/index.html"
+                    target_url_p="$base_url_dir/page/$p/index.html"
+                    mkdir -p "$(dirname "$out_file")"
+                fi
+
+                render_markdown "$temp_index_p" "$is_home" "$target_url_p" > "$out_file"
+                rm -f "$temp_index_p" "$chunk_list"
+            done
+        else
+            if [ "$has_custom_index" = "true" ]; then
+                awk '
+                    /^[[:space:]]*\{\{LIST\}\}[[:space:]]*$/ {
+                        while((getline line < "'"$temp_list"'") > 0) print line
+                        close("'"$temp_list"'")
+                        next
+                    }
+                    { print }
+                ' "$dir/index.md" > "$temp_index"
+            else
+                cat "$temp_list" >> "$temp_index"
+            fi
+
+            do_rebuild="false"
+            needs_rebuild "$dir" "$out_dir/index.html" && do_rebuild="true"
+            [ "$has_custom_index" = "true" ] && needs_rebuild "$dir/index.md" "$out_dir/index.html" && do_rebuild="true"
+
+            if [ "$do_rebuild" = "true" ]; then
+                render_markdown "$temp_index" "$is_home" "$target_url" > "$out_dir/index.html"
+            fi
         fi
         rm -f "$temp_index" "$temp_list"
     fi
@@ -1053,18 +1155,22 @@ if [ "$generate_feed" = "true" ] && [ -n "$base_url" ]; then
         rel_path="${rel_path#/}"
         post_url="$base_url_feed/${rel_path%.md}.html"
 
-        pub_year=$(echo "$post_date" | cut -d- -f1)
-        pub_month=$(echo "$post_date" | cut -d- -f2)
-        pub_day=$(echo "$post_date" | cut -d- -f3)
-        # zero-padded
-        pub_day=$(printf '%02d' "${pub_day#0}")
-        case "$pub_month" in
-            01) pub_mon="Jan" ;; 02) pub_mon="Feb" ;; 03) pub_mon="Mar" ;;
-            04) pub_mon="Apr" ;; 05) pub_mon="May" ;; 06) pub_mon="Jun" ;;
-            07) pub_mon="Jul" ;; 08) pub_mon="Aug" ;; 09) pub_mon="Sep" ;;
-            10) pub_mon="Oct" ;; 11) pub_mon="Nov" ;; 12) pub_mon="Dec" ;;
-        esac
-        pub_date="${pub_day} ${pub_mon} ${pub_year} ${post_time}:00 +0000"
+        if date -u -d "$post_date $post_time" '+%a, %d %b %Y %H:%M:%S +0000' >/dev/null 2>&1; then
+            pub_date=$(date -u -d "$post_date $post_time" '+%a, %d %b %Y %H:%M:%S +0000')
+        else
+            pub_year=$(echo "$post_date" | cut -d- -f1)
+            pub_month=$(echo "$post_date" | cut -d- -f2)
+            pub_day=$(echo "$post_date" | cut -d- -f3)
+            # zero-padded
+            pub_day=$(printf '%02d' "${pub_day#0}")
+            case "$pub_month" in
+                01) pub_mon="Jan" ;; 02) pub_mon="Feb" ;; 03) pub_mon="Mar" ;;
+                04) pub_mon="Apr" ;; 05) pub_mon="May" ;; 06) pub_mon="Jun" ;;
+                07) pub_mon="Jul" ;; 08) pub_mon="Aug" ;; 09) pub_mon="Sep" ;;
+                10) pub_mon="Oct" ;; 11) pub_mon="Nov" ;; 12) pub_mon="Dec" ;;
+            esac
+            pub_date="Mon, ${pub_day} ${pub_mon} ${pub_year} ${post_time}:00 +0000"
+        fi
 
         {
             printf '    <item>\n'
@@ -1081,3 +1187,46 @@ if [ "$generate_feed" = "true" ] && [ -n "$base_url" ]; then
 fi
 
 echo "Build complete."
+}
+
+build_site
+
+if [ "$serve_mode" = "true" ]; then
+    port="${serve_port:-8000}"
+    if command -v python3 >/dev/null 2>&1; then
+        python3 -m http.server "$port" -d "$out" >/dev/null 2>&1 &
+        server_pid=$!
+        echo "Serving '$out' on http://localhost:$port (python3)"
+    elif command -v busybox >/dev/null 2>&1; then
+        busybox httpd -f -p "$port" -h "$out" >/dev/null 2>&1 &
+        server_pid=$!
+        echo "Serving '$out' on http://localhost:$port (busybox)"
+    else
+        die "Neither python3 nor busybox httpd is available to serve."
+    fi
+
+    trap 'kill $server_pid 2>/dev/null; rm -rf "$KEWT_TMPDIR"' EXIT
+    trap 'kill $server_pid 2>/dev/null; exit 0' HUP INT TERM
+fi
+
+if [ "$watch_mode" = "true" ]; then
+    echo "Watching for changes in '$src'..."
+    touch "$KEWT_TMPDIR/watch_mark"
+    while true; do
+        sleep 1
+        changed="$(find "$src" -type f -newer "$KEWT_TMPDIR/watch_mark" 2>/dev/null | head -n 1)"
+        [ -z "$changed" ] && [ -f "site.conf" ] && [ "site.conf" -nt "$KEWT_TMPDIR/watch_mark" ] && changed="site.conf"
+        [ -z "$changed" ] && [ -f "$src/site.conf" ] && [ "$src/site.conf" -nt "$KEWT_TMPDIR/watch_mark" ] && changed="$src/site.conf"
+        [ -z "$changed" ] && [ -f "$template" ] && [ "$template" -nt "$KEWT_TMPDIR/watch_mark" ] && changed="$template"
+        [ -z "$changed" ] && [ -d "$script_dir/styles" ] && changed="$(find "$script_dir/styles" -type f -newer "$KEWT_TMPDIR/watch_mark" 2>/dev/null | head -n 1)"
+        
+        if [ -n "$changed" ]; then
+            echo ""
+            echo "Change detected, rebuilding..."
+            build_site
+            touch "$KEWT_TMPDIR/watch_mark"
+        fi
+    done
+elif [ "$serve_mode" = "true" ]; then
+    wait "$server_pid"
+fi
diff --git a/markdown.sh b/markdown.sh
index 9dac41e..9848105 100755
--- a/markdown.sh
+++ b/markdown.sh
@@ -62,13 +62,20 @@ awk -f "$awk_dir/fenced_code.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_f
 awk -f "$awk_dir/indented_code.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 awk -f "$awk_dir/pipe_tables.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 awk -v enable_header_links="$ENABLE_HEADER_LINKS" -f "$awk_dir/headers.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
+awk -f "$awk_dir/definition_lists.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 awk -f "$awk_dir/lists.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 
+# TOC
+awk -f "$awk_dir/toc.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
+# Footnotes
+awk -f "$awk_dir/footnotes.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
+
 # Spacing
 awk -f "$awk_dir/breaks.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 awk -f "$awk_dir/paragraphs.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 
 # Inline styles
+awk -f "$awk_dir/emoji.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 awk -f "$awk_dir/markdown_inline.awk" "$temp_file" > "$temp_file.tmp" && mv "$temp_file.tmp" "$temp_file"
 awk -v input_file="$1" -v site_root="$MARKDOWN_SITE_ROOT" -v fallback_file="$MARKDOWN_FALLBACK_FILE" -f "$awk_dir/markdown_embed.awk" "$temp_file"
 rm "$temp_file"
diff --git a/site/Docs/configuration.md b/site/Docs/configuration.md
index d437ac3..ed96703 100644
--- a/site/Docs/configuration.md
+++ b/site/Docs/configuration.md
@@ -15,11 +15,13 @@ You can set metadata for a page using a `site.conf`-style frontmatter block at t
 title = "Custom Page Title"
 date = "2026-03-23 11:32"
 draft = false
+description = "A short page summary"
 ---
 ```
 - `title` - overrides the page title, post name in index links, and RSS `<title>`.
 - `date` - overrides the post date and time. Supports `YYYY-MM-DD` and `YYYY-MM-DD HH:MM` (or `HH-MM`).
 - `draft` - if `true`, the file is excluded from HTML generation.
+- `description` - page description, used for Open Graph `og:description` meta tag.
 
 ## Directory Index Customisation
 
@@ -34,4 +36,26 @@ This is my blog. The posts are below. The top-most one is the most recent.
 
 {{LIST}}
 ```
-The `{{LIST}}` tag will be replaced with the generated list of links to child pages and files, exactly as in case the custom index didn't exist.
\ No newline at end of file
+The `{{LIST}}` tag will be replaced with the generated list of links to child pages and files, exactly as in case the custom index didn't exist.
+
+## Table of Contents
+
+You can auto-generate a Table of Contents by placing `{{TOC}}` anywhere in your markdown file. It collects all `h2` and `h3` headings and generates an ordered list with anchor links.
+
+## Footnotes
+
+Footnotes use the `[^id]` syntax inline and `[^id]: text` for definitions at the bottom of the file. They are rendered as a numbered `<section>` at the end of the page.
+
+## Definition Lists
+
+Definition lists use the standard syntax:
+
+```md
+Term
+: Definition
+```
+This renders as `<dl><dt>Term</dt><dd>Definition</dd></dl>`. Multiple definitions per term are supported.
+
+## Emoji Shortcodes
+
+Standard GitHub/MkDocs emoji shortcodes like `:smile:`, `:fire:`, `:rocket:` are automatically replaced with their Unicode emoji equivalents. Shortcodes inside code blocks are left as-is.
\ No newline at end of file
diff --git a/site/Docs/usage.md b/site/Docs/usage.md
index 55dc5b6..5424bb3 100644
--- a/site/Docs/usage.md
+++ b/site/Docs/usage.md
@@ -9,11 +9,15 @@ kewt --generate-template [path]
 kewt --update [dir]
 kewt --from <src> --to <out>
 kewt [src] [out]
+kewt --watch
+kewt --serve [port]
 ```
 - `--new [title]` creates a new site directory with a default `site.conf`, `template.html`, and `index.md`.
 - `--post [title]` creates a new markdown file in the configured `posts_dir` with the current date/time as the filename and default frontmatter.
 - `--generate-template [path]` writes the default `template.html` to the given path (defaults to `template.html` in the current directory).
 - `--update [dir]` adds any missing keys to `site.conf` and checks `template.html` against the latest default.
+- `--watch` (`-w`) watches for file changes in the source directory and rebuilds automatically.
+- `--serve` (`-s`) starts a local HTTP server (python3 or busybox) in the output directory after building. Use with the port number to specify the port. Composable with `--watch`.
 
 ## site.conf
 
@@ -42,6 +46,7 @@ base_url = ""
 generate_feed = false
 feed_file = "rss.xml"
 posts_dir = ""
+posts_per_page = 12
 custom_admonitions = ""
 ```
 - `title` - site title
@@ -67,5 +72,6 @@ custom_admonitions = ""
 - `generate_feed` - enable RSS feed generation (requires `base_url`)
 - `feed_file` - filename for the generated RSS feed (default: "rss.xml")
 - `posts_dir` - directory name containing posts (e.g., "posts"). Enables reverse-chronological sorting, title headings in indexes, and automatic backlinks.
+- `posts_per_page` - number of posts per page in paginated post indexes (default: 12). Set to 0 to disable pagination.
 - `enable_header_links` - turns markdown section headings into clickable anchor links (default: true)
 - `custom_admonitions` - comma separated list of custom admonitions
diff --git a/site/index.md b/site/index.md
index 6700ac3..c0bab4b 100644
--- a/site/index.md
+++ b/site/index.md
@@ -14,7 +14,7 @@ It's meant to be a static site generator, like _[kew](https://github.com/uint23/
 ## Features
 
 - No dependencies
-- Frontmatter support (title, date, draft)
+- Frontmatter support (title, date, draft, description)
 - Supports many embed types
 - Automatic css variable replacement for older browsers
 - Automatic inlining and embedding of many filetypes with `\![link]` or `\![alt](link)`
@@ -31,6 +31,13 @@ It's meant to be a static site generator, like _[kew](https://github.com/uint23/
 - Clickable markdown header anchors
 - Mobile responsive layout
 - Customisable directory index pages with `{{LIST}}`
+- Open Graph meta tags from frontmatter
+- Auto-generated Table of Contents via `{{TOC}}`
+- Footnotes (`[^id]`)
+- Definition lists
+- Emoji shortcodes (`:smile:`, `:fire:`, etc.)
+- Post pagination
+- `--watch` and `--serve` modes for development
 
 ***
 
diff --git a/styles/kewt.css b/styles/kewt.css
index fadedad..2f0aaad 100644
--- a/styles/kewt.css
+++ b/styles/kewt.css
@@ -252,8 +252,27 @@ hr {
     border-top: 1px solid var(--code-border);
 }
 
+.nav-toggle, .nav-toggle-label {
+    display: none;
+}
+
 @media screen and (max-width: 600px) {
+    header {
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+    }
+
+    .nav-toggle-label {
+        display: block;
+        font-size: 30px;
+        cursor: pointer;
+        color: var(--fg-heading);
+        user-select: none;
+    }
+
     #side-bar {
+        display: none;
         position: relative;
         top: auto;
         left: auto;
@@ -264,6 +283,10 @@ hr {
         margin: 0 20px 20px 20px;
     }
 
+    .nav-toggle:checked ~ #side-bar {
+        display: block;
+    }
+
     article {
         margin: 0 20px 0 20px;
     }