Markdown基本语法

tools

markdown是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的HTML文件。由于对于图片，图表、数学式都有较好的支持以及其简单的特性，markdown十分流行。

markdown本质和html一样是一种标记语言，它使用特殊的字符来表示格式控制信息。要高效地使用markdown撰写文档，需要对于其语法比较熟悉。

markdown实现同一种排版往往可以有不同的方式，比如二级标题可以使用-或者#来标记，本文章作为一个速查手册而不是一个详细的介绍，在这种情况下会选择其中一种风格。

段落

一个段落是一行或者多行连续的文本。普通段落没有缩进，前置的空格或者tab键会被忽略。段落之间由一个或者多个空白的行分隔。

标题

与html一样，markdown支持六级标题。在一行前面添加1-6个#字符来标记对应的标题:

### 这是三级标题

引用

在每一行的开始添加>字符来标记引用:

> This is a blockquote.
> 
> This is the second paragraph in the blockquote.
>
> ## This is an H2 in a blockquote

This is a blockquote.

This is the second paragraph in the blockquote.

This is an H2 in a blockquote

字体

在需要强调的文字前后添加1-3个*字符:

一个星号显示 *斜体*.
两个星号显示 **粗体**.
三个星号显示 ***粗斜体***

一个星号显示 斜体. 两个星号显示 粗体. 三个星号显示 粗斜体

在文字前后添加两个~字符实现删除线的效果:

~~这行文字表示被删除~~

这行文字表示被删除

列表

在每一行的开始使用*来标记无序列表:

* Math
* English
* History
  • Math
  • English
  • History

在每一行的开始使用数字跟一个.来标记有序列表:

1. 学习markdown
2. 使用markdown编写文章
  1. 学习markdown
  2. 使用markdown编写文章

多行的列表项应该使用空白行分隔，并且保持相同的缩进（tab or 4-spaces）

* A list item.

  With multiple paragraphs.

* Another item in the list.

  • A list item.

    With multiple paragraphs.

  • Another item in the list.

列表嵌套需要在子列表中添加4个空格的缩进

* MacOS rocks
    1. It is the most beautiful OS
    2. It is great for programming because it integrates seamlessly with unix tools
* MacOS sucks
    1. There is no as much games as on Windows
  • MacOS rocks
    1. It is the most beautiful OS
    2. It is great for programming because it integrates seamlessly with unix tools
  • MacOS sucks
    1. There is no as much games as on Windows

链接

markdown支持两种类型的链接:inline and reference

inline示例:

This is inline link for [google](https:www.google.com)

This is inline link for google

reference示例:

This is reference link for [google][google-link]

[google-link]: https://www.google.com

This is reference link for google

图片

图片与链接的语法很相似，同样支持inline和reference两种类型:

![alt text](path/to/img "title")

代码

在段落前后使用三个`来标记代码

脚注

中国早在三千多年前就发现了勾股定理[^1]

[^1]: 据《周髀算经》中记述，公元前一千多年周公与商高论数的对话中，商高就以三四五3个特定数为例详细解释了勾股定理要素

中国早在三千多年前就发现了勾股定理1

表格

使用|来分隔单元格，使用-来分隔表头和其他行

  • -: 右对齐
  • :- 左对齐
  • :-:居中对齐
|姓名|年龄|性别|
|:- |:-: |-: |
|张三|19|男|
|李四|21|女|
姓名 年龄 性别
张三 19 男
李四 21 女

任务列表

示例如下：

- [x] 吃饭
- [ ] 运动
- [ ] 工作
  • 吃饭
  • 运动
  • 工作

  1. 据《周髀算经》中记述，公元前一千多年周公与商高论数的对话中，商高就以三四五3个特定数为例详细解释了勾股定理要素 ↩