任何文字編輯器都打得開。Windows 的記事本、macOS 的 TextEdit、Linux 的 nano,甚至手機上的備忘錄都行。.md 檔本質上就是換了副檔名的純 UTF-8 文字檔。直接點兩下不一定有反應,因為有些系統沒有為 .md 註冊預設程式;但「以其他方式開啟」加上任一編輯器一定沒問題。

這樣看到的是原始碼。想看排版後的樣子而不是一堆符號,就打開首頁上免費的 MD Editor,把檔案內容貼進左邊窗格。右邊預覽會立刻渲染出成品,標題、清單、表格、連結通通到位。過程中不會上傳任何東西,轉換全在你的瀏覽器裡完成。

重點速覽

檔案類型純 UTF-8 文字,沒有二進位資料,也沒有內嵌字型
需要特殊軟體嗎不需要。記事本、TextEdit、nano 與所有程式編輯器都打得開
最佳免費檢視方式有即時預覽的瀏覽器編輯器,直接看到排版後的成品
排版會保留嗎會。看得見的符號本身就是排版,不可能遺失
檔案損毀風險幾乎為零,除非被重新存成非 UTF-8 的編碼

為什麼任何文字編輯器都能開

重點摘要
  • .md 就是純 UTF-8 文字,任何系統上的任何編輯器都打得開。
  • 把它改名成 .txt,裡面一個位元組都不會變,副檔名只是標籤。
  • 想零安裝看到排版成品,把內容貼進本站首頁的編輯器就好。
  • 最常見的兩個狀況:副檔名被藏了一個 .txt,以及編碼猜錯。

檔案裡面到底裝了什麼

Markdown 檔裡只有普通字元:文字、數字,加上 #* 這類承載排版指令的符號。沒有二進位資料,沒有內嵌字型,也沒有封閉的容器格式。更沒有哪個未來的軟體可以用「格式版本太舊」為由拒絕開啟。今天收到的 .md 檔,二十年後照樣打得開。

副檔名只是一個標籤

notes.md 改名成 notes.txt,每一個位元組都不會變,檔案照樣打得開,只是少了編輯器認出名稱後才啟用的語法上色與預覽。偶爾會遇到的其他寫法,像是 .markdown.mdown.mkd.mdx,也都是同樣的純文字換個名字,詳見Markdown 副檔名的說明

最糟的情況,也不過是看到符號

用記事本打開,你看到的是原始碼:## 標題 而不是放大的標題字,**粗體** 而不是真正的粗體。這樣其實還是很好讀,因為 Markdown 的設計初衷就是讓原始文字在紙上也讀得順。只是多數人還是想看渲染後的版本,這時有預覽的編輯器就派得上用場。想知道那些符號各代表什麼,Markdown 白話入門幾分鐘就講完了。

插圖:同一份純文字檔在筆電、桌機與手機上以完全相同的方式開啟,說明 .md 檔不需要任何特殊軟體

各作業系統的最佳開法

每個平台都已經內建了可以開 .md 檔的工具,也都有一個免費、下載就有的更好選擇。下表列出你現在手上就有的,以及只有在 Markdown 成為你每週例行工作時才值得安裝的。

系統已經內建更好的免費選擇升級後多了什麼
Windows記事本、WordPadVS Code、Notepad++語法上色,按 Ctrl+Shift+V 還有渲染預覽
macOSTextEdit,或按空白鍵的快速查看VS Code、BBEdit左右並排預覽,不會再跳出「轉為 RTF」的提示
Linuxgedit、Kate、nano、lessVS Code、Ghostwriter即時預覽,一鍵匯出 HTML 或 PDF
iOS 與 iPadOS檔案 App 預覽、貼進備忘錄Safari 加上本站編輯器真正的渲染預覽,完全不必安裝
Android任何文字檢視器、Google Drive 預覽Chrome 加上本站編輯器與桌機完全相同的預覽與匯出功能
任何系統網頁瀏覽器首頁上的編輯器貼上、閱讀、修改,再匯出成 .md、HTML 或 PDF

特別注意最後一列。如果你只是要看同事傳來的一份檔案,安裝一套軟體比開一個瀏覽器分頁還麻煩。等到你自己每週要寫好幾次 Markdown,再來安裝編輯器也不遲。

小提醒:在 macOS 上其實連開都不用開。在 Finder 裡點選檔案一下,再按空白鍵,快速查看就會直接把全文顯示出來。

你看到的原始碼,會變成什麼樣子

下面是一份典型 .md 檔的片段,這就是它在記事本或 TextEdit 裡沒有任何樣式時的原貌:

# 版本說明

## 2.1 版
- 修正**登入逾時**的問題
- 新增 `--verbose` 參數

詳細步驟請看[安裝指南](docs/setup.md)。

> 這個月要不要升級由你決定。

每個符號會變成什麼

光看原始碼其實已經足夠讓人採取行動。渲染之後,每個符號都會消失,變成排版本身:

  • 單一個 # 變成整頁主標題,兩個 ## 變成低一階的次標題。
  • 開頭是 - 的那兩行變成項目清單。
  • **登入逾時** 變成粗體。
  • --verbose 前後的反引號變成等寬程式碼樣式,那兩個連字號就不會被誤讀成內文。
  • 方括號接圓括號的組合變成可點擊的連結,文字是「安裝指南」,指向同一資料夾裡的另一個檔案。
  • > 開頭那行變成縮排的引用區塊。

親眼看著它轉換

把這段貼進有預覽的編輯器,你會看著它一行一行轉換完成。這是把符號和結果連起來最快的方法,大概只要一分鐘。剩下的符號,語法速查表用一頁就列完了。

打不乾淨的時候,通常是這幾種狀況

下面五種狀況幾乎涵蓋了所有麻煩。它們都不會弄壞檔案,而且每一個的解法都只要幾秒鐘。

檔案變成 notes.md.txt

Windows 預設隱藏已知的副檔名,於是一次好意的「另存新檔」就把 notes.md 變成了 notes.md.txt。內容完全沒事。到檔案總管的「檢視」分頁勾選副檔名,再把名字改回來即可。

中文或帶重音的字變成亂碼

看到 中文 這種症狀,代表編輯器猜錯了編碼,不是檔案壞了。Markdown 檔一律是 UTF-8,把檔案用指定編碼重新開啟即可,VS Code 選「Reopen with Encoding」再選 UTF-8。千萬不要用重打一遍的方式修亂碼,因為底層的原始位元組其實完全正確。

Word 或 Pages 打開後問你要不要轉換

文書處理軟體很樂意匯入 .md 檔,接著就想把它存回 .docx,過程中直引號被換成彎引號,語法符號被自動校正吃掉。

注意:真的非得在 Word 裡打開,就千萬不要覆蓋原檔。請用「另存新檔」換個名字,否則對方拿回去的檔案,語法已經被默默改壞了。

點兩下永遠開到錯的程式

那是因為你曾經設定過「一律用某程式開啟 .md」,而那個選擇並不理想。重設即可:Windows 按右鍵選「開啟檔案 > 選擇其他應用程式」;macOS 用「取得資訊」改「打開檔案的應用程式」,再按「全部更改」。

換行好像全部被合併了

這不是故障。Markdown 刻意把連續的行合併成同一個段落,要空一行才會開始新段落。原始檔看起來密密麻麻的一大塊,渲染出來還是整齊的分段,這個行為在完整指南的換行章節有完整說明。

看排版成品,也能改完傳回去

用瀏覽器讀,再直接匯出

零安裝就能看到排版成品的最快路徑是 MD Editor:把內容貼進左邊窗格,直接讀右邊的預覽。從這裡還能更進一步。點 .html 下載含樣式的獨立網頁,或用列印存成乾淨的 PDF,給完全不想碰 Markdown 的人看。

改完傳回去的完整流程

  1. 用任何文字編輯器打開 .md 檔,全選複製。
  2. 貼進編輯器左邊窗格,先看一眼右邊的預覽。
  3. 在左邊改內容,預覽會跟著你打字即時更新。
  4. 從工具列把成果下載成新的 .md 檔。
  5. 把檔案傳回去;對方偏好網頁或 PDF,就改匯出那兩種。

你打的字會即時自動存在自己的瀏覽器裡,不小心關掉分頁不等於檔案不見。而你貼進來的任何內容都不會上傳到任何地方,整個來回都在你的裝置上完成。

如果收到的檔案裡有表格、待辦清單或刪除線,那它用的是 GitHub Flavored 方言,我們的指南逐項說明了這些語法。下次如果你想直接給對方一個排好版的網頁,Markdown 與 HTML 的比較會告訴你什麼對象該收到什麼格式。

相關問題

立即使用編輯器

開啟編輯器