對於技術文件寫作來說,能夠省去複雜語法和繁複操作,同時又能方便的寫出好的架構和論述很重要。因此我需要
- 直接在本文中加入簡單的Tag語法省去滑鼠操作時間
- 明顯地文章段落顯示方式
- 方便的支援巢狀條列語法
- 美觀地顯示程式語言代碼
為了做出好的文件,了解並學習Markdown語法是必經的路程。就讓我邊查資料現學現賣吧。
目錄
參考資料
- Markdown 官方網站(英)
- Markdown Wiki說明(英)
- Stackoverflow Markdown Help(英)
- Markdown Cheatsheet(英)
- GitHub Flavored Markdown(英)
- Octopress: Sharing Code Snippets(英)
- 自由軟體鑄造場的Markdown簡介(中)
- Markdown 語法說明(中)
語法說明
注意!有些效果可以透過不同語法達成。 本文只列出我感興趣的語法,並沒有列出完整的語法。
標題
## 主標題
### 次要標題
#### 更次要標題,最多到6個#
主標題
次要標題
更次要標題,最多到6個
Bullet List
- 第一層List
- 第二層List,和第一層隔4個空白字元或是tab
- 第三層List,和第二層隔4個空白字元或是tab
- 第一層List
- 第二層List,和第一層隔4個空白字元或是tab
- 第三層List,和第二層隔4個空白字元或是tab
- 第二層List,和第一層隔4個空白字元或是tab
數字 List
1. 第一層List
1. 第二層List,和第一層隔4個空白字元或是tab
1. 第三層List,和第二層隔4個空白字元或是tab
- 第一層List
- 第二層List,和第一層隔4個空白字元或是tab
- 第三層List,和第二層隔4個空白字元或是tab
- 第二層List,和第一層隔4個空白字元或是tab
撒尿牛丸 List
1. 第一層List
- 第二層List,和第一層隔4個空白字元或是tab
1. 第三層List,和第二層隔4個空白字元或是tab
- 第一層List
- 第二層List,和第一層隔4個空白字元或是tab
- 第三層List,和第二層隔4個空白字元或是tab
- 第二層List,和第一層隔4個空白字元或是tab
分隔線
***
字型
*斜體字,字和星號中間不能空白*
斜體字,字和星號中間不能空白
**粗體字,字和星號中間不能空白**
粗體字,字和星號中間不能空白
連結
[本站](http://wen00072.github.io)
Code
- 因為要顯示程式碼,所以不會Markdown的語法
- 方式
- 行首以tab或8個空白開始
- 使用成對的`把程式碼包起來
- 方式
- 這個bullit 效果沒有出來 - 這個bullit 效果沒有出來
̀我是程式碼 ̀
我是程式碼
引用
> 第一層引用
>> 第二層引用
第一層引用
第二層引用
段落用斷行
行尾沒有空白字元
第二行
行尾沒有空白字元 第二行
行尾加上兩個以上空白字元
第二行
行尾加上兩個以上空白字元
第二行
如何做出目錄
- 在文件中嵌入HTML的anchor tag
- 同樣的文件中指定連結
1 2 |
|
GitHub Flavored Markdown
刪除線
~~打我啊笨蛋,~和句子中間一樣不能有空白~~
打我啊笨蛋,~和句子中間一樣不能有空白
Fenced code blocks
GitHub Flavored Markdown語法
使用
```把程式包起來
1 2 3 4 5 6 7 8 |
|
1 2 3 4 5 6 |
|
Octopress的語法
Octopress的語法讓使用者提供
- 指定語言Highlight
- 標題
- URL
- URL文字說明
1 2 3 4 5 6 7 8 |
|
1 2 3 4 5 6 |
|