用打的,不要只用讀的。一個分頁開語法速查表,另一個分頁開編輯器,把每個範例親手重打一遍,一邊打一邊看即時預覽的反應。即時回饋正是讓每個符號記得住的關鍵,多數人用這個方法不到三十分鐘就能掌握所有日常語法。

這樣你會「會用」。而「熟練」,也就是寫作時完全不必想語法,大約需要三週,而且靠的是實際使用而不是研究。下面的七天計畫是最快的結構化路徑:每天十到二十分鐘,一次練一個元素,最後用它寫出一份你本來就需要的文件。

重點速覽

學會基礎要多久大約三十分鐘,速查表與即時預覽並排著看
練到熟練要多久大約三週,把一件固定的寫作任務改用它
最好的第一步把速查表上的範例親手重打一遍,不要只用看的
練習方法每天寫一份真實文件,每打完一行就看一次預覽
最難的元素表格。其他語法都只有一兩個字元

為什麼用打的比用讀的快

重點摘要
  • 把速查表的範例在即時預覽裡重打一遍,比用讀的快得多。
  • 三十分鐘就能涵蓋日常寫作會用到的每一個符號。
  • 七天計畫每天加一個元素,一次十到二十分鐘。
  • 真正的熟練來自把一件每週固定的寫作任務永久改用 Markdown。

「想得起來」比「看得懂」重要

Markdown 與其說是知識,不如說是一種手感。日常會用到的符號總共就十幾個,難的從來不是看懂它們,而是在注意力放在內容上的同時,手指不假思索地把它們打出來。讀教學文章得到的是「看得懂」,也就是看到符號能認出它;親手打範例得到的是「想得起來」,而句子寫到一半、念頭才成形一半的時候,需要的正是後者。

即時預覽就是你的老師

即時預覽正是自學能這麼快的原因。每敲一個鍵,畫面不是立刻確認你打對了,就是立刻顯示哪裡出錯。# 後面漏了空格、** 忘了關、表格分隔列的直線數量不對,每個錯誤都變成一堂幾秒鐘就修完的微型課。對比學文書處理軟體,回饋要繞過選單和對話框,而且沒有任何東西告訴你為什麼會變成那樣。

這些符號本來就長這樣是有原因的

Markdown 的符號當初就是模仿大家在純文字電子郵件裡本來就會做的事:用星號包住要強調的字、用連字號列點、用縮排表示層次。親手打二十分鐘,這套邏輯就會浮出來。看見之後,語法就不再像是隨便規定的,而是理所當然的,這也是我們的 Markdown 白話入門開場的角度。

插圖:一隻手在一側敲打 Markdown 符號,另一側立刻浮現排版完成的文件,象徵靠即時回饋學習

第一個三十分鐘,一步一步做

這一次練習的五個步驟

  1. 一個分頁開速查表,另一個分頁開編輯器。
  2. 把下面這份文件從頭打一遍,不要用貼的。
  3. 每打完一行就看一次預覽,沒出現就當場修掉。
  4. 全部刪掉,憑記憶再打一次。
  5. 用它寫一則真實的短筆記,例如今天的待辦清單。

要打的就是下面這份。它用上了日常寫作會需要的每一種元素,也沒有多餘的:

# 本週紀錄

## 已決定
- **週五**推出 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,全程只用 Markdown20整份寫完,速查表查不到兩次
7速度驗收憑記憶重建一份排版完整的頁面15從頭到尾查資料少於三次

第 6 天:寫一份你真的需要的東西

第 6 天最關鍵。拿虛構內容練習對建立手感沒問題,但寫一份你真的需要的東西,會逼你做出真實的排版決定,而那些決定才是把語法知識變成判斷力的東西。會議記錄和專案 README 都是好題目。

第 7 天:速度驗收

憑記憶重建一份排版完整的頁面,順便數一下你查了幾次資料。全程少於三次,代表語法已經從筆記搬進手裡了。次數比較多也不算失敗,它只是告訴你明天該重練哪一個元素。

小提醒:有一個習慣比其他任何方法都更能加速:打字時讓預覽一直開著。把預覽關掉練習的人,第二週往往都在回頭找那些當下就能發現的錯誤。

每個新手都會犯的五個錯

先知道這五個,第一週的挫折感就會少掉大半。以下是壞掉的寫法:

#標題                   井字號後面沒有空格
一段內文
- 第一項                清單黏在上一段後面
**粗體 ** 文字          符號內側多了一個空格
(標籤)[網址]            方括號和圓括號寫反了
    縮排的一行          行首四個空格會變成程式碼區塊

同樣的內容,修正之後長這樣:

# 標題

一段內文

- 第一項

**粗體** 文字

[標籤](網址)

縮排的一行

五個裡面有三個和空行有關

空行正是文書處理軟體使用者最容易感到意外的地方。Markdown 把空行當成結構訊號:它結束一個段落,也讓清單、標題或程式碼區塊得以開始。當某個語法怎麼樣都不生效、符號看起來又都對的時候,先在它上面加一個空行,再去找其他原因。

剩下兩個,還有它們的解法

  • 括號寫反。你先讀到的是標籤、後看到的是目的地,所以方括號在前:[標籤](網址)。這個練一兩天就會消失。
  • 不小心變成程式碼區塊。在原始 Markdown 裡,行首四個空格代表「這是程式碼」。內文請一律靠左,需要縮排效果時改用引用或清單。

這五個都不會造成永久傷害,這正是純文字格式安靜的優點:改掉那一行、看一眼預覽、繼續寫。想知道背後完整的規則,完整指南每一條都有交代。

基礎打穩之後往哪裡走

兩份帶你走更遠的指南

七天結束後,有兩份資源能帶你從「會用」走到「熟練」。完整 Markdown 指南深入處理每一個元素,包括速查表不得不略過的細節:特殊字元的跳脫、巢狀規則、參照式連結,以及什麼時候該改用內嵌 HTML。

GFM 指南則涵蓋你在 GitHub、GitLab 和多數現代筆記軟體上會遇到的擴充語法,表格、待辦清單、刪除線和自動連結都出自這裡。其中最值得多練的是表格,表格指南一列一列把它拆開來講。

比任何教材都有效的習慣

挑一件固定會做的寫作任務,永久改用 Markdown。會議記錄、工作日誌、個人日記、書單,任何每週至少會寫一次的東西都行。三個星期的真實使用,比任何刻意練習都更能把語法刻進記憶,因為你不再是在演練格式,而是在用它思考。

最後一個加速器。下次 AI 助理給你一段排好版的回答時,把原始 Markdown 複製出來讀一讀。你會看到標題、粗體、清單、表格和程式碼圍欄正在做你剛練過的事,這既是免費的閱讀材料,也提醒你這個格式已經被用得多廣,詳見AI 時代的 Markdown

相關問題

立即使用編輯器

開啟編輯器