前言

Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。本文来源于 Markdown官方教程编写。

1 标题

在Markdown中,你可以通过在文字前面加上#来创建标题。#的数量代表了标题的级别。

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

2 段落和换行

段落之间留一个空行。如果你想在同一个段落内换行,可以在行尾添加两个空格。

1
2
3
这是第一个段落。

这是第二个段落。

3 强调

你可以使用*_来强调文本。

1
2
3
4
5
6
7
8
*这会是斜体*
_这也是斜体_

**这会是粗体**
__这也是粗体__

***这会是斜粗体***
___这也是斜粗体___

4 引用

引用文本前使用>符号。

1
> 这是一段引用文本。

5 列表

无序列表使用星号、加号或是减号作为列表标记:

1
2
3
4
* 项目1
* 项目2
* 项目2a
* 项目2b

有序列表则使用数字接着一个英文句点:

1
2
3
1. 第一项
2. 第二项
3. 第三项

6 链接

创建链接使用方括号包围文本,后面紧跟着圆括号包围的URL。

1
这是一个[示例链接](http://example.com)

7 图片

图片的语法和链接很相似,只是前面多了一个感叹号。

1
2
![这是图片的alt文字](http://example.com/image.jpg "图片title")
<img src="图片链接" alt="图片alt" title="图片title"> #对应的HTML代码:

8 代码

你可以使用反引号来标记代码。

1
`这是一行代码`

对于代码块,可以使用三个反引号包围代码块,也可以缩进四个空格。

1
这是一个代码块 ,反引号 ```

9 表格

Markdown也支持表格,使用-|来定义表格的头和列。

1
2
3
4
| 标题1 | 标题2 | 标题3 |
| ------ | ------ | ------ |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

10 分割线

要创建分隔线,在单独一行上使用三个或多个星号 (***)、破折号 (—) 或下划线 (___) ,并且不能包含其他内容。

1
2
3
---

*****

11 Markdown 转义字符语法

要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 \ 。

1
\* Without the backslash, this would be a bullet in an unordered list.

以下列出的字符都可以通过使用反斜杠字符从而达到转义目的:
可做转义的字符

(不再介绍特殊字符的转义)

12 HTML

如果Markdown的语法不足以满足你的需求,你也可以直接在Markdown文档中使用HTML。

1
<p>这是一个段落。</p>

13 选项

  • [x] 已经完成的项目
    • [x] 已完成的子项目
  • [ ] 未完成的项目
1
2
3
-  [x] 已经完成的项目
- [x] 已完成的子项目
- [ ] 未完成的项目

14 关于Hexo博客的外挂标签

这里只做视频部分的演示:

1
{% video yourvideo-http %}

详情可参考标签外挂

尾声

以上就是Markdown的基本使用技巧。通过这些简单的语法,可以创建出结构清晰、格式美观的文档。