部落格。Markdown 的疑問,一次解答一個。
每篇短文只回答一個 Markdown 問題,附可複製的程式碼,並說明渲染後的樣子。
需要 macOS 14 或以上版本。閱讀免費;編輯與審閱為一次付費。
快速解答
DotMD 在這裡回答 Markdown 的各種小問題:如何做出表格、程式碼區塊或可摺疊區段,如何撰寫 PRD,如何審查 AI 寫的規格。每篇文章先給語法,再說明細節與常見錯誤。想了解應用程式本身,請看指南。
最新文章
由新到舊。
AI 規格審查檢查表
審查 AI 撰寫的規格或計畫的檢查表:範圍、邊界情況、資料、測試與回復。
PRD 範本
可直接複製的 Markdown PRD 範本,附有編號需求,AI 代理程式可據以開發。
CLAUDE.md 與 AGENTS.md 的差異
哪個代理程式讀 CLAUDE.md、哪個讀 AGENTS.md,以及如何只維護一份指示。
Mermaid 流程圖
Mermaid 流程圖語法:方向、節點形狀、連線、子圖,以及會讓圖表壞掉的錯誤。
圖片
圖片語法、相對路徑,以及如何設定大小、置中圖片或加上說明文字。
程式碼區塊
圍欄式程式碼區塊、語法醒目提示的語言標籤、巢狀反引號、行內程式碼與 diff。
可摺疊區段
用 details 與 summary 標籤做出下拉區段,以及其中的空行規則。
Markdown 換行
Markdown 為什麼會把你的幾行接在一起,以及三種換行方式:兩個空格、反斜線或 br 標籤。
Markdown 待辦清單
用 - [ ] 與 - [x] 寫核取方塊、做巢狀,並看看它在哪裡會被渲染。
Markdown 表格
表格語法、欄位對齊、儲存格內的直線或第二行,以及寬表格。
關於部落格的常見問題
DotMD 部落格有什麼內容?
關於 Markdown 語法的簡短教學文章:表格、待辦清單、換行等。每篇都有可複製的範例。
文章使用哪一種 Markdown 方言?
CommonMark 與 GitHub Flavored Markdown,也就是 GitHub 與多數 Markdown 應用程式遵循的方言。若某個應用程式有不同,文章會註明。
哪裡可以看到這些範例渲染後的樣子?
在 Markdown 閱讀器中開啟檔案。Mac 版 DotMD 會把表格、待辦清單與換行渲染出來,閱讀免費。請見閱讀 Markdown。