一頁看完常用語法,旁邊就能直接試打。看到排版正確了,再決定要不要變成一個可以傳給別人的連結。
貼上或直接輸入 Markdown,確認排版沒問題再決定要不要變成連結。
Markdown 的語法本身很短,真正花時間的是記不起來的那幾個——表格要幾條直線、程式碼區塊要幾個反引號、連結是中括號在前還是小括號在前。這一頁把常用的都列出來,旁邊就是輸入框,看到哪一條就直接在旁邊打打看。
另外一件值得先講清楚的事:Markdown 沒有唯一標準。GitHub、Notion、Obsidian 各自加了自己的東西,所以你在別的地方看到的寫法,換個工具不一定會動。這一頁走的是 GitHub 風格(GFM),也是目前最多工具支援的一套。
標題:行首放 #,幾個井字號就是第幾層。# 大標、## 中標、### 小標。井字號後面要空一格,這是最常見的漏打。
強調與清單:**粗體**、*斜體*、~~刪除線~~。清單用 - 開頭,有序清單用 1. ;縮排兩格就變成子項目。
連結與圖片:[文字](網址),中括號放看得到的字,小括號放網址。圖片就是前面多一個驚嘆號:。
程式碼:句子裡用一個反引號 `像這樣`;整段程式碼用三個反引號包起來,開頭那行可以加語言名稱來上色,例如 ```js。
表格:用直線分隔欄位,第二行用 --- 標出表頭。|:---| 靠左、|---:| 靠右、|:---:| 置中。直線不用對齊得漂漂亮亮,能跑就好。
舉一個真的會卡住的例子:程式碼區塊裡面又出現三個反引號。
假設你要寫一篇教學,內容本身就在教別人怎麼寫 Markdown 的程式碼區塊。你用三個反引號把範例包起來,結果整段排版爆掉——因為裡面那三個反引號被當成結束符號,區塊提早關掉了。
解法是外層用更多:外面用四個反引號,裡面那三個就會被當成一般文字印出來。這條規則很少人講,但只要寫過一次技術文件就一定會遇到。
同樣的邏輯也適用在表格裡放直線:內容裡真的要出現 | 的時候,前面加一個反斜線寫成 \|,否則它會被當成欄位分隔。這兩個是最常讓人以為「Markdown 壞掉了」的情況,其實都只是跳脫字元的問題。
因為 Markdown 預設會把單一換行當成同一段的延續。要真的換行有兩種寫法:行尾打兩個空白再換行,或是空一整行變成新的段落。空一行是比較保險的做法,因為行尾的空白在很多編輯器裡會被自動清掉,看不見也很難除錯。
不用。| 甲 | 乙 | 和 |甲|乙| 產生的結果完全一樣,對齊只是為了讓原始碼好讀。真正必要的只有第二行的 --- 分隔線——沒有它,那段就不會被當成表格,會原封不動印出一堆直線。
很可能是那個工具自己的擴充。像 Notion 的資料庫、Obsidian 的 [[雙向連結]]、GitHub 的核取方塊,都不是共通語法。這一頁走 GitHub 風格(GFM),涵蓋表格、刪除線和程式碼區塊;再往外的寫法就要看你用的工具支不支援。
多數算繪器允許在 Markdown 裡夾雜 HTML 標籤,需要 Markdown 做不到的排版時很好用。但每個平台准許的範圍不一樣,而且出於安全考量通常會過濾掉 <script>。如果整份文件本來就是 HTML,直接用 HTML 發布會比塞在 Markdown 裡穩定。
可以。上面的輸入框除了預覽,也能直接把這份 Markdown 變成一個網頁連結,對方用瀏覽器打開就看得到,不必安裝任何東西。免費連結會保留 7 天。
免費帳號的連結保留 7 天。升級付費方案後,你建立的每個頁面都會永久上線。
查看方案與價格