语法
段落和换行
段落 <p> 前后必须保留一个或多个的空行。
段落内换行 <br> 要在行尾追加两个以上的空格然后回车。
1 2 3 4
| 春晓
春眠不觉晓,处处闻啼鸟。 夜来风雨声,花落知多少。
|
春晓
春眠不觉晓,处处闻啼鸟。
夜来风雨声,花落知多少。
标题
在行首插入 1 到 6 个 # ,对应标题 <h1> 到 <h6>。
1 2 3 4 5 6
| # 标题 h1 ## 标题 h2 ### 标题 h3 #### 标题 h4 ##### 标题 h5 ###### 标题 h6
|
引用
在段落或其他内容前使用 > 符号,就可以将这段内容标记为 ‘引用’ 的内容 <blockquote>。
1 2 3 4 5 6 7 8 9 10 11 12 13 14
| > 引用内容。
> 多行引用,第一行; > 多行引用,第二行; > 多行引用,第三行。
> 嵌套引用,第一层。 > > 嵌套引用,第二层。 > > > 嵌套引用,第三层。
> 包含其它 `Markdown` 语法 > > - 列表项目 > - 列表项目
|
引用内容。
多行引用,第一行;
多行引用,第二行;
多行引用,第三行。
嵌套引用,第一层。
嵌套引用,第二层。
嵌套引用,第三层。
包含其它 Markdown 语法
列表
无序列表项 <ul> 以 * + 或 - 加空格空格开始:
1 2 3 4 5
| * 无序列表 1 + 嵌套子列表 11 + 嵌套子列表 12 + 无序列表 2 - 无序列表 3
|
有序列表项 <ol> 以 任意数字 加 . 再加 空格 开始:
1 2 3 4 5
| 1. 有序列表 1 + 子列表 11 + 子列表 12 1. 有序列表 2 1. 有序列表 3
|
- 有序列表 1
- 有序列表 2
- 有序列表 3
列表项可以包含其它内容,内容必须以 4 个空格或 1 个制表符缩进:
1 2 3 4 5 6 7 8
| 1. 项目中包含多个段落
段落内容, 段落内容。
1. 项目中包含码块
echo 'Hello World!';
|
项目中包含多个段落
段落内容,
段落内容。
项目中包含码块,缩进 8 个空格或 2 个制表符
echo 'Hello World!';
代码
代码块 <code> 前后必须有一个或多个空行,且每行代码必须以 4 个空格或 1 个制表符缩进:
1 2 3
| function fn () { var str = 'Hello World'; }
|
function fn () {
var str = 'Hello World';
}
扩展语法,代码无须缩进,并可指明语言类型实现代码高亮:
` ` ` js
function fn () {
var str = 'Hello World';
}
` ` `
上面 ` 符号之间应该没有空格,因 hexo 解析问题无法正常显示,此处加了空格
1 2 3
| function fn () { var str = 'Hello World'; }
|
行内代码:
1
| 行内代码如 `<title></title>` ,` 是 Tab 键上方、数字 1 键左侧的按键。
|
行内代码如 <title></title> ,` 是 Tab 键上方、数字 1 键左侧的按键。
分隔线
使用三个或更多的 * - 或 _ 来添加分隔线 <hr>:
链接
行内式格式为 [链接名称](链接地址 "标题文本") :
1 2 3
| [百度](https://www.baidu.com "百度") [Google](https://www.google.com.hk "谷歌") [Readme](README.md "相对路径")
|
百度
谷歌
说明
参考式链接的写法相当于行内式拆分成两部分,通过 标识符 来连接两部分:
1 2 3
| [链接名称][标识符]
[标识符]: 链接地址 "标题文本"
|
- 标识符可以是字母、数字、空白或标点符号;
- 参考式便于集中管理链接内容。
1 2 3 4 5 6
| [百度][baidu] [谷歌][google] [百度][1] [谷歌][2]
[baidu]: https://www.baidu.com "百度" [google]: https://www.google.com.hk "谷歌" [1]: https://www.baidu.com "百度" [2]: https://www.google.com.hk "谷歌"
|
百度 谷歌 百度 谷歌
自动链接使用 <> 包括的链接地址或邮箱地址会被自动转换为超链接:
1 2
| <https://www.baidu.com> <123@email.com>
|
https://www.baidu.com
123@email.com
图片
插入图片的语法和插入超链接的语法基本一致,只是在最前面多一个 !。
行内式的图片语法:
1 2
|  
|
参考式的图片语法:
1 2 3
| ![图片名称][标识符]
[标识符]: 图片地址 "标题文本"
|
1 2 3 4 5
| 
![It's Markdown!][Markdown]
[Markdown]: http://7xlhbk.com1.z0.glb.clouddn.com/markdown.jpg "It's Markdown!"
|
强调
使用 *文本* 或 _文本_ 实现 <em>文本</em> ,通常表现为斜体:
强调 演示 文本
使用 **文本** 或 __文本__ 实现 <strong>文本</strong>,通常表现为加粗:
强调 演示 文本
字符转义
反斜线 \ 转义特殊字符:
1
| \ ` * _ {} [] () # + - . !
|
1 2 3
| - 2 * 1 = 2
\- 2 * 1 = 2
|
- (2 * 1) = - 2
删除线
删除线
表格
使用 | 分隔单元格,使用 - 分隔表头和其他行:
1 2 3 4
| | 表头 1 | 表头 2 | | --- | --- | | 单元格 11 | 单元格 21 | | 单元格 12 | 单元格 22 |
|
| 表头 1 |
表头 2 |
| 单元格 11 |
单元格 21 |
| 单元格 12 |
单元格 22 |
建议 | 和 - 两侧保留空格,这样内容更加清晰。
使用 : 实现单元格左右或居中对齐:
1 2 3 4
| | 默认 | 左对齐 | 居中对齐 | 右对齐 | | --- | :--- | :---: | ---: | | 默认左对齐 | 此列文本左对齐 | 此列文本居中对齐 | 此列文本右对齐 | | 左对齐 | 左对齐 | 居中对齐 | 右对齐 |
|
| 默认 |
左对齐 |
居中对齐 |
右对齐 |
| 默认左对齐 |
此列文本左对齐 |
此列文本居中对齐 |
此列文本右对齐 |
| 左对齐 |
左对齐 |
居中对齐 |
右对齐 |
语法嵌套:
1 2 3 4
| | 强调 | 代码 | 链接 | | --- | --- | --- | | _百度_ | `Baidu` | [百度](https://www.baidu.com) | | __谷歌__ | `Google` | [谷歌](https://www.google.com.hk) |
|
| 强调 |
代码 |
链接 |
| 百度 |
Baidu |
百度 |
| 谷歌 |
Google |
谷歌 |
兼容HTML语法
可以直接引用 HTML 元素,元素的开始标签前和结束标签后各保留一个空行:
1 2 3 4 5 6
| 指定特殊样式 <table class="table" style="color:red;"> <tr><th>#</th><th>代码</th><th>输出</th></tr> <tr><td>1</td><td>date('Y-m-d')</td><td>2016-07-15</td></tr> <tr><td>2</td><td>date('Y-m-t')</td><td>2016-07-31</td></tr> </table>
|
| # | 代码 | 输出 |
| 1 | date('Y-m-d') | 2016-07-15 |
| 2 | date('Y-m-t') | 2016-07-31 |
参考
项目