md格式基本语法

一、序言

md文件

本站文章均由markdown格式编写。

注意事项

不同编辑器对语法的解析可能有不同，因此用markdown语法编写的同一个文件在不同编辑器上解析可能会不同，不要担心，基本语法解析出来是一样的（但也因此编写时尽量规范可以避免不必要问题）。

特殊字符最后加上回车可以避免一些解析问题。

文本内容存储在带有.md或.markdown扩展名的纯文本文件中。

二、正文

标题

h1~6由’#’字符数量控制# h1, ## h2, ### h3, #### h4, ##### h5, ###### h6。

标题编号（Heading ID）### My Great Heading {#custom-id}，这不是所有编辑器都支持。

段落换行

在一段文本末尾连续按两下空格或用空行分隔，可以实现换行（推荐空行分隔，用前面一样避免解析问题）。

分割线

---, *** 加回车均可实现分割线。

---

斜体, 加粗, 删除线

用**包住文本可以加粗
用*包住文本可以斜体
用~~包住文本添加删除线

代码

行内代码可以由`包起来， `是个例外，如果想显示`，需要用更多数量`的把中间的包起来, 例如想显示一个`，其前后就用两个``包起来，想显示两个``，其前后就用三个```包起来，并在其前后加上空格。

代码块可以在开始行和结束行写相同数量多个反引号```包起来。

```
#include <stdio.h>
int main() {
    printf("`");
    return 1;
}
```

引用文本

引用文本添加>至开头即可，不同数量代表不同层级(最后一行回车)。

> example1
>> example2
>>> example3

对应效果

example1

example2

example3

链接

链接：[标题](https://bejson.com)。
图片：![alt text](image.jpg)。

列表

无序列表

- 列表一
- 列表二
- 列表三

对应效果

• 列表一
• 列表二
• 列表三

有序列表

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

对应效果

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

任务清单（勾选框）

- [x] 任务1
- [ ] 任务2
  - [ ] 子任务1
- [ ] 任务3
  - [x] 子任务1

对应效果

• 任务1
• 任务2
  • 子任务1
• 任务3
  • 子任务1

表格

| 项目        | 价格    |  数量  |
| --------   | ------   | ----  |
| 计算机     | 10000 |   5    |
| 手机        |  2000  |  12   |
| 数据线     |    10    |  234 |

对应效果

项目	价格	数量
计算机	10000	5
手机	2000	12
数据线	10	234

内嵌 HTML 标签

行级內联标签

HTML 的行级內联标签如 <span>、<cite>、<del> 不受限制，可以在 Markdown 的段落、列表或是标题里任意使用。依照个人习惯，甚至可以不用 Markdown 格式，而采用 HTML 标签来格式化。例如：如果比较喜欢 HTML 的 <a> 或 <img> 标签，可以直接使用这些标签，而不用 Markdown 提供的链接或是图片语法。当你需要更改元素的属性时（例如为文本指定颜色或更改图像的宽度），使用 HTML 标签更方便些。

HTML 行级內联标签和区块标签不同，在內联标签的范围内， Markdown 的语法是可以解析的。

This **word** is bold. This <em>word</em> is italic.

渲染效果如下:

This word is bold. This word is italic.

区块标签

区块元素──比如 <div>、<table>、<pre>、<p> 等标签，必须在前后加上空行，以便于内容区分。而且这些元素的开始与结尾标签，不可以用 tab 或是空白来缩进。Markdown 会自动识别这区块元素，避免在区块标签前后加上没有必要的 <p> 标签。

例如，在 Markdown 文件里加上一段 HTML 表格：

This is a regular paragraph.

<table>
    <tr>
        <td>Foo</td>
        <td>Foo2</td>
        <td>Foo3</td>
    </tr>
</table>

This is another regular paragraph.

渲染效果如下:
This is a regular paragraph.

Foo

Foo2

Foo3

This is another regular paragraph.

请注意，Markdown 语法在 HTML 区块标签中将不会被进行处理。例如，你无法在 HTML 区块内使用 Markdown 形式的*强调*。