Markdown 寫作建議與工具

這學會了 Markdown 的語法只是開始，如何撰寫出一份既美觀又易於維護的文件，則需要遵循一些社群公認的最佳實務。本章將為你提供一些寫作建議，並推薦幾款優秀的 Markdown 編輯器。

撰寫 Markdown 的最佳實務

1. 在符號後方加上空格： 在標題的 #、清單的 - 以及引用的 > 後方，務必加上一個空格。這不但是規範，也能提高原始碼的可讀性。
2. 段落之間留空行： 即使有些編輯器支援不留空行直接換行，但為了跨平台的渲染穩定性，請務必在不同的段落或元素之間留一個完整的空行。
3. 保持一致性： 清單標記可以用 *, +, -。雖然都可以，但在一份文件中請固定使用同一種噴符，不要混用。
4. 圖片一定要寫替代文字： 這不僅是為了網站無障礙化，也是為了 SEO 優化，讓搜尋引擎知道你的圖片內容。
5. 避免在標題中使用連結： 這可能會導致某些自動產生的目錄 (TOC) 渲染出現問題。

推薦的 Markdown 編輯器

選擇一款好的編輯器能讓你的寫作事半功倍：

Visual Studio Code (VS Code)

• 優點：開發者首選。支援雙視窗即時預覽，且有海量的插件（如：Markdown All in One）。
• 場景：適合技術文件撰寫與程式開發併行。

Typora

• 優點：極致的「即時渲染」體驗（WYSIWYG）。你輸入完語法後它會立刻變成預覽效果，介面非常簡潔優雅。
• 場景：適合純文字創作者與撰寫精長篇文章。

Obsidian

• 優點：以「知識網」為核心。支援雙向連結，能將大量的 Markdown 檔案串聯成個人知識庫。
• 場景：適合學習筆記、撰寫書籍或研究工作。

Notion

• 優點：強大的協作功能。雖然它不完全是純 Markdown 編輯器，但支援絕大部分的 Markdown 快捷鍵輸入。

線上工具

如果你不想安裝軟體，可以使用以下線上預覽工具：

• StackEdit：功能強大的線上 Markdown 編輯器。
• Dillinger：簡潔的雲端編輯器，支援儲存到 Dropbox 或 Google Drive。

Markdown 的力量在於它的簡潔與通用。選擇一款你用得順手的工具，持之以恆地記錄與寫作，這才是最重要的！