"Markdown"
- Blog 文章模板設計：作者品質閘門與正文分工
文章模板的定位與 SSoT 歸屬：模板是作者品質閘門、正文仍走技術推導、backend 正文不暴露填表結構。
- Blog Markdown 寫作規範與 mdtools 檢查
本 blog 的 Markdown 排版規範權威契約。涵蓋 H1 禁用、MD024 siblings_only、反釣魚 TLD 校驗、卡片雙向完整性、front matter schema；改規則時要與 scripts/mdtools 實作同步。
- mdtools：Go + goldmark 的 markdown 工具鏈設計
mdtools 的架構決策：選 Go + goldmark 的理由（與 Hugo 同源保證 lint↔render 等價）、單 binary 多子命令設計、pre-commit 整合、規則開啟紀律。
- 什麼是 AST — 從字串到語法樹的視角轉換
AST 與 regex 的差異判準：規則需要知道文字處在什麼結構中時 regex 就不夠。附 regex 誤判的具體 case。
- Hugo Shortcode 實現可折疊區塊
Hugo details shortcode 實作可折疊區塊，取代被 MD033 擋的 raw <details> 標籤。含模板、樣式與遷移腳本。
- Hugo 部落格支援 Mermaid 流程圖完整實現指南
Hugo 啟用 Mermaid 流程圖的整合方式，含 code block 渲染不出圖（被包進 pre>code）的處理、語法轉換、自訂樣式與響應式適配。
- 在部落格中設置文章資訊與tag
Hugo front matter 欄位（title / date / draft / tags）範例與 title 取代 H1 的提醒。