重點速覽
| 學會基礎要多久 | 大約三十分鐘,速查表與即時預覽並排著看 |
|---|---|
| 練到熟練要多久 | 大約三週,把一件固定的寫作任務改用它 |
| 最好的第一步 | 把速查表上的範例親手重打一遍,不要只用看的 |
| 練習方法 | 每天寫一份真實文件,每打完一行就看一次預覽 |
| 最難的元素 | 表格。其他語法都只有一兩個字元 |
為什麼用打的比用讀的快
- 把速查表的範例在即時預覽裡重打一遍,比用讀的快得多。
- 三十分鐘就能涵蓋日常寫作會用到的每一個符號。
- 七天計畫每天加一個元素,一次十到二十分鐘。
- 真正的熟練來自把一件每週固定的寫作任務永久改用 Markdown。
「想得起來」比「看得懂」重要
Markdown 與其說是知識,不如說是一種手感。日常會用到的符號總共就十幾個,難的從來不是看懂它們,而是在注意力放在內容上的同時,手指不假思索地把它們打出來。讀教學文章得到的是「看得懂」,也就是看到符號能認出它;親手打範例得到的是「想得起來」,而句子寫到一半、念頭才成形一半的時候,需要的正是後者。
即時預覽就是你的老師
即時預覽正是自學能這麼快的原因。每敲一個鍵,畫面不是立刻確認你打對了,就是立刻顯示哪裡出錯。# 後面漏了空格、** 忘了關、表格分隔列的直線數量不對,每個錯誤都變成一堂幾秒鐘就修完的微型課。對比學文書處理軟體,回饋要繞過選單和對話框,而且沒有任何東西告訴你為什麼會變成那樣。
這些符號本來就長這樣是有原因的
Markdown 的符號當初就是模仿大家在純文字電子郵件裡本來就會做的事:用星號包住要強調的字、用連字號列點、用縮排表示層次。親手打二十分鐘,這套邏輯就會浮出來。看見之後,語法就不再像是隨便規定的,而是理所當然的,這也是我們的 Markdown 白話入門開場的角度。
第一個三十分鐘,一步一步做
這一次練習的五個步驟
- 一個分頁開速查表,另一個分頁開編輯器。
- 把下面這份文件從頭打一遍,不要用貼的。
- 每打完一行就看一次預覽,沒出現就當場修掉。
- 全部刪掉,憑記憶再打一次。
- 用它寫一則真實的短筆記,例如今天的待辦清單。
要打的就是下面這份。它用上了日常寫作會需要的每一種元素,也沒有多餘的:
# 本週紀錄
## 已決定
- **週五**推出 Beta
- *定價頁*延到下個衝刺
## 待釐清
1. 誰負責資料轉移腳本?
2. API 需不需要 `--dry-run` 參數?
| 工作 | 負責人 | 期限 |
| --- | --- | --- |
| Beta 版本 | 安娜 | 週五 |
| 文件校閱 | 拉維 | 週一 |
- [x] 草擬更新日誌
- [ ] 與客服一起檢視
參見[上週紀錄](notes-2024-05.md)。
> 卡在等廠商回覆。
這二十行涵蓋了什麼
渲染之後,這會變成一個主標題、兩個次標題、一份內含粗體與斜體的項目清單、一份內含行內程式碼的編號清單、一張含表頭的三欄表格、一份勾了一項的待辦清單、一個可用的連結,以及一段縮排引用。九種元素、約二十行,就是十份真實文件裡有九份會用到的語法,剩下的都在速查表上。
小提醒:真正記住是在第二遍。照著預覽打第一次,練的是眼睛;憑記憶打第二次,練的是手,而寫作時要跟上思緒的正是手。
具體的七天計畫
如果你偏好分散著學,這份時程一次建立一個元素,最後產出你用得上的東西。每天十到二十分鐘就夠。
第 1 到 5 天:每天一個元素
每天只有一個目標。判斷完成的標準是「變成反射動作」,不是「時間到了」。
| 天數 | 主題 | 要打什麼 | 分鐘 | 達標的標準 |
|---|---|---|---|---|
| 1 | 標題與強調 | # ## ###、**粗體**、*斜體* | 10 | 不看資料就能寫出三層大綱 |
| 2 | 清單 | - 項目、1. 編號,加一層巢狀 | 10 | 縮排兩格做巢狀已成反射動作 |
| 3 | 連結與圖片 | [文字](網址) 與  | 10 | 「先方括號、再圓括號」不必再想 |
| 4 | 程式碼 | 行內反引號與三個反引號的圍欄 | 10 | 看到檔名就反射性加上反引號 |
| 5 | 表格與待辦清單 | 直線分欄、--- 分隔列、- [ ] 項目 | 15 | 能憑記憶做出一張三欄表格 |
| 6 | 真實文件 | 會議記錄或 README,全程只用 Markdown | 20 | 整份寫完,速查表查不到兩次 |
| 7 | 速度驗收 | 憑記憶重建一份排版完整的頁面 | 15 | 從頭到尾查資料少於三次 |
第 6 天:寫一份你真的需要的東西
第 6 天最關鍵。拿虛構內容練習對建立手感沒問題,但寫一份你真的需要的東西,會逼你做出真實的排版決定,而那些決定才是把語法知識變成判斷力的東西。會議記錄和專案 README 都是好題目。
第 7 天:速度驗收
憑記憶重建一份排版完整的頁面,順便數一下你查了幾次資料。全程少於三次,代表語法已經從筆記搬進手裡了。次數比較多也不算失敗,它只是告訴你明天該重練哪一個元素。
小提醒:有一個習慣比其他任何方法都更能加速:打字時讓預覽一直開著。把預覽關掉練習的人,第二週往往都在回頭找那些當下就能發現的錯誤。
每個新手都會犯的五個錯
先知道這五個,第一週的挫折感就會少掉大半。以下是壞掉的寫法:
#標題 井字號後面沒有空格
一段內文
- 第一項 清單黏在上一段後面
**粗體 ** 文字 符號內側多了一個空格
(標籤)[網址] 方括號和圓括號寫反了
縮排的一行 行首四個空格會變成程式碼區塊
同樣的內容,修正之後長這樣:
# 標題
一段內文
- 第一項
**粗體** 文字
[標籤](網址)
縮排的一行
五個裡面有三個和空行有關
空行正是文書處理軟體使用者最容易感到意外的地方。Markdown 把空行當成結構訊號:它結束一個段落,也讓清單、標題或程式碼區塊得以開始。當某個語法怎麼樣都不生效、符號看起來又都對的時候,先在它上面加一個空行,再去找其他原因。
剩下兩個,還有它們的解法
- 括號寫反。你先讀到的是標籤、後看到的是目的地,所以方括號在前:
[標籤](網址)。這個練一兩天就會消失。 - 不小心變成程式碼區塊。在原始 Markdown 裡,行首四個空格代表「這是程式碼」。內文請一律靠左,需要縮排效果時改用引用或清單。
這五個都不會造成永久傷害,這正是純文字格式安靜的優點:改掉那一行、看一眼預覽、繼續寫。想知道背後完整的規則,完整指南每一條都有交代。
基礎打穩之後往哪裡走
兩份帶你走更遠的指南
七天結束後,有兩份資源能帶你從「會用」走到「熟練」。完整 Markdown 指南深入處理每一個元素,包括速查表不得不略過的細節:特殊字元的跳脫、巢狀規則、參照式連結,以及什麼時候該改用內嵌 HTML。
GFM 指南則涵蓋你在 GitHub、GitLab 和多數現代筆記軟體上會遇到的擴充語法,表格、待辦清單、刪除線和自動連結都出自這裡。其中最值得多練的是表格,表格指南一列一列把它拆開來講。
比任何教材都有效的習慣
挑一件固定會做的寫作任務,永久改用 Markdown。會議記錄、工作日誌、個人日記、書單,任何每週至少會寫一次的東西都行。三個星期的真實使用,比任何刻意練習都更能把語法刻進記憶,因為你不再是在演練格式,而是在用它思考。
最後一個加速器。下次 AI 助理給你一段排好版的回答時,把原始 Markdown 複製出來讀一讀。你會看到標題、粗體、清單、表格和程式碼圍欄正在做你剛練過的事,這既是免費的閱讀材料,也提醒你這個格式已經被用得多廣,詳見AI 時代的 Markdown。
相關問題
立即使用編輯器
開啟編輯器