Markdown 是什麼:三個符號就夠用
「AI 幫我寫的檔案打開來一堆井字號和減號,那是什麼?我需要學嗎?」夥伴的提問
井字號是標題,減號是清單,中括號是待辦。課堂上兩分鐘從空白檔寫到看得到效果,以及怎麼在 VS Code 左邊寫、右邊看排好的樣子。
打開 AI 幫你寫的檔案,裡面一堆 # 和 -。那不是亂碼,是 Markdown。
先講它是什麼
01用幾個符號,告訴電腦「這行是標題、這行是清單」
Markdown 是一種寫純文字的方式。檔名結尾是 .md。你不用按任何格式按鈕,只要在一行的開頭打上約定好的符號,看得懂的軟體就會把它排成標題、清單、勾選框。
它會一直出現在你和 AI 之間:給 AI 的長期說明書 CLAUDE.md、專案的門面 README.md、它幫你留的筆記,全部都是這個格式。看得懂它,你就看得懂 AI 寫了什麼給你,也改得動。
先學這三個
井字號、減號、中括號
三個符號
02夠你讀懂八成的 .md 檔
# 標題
行首一個井字號,空一格,後面就是大標題。兩個 ## 是中標題,三個 ### 是小標題。
- 清單
行首一個減號,空一格,後面就是清單的一項。一行一項,往下排。
- [ ] 勾選框
減號後面加一對中括號,就是待辦。中括號裡打一個 x,變成已完成。
符號和文字之間要空一格。少了那一格,它就只是一個普通的井字號。
課堂上的示範
03兩分鐘,從空白檔到看得到效果
嚮導在課堂上開了一個新檔案,存成 教學MD格式.md,然後只做了三件事。
- 打一行字,前面加上
- [ ]。旁邊的預覽出現一個空的勾選框。 - 複製成第二行,把中括號裡的空白改成
x。預覽裡第二個框被打勾了。 - 把內容換成一行
#開頭的標題,加一行普通的句子。預覽裡標題變大變粗,句子是一般內文。
你打的是左邊那幾個符號,看到的是右邊排好的樣子:
# 這是我的開心教學
今天我們一起學會了爬山、釣魚,還有做露營的準備。
那兩行字是用語音講進去的,不是打字。檔案內容用說的,符號再自己補上,也是一種寫法。
怎麼看到排好的樣子
04左邊寫,右邊看
課堂上用的是 Visual Studio Code,免費,Windows 和 Mac 都有。打開一個 .md 檔之後,編輯區右上角有一個「開啟側邊預覽」的小圖示,按下去,畫面就分成兩半:左邊是你打的原始文字,右邊是排好的結果。左邊一改,右邊跟著變。
不想裝東西也可以。.md 就是純文字,用記事本打開一樣讀得到,只是看到的是符號,不是排好的樣子。Obsidian 這類筆記軟體也是直接讀寫 .md。
什麼時候會用到
05你不一定要自己寫,但要看得懂
.md,你看得出哪裡是標題、哪裡是待辦,知道它整理了什麼。帶得走的東西
井字號是標題,減號是清單,中括號是待辦。
符號後面記得空一格。
現在開一個 .md 檔,打這三行試試看。
留言
CYC 看過才會公開。
還沒有公開的留言。