第三堂共學

Markdown 是什麼:三個符號就夠用

「AI 幫我寫的檔案打開來一堆井字號和減號,那是什麼?我需要學嗎?」夥伴的提問

井字號是標題,減號是清單,中括號是待辦。課堂上兩分鐘從空白檔寫到看得到效果,以及怎麼在 VS Code 左邊寫、右邊看排好的樣子。

打開 AI 幫你寫的檔案,裡面一堆 # 和 -。那不是亂碼,是 Markdown。

先講它是什麼

01用幾個符號,告訴電腦「這行是標題、這行是清單」

Markdown 是一種寫純文字的方式。檔名結尾是 .md。你不用按任何格式按鈕,只要在一行的開頭打上約定好的符號,看得懂的軟體就會把它排成標題、清單、勾選框。

它會一直出現在你和 AI 之間:給 AI 的長期說明書 CLAUDE.md、專案的門面 README.md、它幫你留的筆記,全部都是這個格式。看得懂它,你就看得懂 AI 寫了什麼給你,也改得動。

先學這三個

井字號、減號、中括號

三個符號

02夠你讀懂八成的 .md 檔

# 標題

行首一個井字號,空一格,後面就是大標題。兩個 ## 是中標題,三個 ### 是小標題。

- 清單

行首一個減號,空一格,後面就是清單的一項。一行一項,往下排。

- [ ] 勾選框

減號後面加一對中括號,就是待辦。中括號裡打一個 x,變成已完成。

符號和文字之間要空一格。少了那一格,它就只是一個普通的井字號。

課堂上的示範

03兩分鐘,從空白檔到看得到效果

嚮導在課堂上開了一個新檔案,存成 教學MD格式.md,然後只做了三件事。

  1. 打一行字,前面加上 - [ ]。旁邊的預覽出現一個空的勾選框。
  2. 複製成第二行,把中括號裡的空白改成 x。預覽裡第二個框被打勾了。
  3. 把內容換成一行 # 開頭的標題,加一行普通的句子。預覽裡標題變大變粗,句子是一般內文。

你打的是左邊那幾個符號,看到的是右邊排好的樣子:

# 這是我的開心教學
今天我們一起學會了爬山、釣魚,還有做露營的準備。

那兩行字是用語音講進去的,不是打字。檔案內容用說的,符號再自己補上,也是一種寫法。

怎麼看到排好的樣子

04左邊寫,右邊看

課堂上用的是 Visual Studio Code,免費,Windows 和 Mac 都有。打開一個 .md 檔之後,編輯區右上角有一個「開啟側邊預覽」的小圖示,按下去,畫面就分成兩半:左邊是你打的原始文字,右邊是排好的結果。左邊一改,右邊跟著變。

不想裝東西也可以。.md 就是純文字,用記事本打開一樣讀得到,只是看到的是符號,不是排好的樣子。Obsidian 這類筆記軟體也是直接讀寫 .md。

什麼時候會用到

05你不一定要自己寫,但要看得懂

讀AI 交給你一份 .md,你看得出哪裡是標題、哪裡是待辦,知道它整理了什麼。
改想加一條規則、勾掉一件做完的事,自己打一行就好,不用再請它重寫一次。
查其他符號遇到再查。搜尋「Markdown 語法」,或直接問 AI「這個符號是什麼意思」。

帶得走的東西

井字號是標題,減號是清單,中括號是待辦。

符號後面記得空一格。

現在開一個 .md 檔,打這三行試試看。

留言

CYC 看過才會公開。

還沒有公開的留言。

看其他教材

留言