语法
段落和换行
段落 <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!](http://7xlhbk.com1.z0.glb.clouddn.com/markdown.jpg "It's Markdown!")
![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 |
参考
项目