Markdown

維基教科書,自由的教學讀本

Markdown 是一種輕量的標記語言[1]。您也許從未聽說過,只是出於好奇來看看;您也許聽說過,卻因為「標記語言」二字打了退堂鼓;您也許已經開始用上,但想要更進一步去精通來擴展自己。無論如何,學習 Markdown 既不難、又有用。一方面,其創始理念即為「使用易讀易寫的純文本格式編寫文檔,然後轉換成有效的XHTML(或者HTML)文檔」[2];另一方面,Markdown 又有着廣泛的運用。例如 GitHub 中幾乎每一個 repository 都有 README.md 文檔,而這個文檔就是用 Markdown 寫成。 本教程旨在教授 Markdown 的一些概念、擴展與用法。也歡迎其他精通 Markdown 的朋友相助。

語法[編輯]

  • 斜體:
*斜体文本*
_斜体文本_
  • 粗體:
**粗体文本**
__粗体文本__
  • 鏈接:
[鏈接名稱](http://www.example.org)
<http://www.example.org>
<a href="http://www.example.org">鏈接名稱</a>
  • 圖片:
![alt 屬性文本](http://upload.wikimedia.org/wikibooks/zh/b/bc/Wiki.png "可選標題")
<img src="http://upload.wikimedia.org/wikibooks/zh/b/bc/Wiki.png">
  • 分割線:(三個或三個以上的如下符號)
---
***
---
  • 刪除線:
~~文本~~
<del>文本</del>
  • 下劃線:
<u>文本</u>
  • 無序列表:
* 第一项
+ 第二项
- 第三项
  • 有序列表:
1. 第一项
2. 第二项
3. 第三项
  • 區塊
> 第一行
> 第二行
> 第三行
  • 代碼塊:(在第一個「```」後面加上代碼名稱)
```html
<a>这里放代码</a>
```
  1. https://zh.wikipedia.org/wiki/Markdown
  2. https://daringfireball.net/projects/markdown/