← 返回部落格
技巧

提升 Markdown 寫作效率的 10 個實用技巧

從快捷鍵到結構化寫作，從程式碼區塊到流程圖——10 個讓 Markdown 寫作效率翻倍的實用技巧，適合部落客、開發者和技術寫作者。

1. 用標題層級驅動文章結構

好的 Markdown 文章從清晰的標題層級開始。## 作為一級章節，### 作為子章節，最多不超過四級。標題不僅影響閱讀體驗，也直接決定匯出 HTML 後的 TOC（目錄）品質和 SEO 權重。

# 文章標題（僅一個）
## 第一章
### 1.1 子節
### 1.2 子節
## 第二章

2. 程式碼區塊注明語言，語法高亮自動生效

在程式碼區塊的開頭三個反引號後緊接語言名稱，Shiki 會自動為超過 150 種語言提供精確語法高亮。常見的有 js、ts、python、bash、sql、yaml。

Python
def greet(name):
    return "Hello, " + name
Sql
SELECT id, title FROM posts WHERE published = true
Yaml
version: '3'
services:
  web:
    image: nginx

3. 用 Mermaid 畫流程圖，無需截圖

Mark.build 支援 Mermaid 圖表語法，渲染為內聯 SVG，匯出 HTML 後依然清晰無鋸齒。寫技術文件時比截圖方便十倍，內容也更容易維護。

Flowchart

4. KaTeX 渲染數學公式

研究報告或技術部落格中常需要公式。用 $...$ 寫行內公式，$$...$$ 寫區塊公式，KaTeX 會將它們渲染為向量圖形，匯出後不依賴任何外部 JS。

貝葉斯定理：P(A∣B)=P(B∣A)P(A)P(B)P(A|B) = \frac{P(B|A)P(A)}{P(B)}

5. 引用區塊突出重要內容

> 開頭的引用區塊非常適合標注警示、提示或名言。搭配主題的 blockquote 樣式，視覺效果遠比加粗文字更專業。

清晰的文件和清晰的程式碼一樣重要。好的寫作是一種工程實踐。

6. 表格快速整理對比資料

Markdown GFM 語法支援表格。三欄對比表是技術選型、功能比較類文章的利器。欄對齊用 :---（左）、:---:（中）、---:（右）。

Table
方案優點缺點
Markdown純文字，可版控樣式有限
Word富文字難以版控
Notion協作方便匯出受限

7. 圖片加 alt 文字提升 SEO

![描述文字](圖片路徑) 中的描述文字會成為 alt 屬性，搜尋引擎用它理解圖片內容。對於技術截圖，用簡短精確的中文描述，比空白或 “screenshot” 效果好得多。

8. 腳注處理參考資料

GFM 支援腳注語法，適合學術寫作或需要引用來源的文章。正文中用 [^1]，文末定義 [^1]: 參考文獻內容，Mark.build 會自動產生帶連結的腳注編號。

9. 專注寫作模式遮蔽干擾

Mark.build 編輯器右上角有「專注模式」按鈕，隱藏頂部導覽列，讓編輯器和預覽占滿整個螢幕。寫長文時開啟，避免視覺干擾。

10. 主題與匯出放在最後

寫作時選擇輕量的 Default 或 Minimal 主題，游標移動流暢、干擾最小。寫完再切換到目標主題（比如 Catppuccin 給開發部落格，FT Pink 給商業評論），一鍵匯出。調整主題不影響文章內容，改起來沒有心理負擔。

開始寫作： 開啟 Mark.build 編輯器 →