cover

Markdown 語法速查:你最常忘記的那些

寫 Markdown 的人分兩種:一種是什麼語法都記得的天才,另一種是每次寫表格都要 Google 的正常人。我是後者。

先講結論

這篇不是教學,是速查手冊。把最常用的語法和最容易搞混的地方整理在一起,下次忘記的時候直接翻這篇就好。

標題與段落

基本語法指南

標題用 #,幾個 # 就是幾級標題。段落之間空一行就好,同一行內要換行就在行尾打兩個空格。

# H1 標題
## H2 標題
### H3 標題

說真的,H4 以下我幾乎沒用過。如果你的文章需要用到 H5,大概是結構該重新想想了。

強調與文字樣式

*斜體*_斜體_
**粗體**__粗體__
~~刪除線~~

顯示效果:粗體斜體被刪掉的文字

我個人的習慣是粗體用 **、斜體用 *,從來不用底線版本。選一種風格然後貫徹到底就好。

列表:有序 vs 無序

- 無序項目一
- 無序項目二
 
1. 有序項目一
2. 有序項目二
    - 可以巢狀

一個常見的坑:有序列表的數字其實不重要,Markdown 會自動幫你排序。所以你全部寫 1. 也可以——但為了可讀性,我還是建議照實標號。

連結與圖片

[顯示文字](https://example.com)
![替代文字](https://example.com/image.png)

圖片就是連結前面加個 !。如果你用 Quartz 或 Obsidian,還可以用 wikilinks:[[文章名稱]],更方便。

程式碼

行內程式碼用反引號:像這樣

多行程式碼用三個反引號,後面可以加語言名稱來啟用語法高亮:

```javascript
const greeting = "Hello, Markdown!";
console.log(greeting);
```

引用與水平線

> 這是引用文字
 
---

引用很適合用來放「重要提醒」或「別人說的話」。但拜託不要整篇文章都是引用,那不是引用,是偷懶。

水平線用 ---,我通常用來分隔文章的大段落。

表格(每次都忘的那個)

| 欄位一 | 欄位二 | 欄位三 |
| ------ | ------ | ------ |
| 資料   | 資料   | 資料   |

對齊方式::- 靠左、:-: 置中、-: 靠右。說真的,每次都要查。

勾選框

- [ ] 還沒做
- [x] 做完了
  • 學會所有 Markdown 語法
  • 承認自己每次都要查表格語法

實用組合技

列表裡放連結、引用裡放粗體,這些組合在實際寫作時很常用:

- [Markdown 官方文件](https://daringfireball.net/projects/markdown/)
- **重點**:[Hexo 文件](https://hexo.io/docs/)
 
> **注意:** 請確保 Node.js 已更新到最新版本。

寫了一篇教 Markdown 的文章,用 Markdown 寫的,這是不是某種後設幽默