任何文字編輯器都打得開。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 檔的工具,也都有一個免費、下載就有的更好選擇。下表列出你現在手上就有的,以及只有在 Markdown 成為你每週例行工作時才值得安裝的。
| 系統 | 已經內建 | 更好的免費選擇 | 升級後多了什麼 |
|---|---|---|---|
| Windows | 記事本、WordPad | VS Code、Notepad++ | 語法上色,按 Ctrl+Shift+V 還有渲染預覽 |
| macOS | TextEdit,或按空白鍵的快速查看 | VS Code、BBEdit | 左右並排預覽,不會再跳出「轉為 RTF」的提示 |
| Linux | gedit、Kate、nano、less | VS 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 的人看。
改完傳回去的完整流程
- 用任何文字編輯器打開
.md檔,全選複製。 - 貼進編輯器左邊窗格,先看一眼右邊的預覽。
- 在左邊改內容,預覽會跟著你打字即時更新。
- 從工具列把成果下載成新的
.md檔。 - 把檔案傳回去;對方偏好網頁或 PDF,就改匯出那兩種。
你打的字會即時自動存在自己的瀏覽器裡,不小心關掉分頁不等於檔案不見。而你貼進來的任何內容都不會上傳到任何地方,整個來回都在你的裝置上完成。
如果收到的檔案裡有表格、待辦清單或刪除線,那它用的是 GitHub Flavored 方言,我們的指南逐項說明了這些語法。下次如果你想直接給對方一個排好版的網頁,Markdown 與 HTML 的比較會告訴你什麼對象該收到什麼格式。
相關問題
立即使用編輯器
開啟編輯器