Markdown常用标记总结
发布于 2015-01-13 03:52:35 | 708 次阅读 | 评论: 0 | 来源: PHPERZ
这里有新鲜出炉的Markdown 语法说明，程序狗速度看过来！
Markdown 轻量级标记语言
Markdown 是一种轻量级标记语言，创始人为约翰·格鲁伯（John Gruber）。它允许人们“使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML(或者HTML)文档”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。 Markdown的语法简洁明了、学习容易，而且功能比纯文本更强，因此有很多人用它写博客。世界上最流行的博客平台WordPress和大型CMS如joomla、drupal都能很好的支持Markdown。
Markdown 是一种轻量级标记语言,本文为大家整理了几个常用的makrdown标记，感兴趣的同学参考下。
Markdown简介
Markdown 是一种轻量级标记语言，创始人为约翰·格鲁伯（John Gruber）。它允许人们“使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML(或者HTML)文档”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。 Markdown的语法简洁明了、学习容易，而且功能比纯文本更强，因此有很多人用它写博客。世界上最流行的博客平台WordPress和大型CMS如joomla、drupal都能很好的支持Markdown。
1. 常用标记
1.1 标题
1.1.1 说明
- 使用
#表示标题，一级标题使用一个#，二级标题使用两个##，以此类推，共有六级标题。 - 使用
=====表示高阶标题，使用---------表示次阶标题。
1.1.2 示例
# 这是一级标题
## 这是二级标题
### 这是三级标题
###### 这是六级标题
这是一级标题
========
这是二级标题
--------------
这是一级标题
这是二级标题
这是三级标题
这是六级标题
这是一级标题
这是二级标题
1.1.3 注意
#和标题之间最好加一个空格。不要问我为什么，貌似有时候不会被识别为标题？已经忘记自己为什么要加空格了，也许是任性。====和----表示标题时，大于等于2个都可以表示。- 我通常在标题分级时使用标题标记，这个的用处很明了了。
1.2 目录
1.2.1 说明
使用[TOC]生成目录。如一开始的目录所示。
1.2.2 示例
[TOC]
[TOC]
1.2.3 注意
- 如果你的标题都是按照Markdown语法书写的话，可以自动生成层级目录。
- 我常用 为知笔记 记笔记，可惜为知笔记不支持[TOC]标记，一个悲伤的故事。
[TOC]标记可能只能放在一级标题的前面，视不同的编译器而定。
1.3 引用
1.3.1 说明
使用>表示引用，>>表示引用里面再套一层引用，依次类推。
1.3.2 示例
例1：
> 这是一级引用
>>这是二级引用
>>> 这是三级引用
>这是一级引用
这是一级引用
这是二级引用
这是三级引用
这是一级引用
例2：
> 这是一级引用
>>这是二级引用
>>> 这是三级引用
>这是一级引用
这是一级引用
这是二级引用
这是三级引用
这是一级引用
1.3.3 注意
- 如果
>和>>嵌套使用的话，从>>退到>时，必须之间要加一个空格或者>作为过渡，否则默认为下一行和上一行是同一级别的引用。如示例所示。 - 引用标记里可以使用其他标记，如：有序列表或无序列表标记，代码标记等。
- 我通常在引用别人的话或者某些时候做说明时使用引用标记，其实我一直拿不准到底什么情况下使用引用标记才是正确的。如果你知道，我只想说：请务必告诉我。
1.4 代码块
1.4.1 说明
使用```表示代码块。
1.4.2 示例
```javascript
var canvas = document.getElementById("canvas");
var context = canvas.getContext("2d");
```
var canvas = document.getElementById("canvas");
var context = canvas.getContext("2d");
1.4.3 注意
- `这个符号是在
Esc键下面，切换到英文下即可。 - ```后面的
javascript表示此段代码为javascript代码，Markdown会自行使用javascript代码颜色渲染。这里也可以不写。PS：谁能够提供一个完整的Markdown可以渲染的语言列表啊，比如：linux命令这里写什么？ - 本文档所有使用讲解Markdown语法标记示例的地方都是使用代码块标记的。
1.5 行内代码
1.5.1 说明
使用``表示行内代码。
1.5.2 示例
这是`javascript`代码
这是javascript代码
1.5.3 注意
- 本页部分文字中间的英文字母就是使用行内代码标记标记的。
- 这个的使用场景我也有些模糊。我常在文字间有英文的时候使用，但有时又不知道该不该使用，困扰。如果你知道，请告诉我。
1.6 导入图片
1.6.1 说明
使用导入图片。其中：
Alt text为如果图片无法显示时显示的文字；/path/to/img.jpg为图片所在路径；Optional title为显示标题。显示效果为在你将鼠标放到图片上后，会显示一个小框提示，提示的内容就是Optional title里的内容。
1.6.2 示例
1.6.3 注意
- 导入的图片路径可以使用绝对路径也可以使用相对路径，建议使用相对路径。
- 我通常的做法是Markdown文档的同级目录下建立一个pictures文件夹，里面放置所有所需的图片，如果图片多的话，你也可以在pictures文件夹里建立子文件夹归类。
1.7 列表
1.7.1 说明
使用1. 2. 3.表示有序列表，使用*或-或+表示无序列表。
1.7.2 示例
例1：有序列表
1. 第一点
2. 第二点
4. 第三点
- 第一点
- 第二点
- 第三点
例2：无序列表
+ 呵呵
* 嘉嘉
- 嘻嘻
- 吼吼
- 嘎嘎
+ 桀桀
* 哈哈
-
呵呵
- 嘉嘉
- 嘻嘻
-
吼吼
- 嘎嘎
- 桀桀
-
哈哈
1.7.3 注意
- 无序列表或有序列表标记和后面的文字之间要有一个空格隔开。
- 有序列表标记不是按照你写的数字进行显示的，而是根据当前有序列表标记所在位置显示的，如示例1所示。
- 无序列表的项目符号是按照实心圆、空心圆、实心方格的层级关系递进的，如例2所示。通常情况下，同一层级使用同一种标记表示，便于自己查看和管理。
- 无序列表和有序列表标记的使用场景也很明了，故不多说。
1.8 粗体和斜体
1.8.1 说明
使用 ** 或者 __ 表示粗体。
使用 * 或者 _ 表示斜体。
1.8.2 示例
**粗体1** __粗体2__
*斜体1* _斜体2_
粗体1 粗体2
斜体1 斜体2
1.8.3 注意
- 前后的
*或_与要加粗或倾斜的字体之间不能有空格。 - 我通常在强调时使用加粗标记，在和一行中的加粗区分且也表示强调时使用倾斜标记，这里的倾斜标记的使用场景不明确。如果你知道：请务必告诉我。
1.9 表格
1.9.1 说明
具体使用方式请看示例。
------:为右对齐。:------为左对齐。:------:为居中对齐。-------为使用默认居中对齐。
1.9.2 示例
| 序号 | 交易名 | 交易说明 | 备注 |
| ------: | :-------: | :--------- | ------ |
| 1 | prfcfg | 菜单配置 | 可以通过此交易查询到所有交易码和菜单的对应关系 |
| 2 | gentmo | 编译所有交易 | |
| 100000 | sysdba | 数据库表模型汇总 | |
| 序号 | 交易名 | 交易说明 | 备注 |
|---|---|---|---|
| 1 | prfcfg | 菜单配置 | 可以通过此交易查询到所有交易码和菜单的对应关系 |
| 2 | gentmo | 编译所有交易 | |
| 100000 | sysdba | 数据库表模型汇总 |
1.9.3 注意
- 每个Markdown解析器都不一样，可能左右居中对齐方式的表示方式不一样。
1.10 分割线
1.10.1 说明
使用---或者***或者* * *表示水平分割线。
1.10.2 示例
---
***
* * *
1.10.3 注意
- 只要
*或者-大于等于三个就可组成一条平行线。 - 使用
---作为水平分割线时，要在它的前后都空一行，防止---被当成标题标记的表示方式。
1.11 链接
1.11.1 说明
使用[](link "Optional title")表示行内链接。其中：
[]内的内容为要添加链接的文字。link为链接地址。Optional title为显示标题。显示效果为在你将鼠标放到链接上后，会显示一个小框提示，提示的内容就是Optional title里的内容。
参考式链接如例所示。
1.11.2 示例
例1：行内链接
这就是我们常用的地址：[Baidu](www.baidu.com "百度一下，你就知道" )
这就是我们常用的地址：Baidu
例2：参考式链接
这就是我们常用的地址：[Baidu][1]
[1]:www.baidu.com "百度一下，你就知道"
这就是我们常用的地址：Baidu
1.11.3 注意
- 参考式链接和行内链接的效果是一样的，各有利弊。行内连接清晰易懂，可以清楚的知道链接的地址，但是不便于多次利用。参考式链接可以重复使用，但不能即刻知道链接的地址。
- 使用场景很明了，不多说。
1.11 反斜杠
1.11.1 说明
使用\表示反斜杠。在你不想显示Markdown标记时可以使用反斜杠。
1.11.2 示例
\*这里不会显示斜体\*
*这里不会显示斜体*
1.11.3 注意
无。
1.12 空格
1.12.1 说明
Markdown语法会忽略首行开头的空格，如果要体现出首行开头空两个的效果，可以使用全角符号下的空格，windows下使用shift+空格切换。
1.12.2 示例
无。
1.12.3 注意
无。
2. 次常用标记
#### 2.1 标签分类
2.1.1 说明
使用标签:或者Tags:表示标签标记。
2.1.2 示例
标签: 数学 英语
Tags: 数学 英语
标签: 数学 英语
Tags: 数学 英语
2.1.3 注意
标签:或者Tags:的冒号要使用半角冒号。- 基本没使用过这个标记，不过应用场景应该是归类。便于快速了解文章分类。难道可以通过某种方式来遍历到标签标记？不甚了解。如你知道：请告诉我。
2.2 删除线
2.2.1 说明
使用 ~~表示删除线。
2.2.2 示例
~~这是一条删除线~~
这是一条删除线
2.2.3 注意
- 注意
~~和 要添加删除线的文字之间不能有空格。 - 我常使用在显示的告诉自己这行文字是要删除的。
2.3 注脚
2.3.1 说明
使用 [^footer] 表示注脚。
2.3.2 示例
这是一个注脚测试[^footer1]。
[^footer1]: 这是一个测试，用来阐释注脚。
这是一个注脚测试[^footer1]。
2.3.3 注意
- 我常在需要解释一个名词，或者一本书，或者一个人时使用脚注标记。
3. 不常用标记
3.1 实现页内跳转
3.1.1 说明
使用html代码实现页内跳转。在要跳转到的位置定义个锚<span id = "jump">hehe</span>，然后使用[你好](#jump)将你好设置为一单击即跳转到hehe所在位置的效果。
3.1.2 示例
[你好](#jump)
<span id = "jump">hehe</span>
你好
hehe