這份常見問題怎麼分類
- 十五個問題，每一題都有自己的專屬頁面完整解答。
- 下面的分組依「你正在做什麼」排列，不是按筆畫或字母。
- 本頁不放答案內文，所以不會和你點進去的那一頁重複。
- 每一頁解答都有可直接複製的範例，以及最容易出錯的地方。
依照你想做的事分組
下面五組是按任務分類，不是按筆畫排序。你需要的答案，取決於你現在站在哪個位置。從沒打開過 .md 檔的人，和正在想辦法把管線符號塞進表格儲存格又不弄壞欄位的人，要的完全是兩回事。
每一頁解答包含什麼
十五頁的結構完全一致，所以你永遠知道該往哪裡看：
- 開頭兩句先給直接的答案，不繞背景；
- 一個速覽區塊，收好值得記住的細節；
- 一段可以直接貼進編輯器的實際範例；
- 平台行為不一致時，附上相容性對照表；
- 最後一節談常見錯誤，以及怎麼看出問題出在哪。
如果你比較想照順序讀完
零散查答案並不是唯一的入口。Markdown 完整指南從標題一路講到行內 HTML，把每個元素依序走過一遍；語法速查表則是日常最值得加進書籤的那一頁。
哪一種資源回答哪一種問題
四種型態的文件，各有各的任務
本站的 Markdown 文件分成四種型態。挑錯型態，正是很多人翻了參考資料反而更混亂、最後認定「Markdown 很難」的主因。它們不是同一份東西的不同版本：
| 你想要 | 就去 | 因為 |
|---|---|---|
| 立刻解決一個具體問題 | 下面的問題清單 | 每一頁只回答一個問題，附實際範例與會出錯的情境 |
| 忘記某個符號怎麼寫 | 語法速查表 | 兩張可掃視的表格涵蓋所有元素，不用讀長篇說明 |
| 照順序把語言學好學滿 | 語法指南 | 十三個章節從標題講到行內 HTML，每章都有細分小節 |
| 先搞懂 Markdown 到底是什麼 | 什麼是 Markdown？ | 談歷史、設計理念與使用場景，不需要背任何語法 |
| 單純想開始寫東西 | 編輯器 | 即時預覽會直接告訴你語法對不對，比讀文件快得多 |
多數困惑來自渲染器，不是語法
有個規律值得先知道：多數 Markdown 的麻煩其實跟語法無關，而是你寫給哪一個渲染器看。
表格、待辦清單、註腳都屬於擴充語法，不是原始 Markdown。所以在 GitHub 上完美呈現的片段，貼到別人的留言框可能就變成一堆管線符號。下面好幾題都會標出這種落差發生的確切位置，而 GitHub 風格 Markdown 指南則說明目前多數工具採用的這套方言。
如果清單裡沒有你的問題
問題沒被收錄，通常是因為它落在某個元素的長尾細節裡。這種時候，語法指南的分元素章節會比任何 FAQ 答案更深入。表格指南會獨立成頁也是同樣的道理：光是表格產生的問題，就比語言其餘部分加起來還多。
小提醒：讀解答時，順手在另一個分頁開著編輯器。把範例貼進去、再故意弄壞它，學會那條規則的速度會比把文章讀兩遍快得多。
Markdown 基礎
如果你對這個格式還很陌生，從這裡開始。這三題談 Markdown 到底是什麼、檔案存在硬碟上長什麼樣子，以及別人傳來的檔案要怎麼打開。
撰寫 Markdown
問題最多的三個語法：表格、圖片，以及非拉丁文字的輸入。每一個都藏著一條不踩到就不會知道的規則。
轉換與匯出
把 Markdown 變回可以發佈或寄出的東西。這兩題都會權衡「瀏覽器內完成」與「命令列工具」兩條路線。
使用本站編輯器
本站編輯器的實際運作方式：要不要錢、你的文字存在哪裡、渲染哪一種 Markdown 方言，以及網路斷線時會發生什麼事。
學習 Markdown
到底值不值得花時間學，以及從零到熟練最短的一條路。這兩題的答案都很直接，不打官腔。
延伸閱讀
立即使用編輯器
開啟編輯器