═══ 為什麼要用 Markdown ═══ 2025 年 2 月 24 日 · 閱讀時間約 7 分鐘 ┊ 純文字版 [1] 我有一位朋友，是個很一般的 macOS [2] 使用者（但並非電腦白痴），她最近想要架設自 己的網站 [3]，所以來問我怎麼做。 我當然可以選擇推薦她像是 Wix.com、SquareSpace.com、WordPress.com 這種服務，或是 自己安裝 WordPress；但身為一個極簡主義者宅男 [4]（至少在軟體使用上），我當然還 是建議她自己花一點時間學基本的終端機和 Markdown 語法，這樣就可以使用 Hugo [5] 或 Docusaurus [6]，把網站架在自己的 Linux 虛擬主機上面。 但在我教她怎麼做的期間，她產生了許多疑問： • 「為什麼會有人想要用 Markdown？Markdown 裡面有一堆符號咒語，很醜耶！」（朋 友平常都用 Pages 作筆記） • 「為什麼會有人想要用終端機？誰知道要在裡面打什麼？而且很醜耶！按滑鼠 [7]不 是比較方便？」 • 「為什麼不用 Wix、WordPress 之類的服務，而是要用 Hugo 或 Docusaurus？」 我相信應該滿多人會有這些問題，所以我想來寫一些文章來說明使用這些工具的理由；這 樣當你以後想要推坑別人這些東西時，就可以直接請對方看這些文章了。 今天在這篇文章，就讓我們先來推坑朋友用 Markdown！ ◆ Markdown 是什麼？​ Markdown 是一種用簡單符號來標記文字格式的方法。例如你想要標題，就在前面加個 #； 想要粗體，就用兩個星號 ** 包起來；想要列表，就在前面加個減號 -；想要連結，就用 [文字](網址) 的格式。大概長得像這樣： # 大家好 哈囉！我是**Wiwi 官大為**，我有三個東西： - 煎餅 - 蛋餅 - 可麗餅 有空可以去[我的網站](https://nicechord.com)逛逛喔！ 雖然寫的時候是看起來有一些怪怪符號的純文字（我覺得其實還好吧），但是最終顯示的 時候就會自動變成漂亮的格式。它就像是用很簡單的「暗號」來告訴電腦「這些字要粗一 點」、「那些字要變成連結」；這樣我們就能專注在寫作上，不用一直去用滑鼠點格式工 具列。 ◆ 傳統文書處理軟體的優點​ 當然，像是 Pages 這樣子的傳統文書處理軟體，還是有它的優點。例如說，Pages 很適合 ： • 做精美的文件，尤其是要印出來的文件 • 做需要複雜表格或圖表的文件 • 做一次性使用、後續不需要維護或轉換格式的文件 • 團隊中全部人都是用 Mac 的情況 但在非常多情況，例如作筆記、寫說明文件或網站內容時，用 Markdown 會是更好的選擇 。讓我跟你說為什麼。 ◆ 用 Markdown 的理由​ ・理由 1：「內容」跟「樣式」分離​ 想像你在寫食譜，你把每個食譜都存成一個 Pages 檔案。在 Pages 中，每個檔案的標題 你都要手動設定「字體大小 20、粗體、藍色」；如果後來想把所有標題改成「字體大小 22、紅色」，你要得一個一個檔案點開來改。 但在 Markdown 中，你只需要寫： # 麻婆豆腐 把豆腐切碎，加辣豆瓣醬，攪一攪，加熱，完成！ # 蔥油餅 去超市買已經做好的，放到烤箱，完成！ 這些 # 符號只代表「這是標題」。至於標題要長什麼樣子、字體多大、什麼顏色等等，則 是在另一個檔案統一設定。想改變所有標題的樣式？只要修改一個地方就完成了。 ・理由 2：長期維護性​ 假設你用 Pages 寫了 100 個食譜，存成 100 個檔案。現在你想要： • 找出所有的「塩」字，替換成「鹽」 • 把所有的「烹飪時間」改成粗體，並且前面加一個時鐘的符號 • 把所有食譜變成一個網站 用 Pages 的話，你需要一個檔案一個檔案開啟、搜尋、修改。但如果是 Markdown： • 用一行終端機指令就能取代所有檔案中的「塩」字 • 用一行指令就能把所有檔案的「烹飪時間」改成「⏰ 烹飪時間」 • 使用像是 Hugo 或 Docusaurus 這樣的工具，就可以瞬間讓 Markdown 檔案變成網站 ・理由 3：可移植性​ Pages 檔案是封閉格式，只能在有安裝 Pages 的 Mac 上面正常開啟。如果你要跟用 Windows [8] 或 Linux 電腦 [9]的朋友協作文件，或者想用 AI [10] 分析你的文件內容 ，都會相當不方便。 Markdown 的話，因為它只是純文字檔案，所以在任何電腦 [11]、任何作業系統、用任何 文字編輯器都能打開，不會被綁在特定軟體上 [12]，被單一公司控制。它也可以輕鬆地被 轉換成網頁、PDF、電子書等各種格式，以及被程式讀取和分析。 ・理由 4：寫作思考流暢度​ 用傳統文書軟體時，你常常會被格式的問題打斷思考：「這裡要用什麼字型？要多大？可 惡，調了字體之後這一行就被擠到下一頁了！」 但用 Markdown 寫作時，因為只需要專注在內容結構上：「這是標題、這是列表、這是引 言」；格式的問題 [13]可以之後再一併處理，這樣可以讓我們更專注在寫作本身。 ・理由 5：檔案超小、速度快​ Markdown 檔案因為是純文字，檔案會超級小，一篇數千字的文章通常只有幾 KB。這不只 讓它讀取超快、節省儲存空間，要備份或同步也都很快速。 同樣的內容如果用 Pages 或是 Microsoft Word 儲存，檔案大小可能會是 Markdown 的數 十倍到數百倍大。 （用 Pages 打一個「Hello.」存檔，檔案大小就要 95 KB！Markdown 的話只要 0.007 KB 。） 圖片 [14] ・理由 6：經得起時間考驗​ 因為 Markdown 只是基礎的純文字檔案，這樣的簡單性就是對未來的最好保證。因為它太 基礎了，不只永遠不會過時，甚至可以回到過去：今天的 Markdown 檔案，放到三十年前 的 DOS/Windows 3.1 電腦上也能正常開啟；而未來不論出現什麼新的作業系統、軟體、AI 工具，它們都一定也會支援 Markdown 檔案。 想像當你 80 歲時，某天興起想要重溫年輕時用 Pages 寫的文章，卻發現 Apple 這家公 司早已不存在，沒有任何軟體能打開檔案 [15]；就好像你手上有一堆寶箱，但鑰匙卻全搞 丟了一樣。這種情況是完全可以避免的。 我們幾乎可以肯定地說，只要人類 [16]文明還存在，今天的 Markdown 檔案，在 500 年 後依然可以被開啟，就像古時候流傳下來的紙本文件一樣。至於今天的 Pages 檔案⋯⋯20 年後能不能打開，恐怕都還是個問號。 ◆ 加入 Markdown 教派吧！​ 歡迎加入這個用奇怪符號寫作的教派！ 一開始你可能會覺得 Markdown 很不直覺 [17]，但用筷子吃飯一開始也很不直覺啊！只要 一陣子之後，你就會發現原來寫作也可以這麼輕盈、樸素，卻又經得起時代考驗！ （當然，你現在看到的這個網頁，也是在終端機中用 Markdown 寫成的。） ── 連結與圖片 ── [1] https://wiwi.blog/blog/why-use-markdown.txt [2] https://wiwi.blog/blog/apple-obsolescence.txt [3] https://wiwi.blog/blog/internet-peasant.txt [4] https://wiwi.blog/blog/fake-vs-real-tech-nerd.txt [5] https://gohugo.io/ [6] https://docusaurus.io/ [7] https://wiwi.blog/blog/transferable-skills.txt#%E9%80%99%E8%A3%A1%E9%BB%9E%E9%BB%9E%E9%82%A3%E8%A3%A1%E6%BB%91%E6%BB%91%E7%9A%84%E6%8A%80%E8%83%BD [8] https://wiwi.blog/blog/windows-bloat.txt [9] https://wiwi.blog/blog/pianist-using-linux.txt [10] https://wiwi.blog/blog/offline-ai.txt [11] https://wiwi.blog/blog/use-a-computer-already.txt [12] https://wiwi.blog/blog/convivial-tools.txt [13] https://wiwi.blog/blog/freedom-to-format.txt [14] （圖片）https://wiwi.blog/assets/images/hello-d83d23377421f7d0e46b025c3e956777.jpg [15] https://wiwi.blog/blog/rescued-from-finale.txt [16] https://wiwi.blog/blog/five-ages-of-humanity.txt [17] https://wiwi.blog/blog/horse-to-motorcycle.txt