一頁看完常用語法,旁邊就能直接試打。看到排版正確了,再決定要不要變成一個可以傳給別人的連結。
貼上或直接輸入 Markdown,確認排版沒問題再決定要不要變成連結。
Markdown 的語法本身很短,真正花時間的是記不起來的那幾個——表格要幾條直線、程式碼區塊要幾個反引號、連結是中括號在前還是小括號在前。這一頁把常用的都列出來,旁邊就是輸入框,看到哪一條就直接在旁邊打打看。
另外一件值得先講清楚的事:Markdown 沒有唯一標準。GitHub、Notion、Obsidian 各自加了自己的東西,所以你在別的地方看到的寫法,換個工具不一定會動。這一頁走的是 GitHub 風格(GFM),也是目前最多工具支援的一套。
舉一個真的會卡住的例子:程式碼區塊裡面又出現三個反引號。
假設你要寫一篇教學,內容本身就在教別人怎麼寫 Markdown 的程式碼區塊。你用三個反引號把範例包起來,結果整段排版爆掉——因為裡面那三個反引號被當成結束符號,區塊提早關掉了。
解法是外層用更多:外面用四個反引號,裡面那三個就會被當成一般文字印出來。這條規則很少人講,但只要寫過一次技術文件就一定會遇到。
同樣的邏輯也適用在表格裡放直線:內容裡真的要出現 | 的時候,前面加一個反斜線寫成 \|,否則它會被當成欄位分隔。這兩個是最常讓人以為「Markdown 壞掉了」的情況,其實都只是跳脫字元的問題。
Free links last 7 days with a free account. On a paid plan every page you create stays online permanently.
See pricing