Markdown 檢視器

你原本看到的，與你現在看到的

用記事本或 TextEdit 打開 Markdown 檔，看到的是原始碼。以下是一段真實檔案的內容，跟它存在硬碟上的樣子一模一樣：

# Onboarding checklist

## Before day one
- [x] Laptop ordered
- [ ] Accounts created
- [ ] Desk assigned

Ask **Dana** in ops if anything is missing, and read the
[handbook](docs/handbook.md) first.

| Item      | Owner | Due    |
| :-------- | :---- | -----: |
| Badge     | Ops   | Day 1  |
| VPN token | IT    | Day 2  |

> Anything marked optional can wait until week two.

每個符號變成了什麼

這樣其實已經讀得懂，這正是這個格式的設計目標，只是還沒完成。在上方的檢視器裡，每個符號都變成了排版：

• 單一個 # 變成文件標題，## 變成下一層的次標題。
• 三行 - [ ] 變成有真正打勾方塊的待辦清單。
• **Dana** 變成粗體。
• 中括號加小括號變成標示為 handbook 的可點連結。
• 那塊管線符號變成有框線、Due 欄靠右對齊的表格。
• 最後一行變成內縮的引用。

符號是指令，不是雜訊

這就是「讀 Markdown 檔」和「檢視 Markdown 檔」的差別。那些標點不是勉強容忍的雜訊，而是一組指令，檢視器不過就是負責照著做的東西。

想靠肉眼看懂一份檔案？語法速查表把所有指令列在同一頁上。

各平台拿 .md 檔怎麼辦

.md 檔之所以讓人覺得麻煩，是因為沒有任何作業系統把它認養下來。每個平台都能讓你看到文字，但幾乎沒有一個能讓你看到排版。

你應該住在哪一列

規律很明顯：想看到文字，到處都很容易；想看到排版，就得靠程式編輯器或瀏覽器。

如果 Markdown 對你來說是一個月碰一次的東西，開一個瀏覽器分頁顯然比較輕鬆。如果一週要處理好幾次，安裝 VS Code 或專門的編輯器就開始划算了。

小提醒：與其到處找 App，不如把這一頁加進書籤。一個分頁就能打開的檢視器，勝過一個還要跟資訊部門解釋的安裝需求。

常見問題與修法

在這裡看起來壞掉的檔案，多半其實沒事。原因幾乎只有兩種：檔案存錯了，或裡面的 Markdown 有個小失誤。

檔案本身的問題

• 中文或重音字變成亂碼。出現 中文 這類症狀，代表檔案被存成 Big5 或 Windows-1252 之類的舊編碼。Markdown 檔慣例上是 UTF-8：用程式編輯器把原始檔重新存成 UTF-8，再拿回這裡開啟即可。千萬不要用手把亂碼重打過去，因為底層的位元組其實是對的。
• 檔名變成 notes.md.txt。Windows 會隱藏已知的副檔名，所以一個好意的「另存新檔」就多加了一層。內容完全沒被動過。在檔案總管的「檢視」分頁打開副檔名顯示再改回來，或乾脆直接拿來這裡開，因為 .txt 載入結果一模一樣。
• 文件裡的圖片沒有出現。Markdown 是用相對路徑引用圖片的，例如 ![chart](img/chart.png)。檔案單獨用電子郵件寄出時，旁邊那個資料夾並沒有跟著走。文字仍然正常渲染。

Markdown 內容的問題

• 文件少了一半。檢查是不是有未關閉的程式碼圍籬。多出來的三個反引號之後的每一行都會被當成程式碼，正確的檢視器會忠實呈現這個結果。把結尾的圍籬補上，內容就全部回來了。
• 換行好像都被吃掉了。這不是錯誤。Markdown 會把連續的行合併成同一段，只有空白行才會開新的一段。原始檔看起來很密，渲染後仍是整齊的段落。
• 表格變成一排管線符號。它的分隔列不見了、寫錯了，或表格上方少了空白行。
• 有些語法有效、有些無效。待辦清單、表格、刪除線與自動連結屬於 GitHub 風格 Markdown，本檢視器支援。另外還多支援三項：標了語言代碼的程式碼圍欄會上色、$數學式$ 由 KaTeX 排版、標成 mermaid 的圍欄會畫成圖表。註腳與定義清單則是各自獨立的擴充，本檢視器沒有實作。

其中表格壞掉的回報遠遠多於其他項目。用表格產生器重建再貼回去，或先讀表格指南裡的精確規則。

注意：如果那些圖片才是文件的重點，不要請對方把圖貼進文字裡。跟寄件者要整個資料夾，或直接要一份匯出的 PDF，圖片就包在檔案裡了。

從檢視到編輯，再送出去

檢視通常只是第一步。看得懂之後，你多半還想改點東西、把它轉寄出去，或轉成收件人不會有疑問的格式。

想修改內容

打開首頁的 MD Editor，把內容貼進去。左邊是原始碼、右邊是即時預覽，還有附鍵盤快速鍵的排版工具列，以及存在你自己瀏覽器裡的自動草稿。

改完後，從工具列下載一份新的 .md 檔，照原路寄回去就好。

想交給不碰 Markdown 的人

• 要寄一份文件？Markdown 轉 PDF 會產生分好頁的檔案，在任何裝置上打開都不需要解釋。
• 要發佈到網路上？Markdown 轉 HTML 給你可以貼進 CMS、郵件範本或網頁的原始碼。
• 還在猶豫？Markdown 與 HTML 的比較清楚列出兩者各自的勝場。

想從此不再只是收件人

如果 .md 檔一直寄到你的信箱，花十分鐘學會自己寫其實很划算。語法真的很少，完整指南照順序全部講完。

學到的東西可以原封不動用在 GitHub、Notion、Obsidian、Discord，以及每一次跟 AI 助理的對話裡。剩下的問題，常見問題都有解答。