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/