【markdown】语法

生成内容目录

【参考：Markdown 生成内容目录 - 简书】

在段落中填写 [TOC] 以显示全文内容的目录结构，一般写在开头。
TOC 是 Table of Contents 的简写。目录结构会自动更新
简书不支持目录显示。

@[toc]

效果如下

快速上手

【集锦】Markdown 语法快速上手

少数派 的文章排版比较规范，大家可以多逛逛

【参考：Markdown 编写规范 - 简书】
【参考：技术文档写作规范 - 简书】

【参考：Markdown 语法手册 （完整整理版）_兔清风的博客-CSDN博客】

超链接

【参考：Markdown 语法手册 （完整整理版）_兔清风的博客-CSDN博客】

行内式：[title](url)
[exaple](http://example.com/)

自动链接:
<http://example.com/>
<address@example.com>

exaple
http://example.com/
address@example.com

段首缩进 换行

【参考：Markdown 设置段首缩进 换行 - 简书】

换行：
方法1: 连续两个以上空格+回车
方法2：键入 html 语言换行标签：<br> 推荐

段首缩进：
使用特殊占位符，不同占位符所占空白是不一样大的。

  or    表示一个半角的空格
  or    表示一个全角的空格
    两个全角的空格（用的比较多）
  or    不断行的空白格

表格

【参考：Markdown 插入表格 - 简书】

语法说明：

第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行；
列于列之间用管道符 | 隔开。原生方式的表格每一行的两边也要有管道符；
第二行还可以为不同的列指定对齐方向。默认为左对齐，可以使用冒号 : 来定义表格的对齐方式。冒号在分隔符 - 右边右对齐，在两边居中。

简单方式写表格：
代码：

学号|姓名|分数
-|:-:|-:
小明|男|75
小红|女|79
小陆|男|92

效果如下

学号	姓名	分数
小明	男	75
小红	女	79
小陆	男	92

原生方式写表格：

|学号|姓名|分数|
|-|-|-|
|小明|男|75|
|小红|女|79|
|小陆|男|92|

学号	姓名	分数
小明	男	75
小红	女	79
小陆	男	92

字体颜色大小及文字底色

【参考：【Markdown语法】字体颜色大小及文字底色设置_Ω snow的博客-CSDN博客】

更改字体、颜色、大小

1、Markdown语法

Size：规定文本的尺寸大小，取值从 1 到 7 ，浏览器默认值是 3.

<font face="黑体">黑体字</font>
<font face="微软雅黑">微软雅黑</font>
<font face="STCAIYUN">华文彩云</font>
<font color=blue>蓝色</font>
<font color=#008000>绿色</font>
<font color=Red>红色</font>
<font size=5>尺寸</font>

<font face="黑体" color=green size=5>黑体，绿色，尺寸为5（任意内容）</font>

效果如下
黑体字
微软雅黑
华文彩云
蓝色
绿色
红色
尺寸

黑体，绿色，尺寸为5（任意内容）

如果不需要改变输入内容的其他属性，比如加粗，斜体等，只需<font color=颜色>内容即可。

<font color=LightSeaGreen>某一种绿色

效果如下：
某一种绿色

• 和其他搭配

最好把其他的包裹在<font></font>里面

<font color=red>**记录所有子问题的结果**</font>

记录所有子问题的结果

---

文字底色

借助 table, tr, td 等表格标签的 bgcolor 属性来实现背景色。将那一整行看作一个表格，更改整个格子的背景色（bgcolor）。

Markdown语法：

<table><tr><td bgcolor=DarkSeaGreen>这里的背景色是：DarkSeaGreen，此处输入任意想输入的内容</td></tr></table>

这里的背景色是：DarkSeaGreen，此处输入任意想输入的内容

放大加粗字体（类似于标题）

Markdown语法

<h1>想要放大的字体</h1>//h后面数字越大，字体越小
<h2>想要放大的字体</h2>
<h3>想要放大的字体</h3>
<h4>想要放大的字体</h4>
<h5>想要放大的字体</h5>

效果如下：

引用

【参考：Markdown 引用 - 简书】

多层嵌套

只要根据层次加上不同数量的 > 。

>  请问  Markdwon  怎么用？  -  小白
>>  自己看教程！  -  愤青
>>>  教程在哪？  -  小白
>>  
>>  我也不知道在哪！  -  愤青
>
>  那你回答个屁。  -  小白

效果如下

请问 Markdwon 怎么用？ - 小白

自己看教程！ - 愤青

教程在哪？ - 小白

我也不知道在哪！ - 愤青

那你回答个屁。 - 小白

其它要素

引用的区块内也可以使用其他的语法，包括标题、列表、代码区块等。

> 1.1 这是第一行列表项。
>> 2.1 这是第二行列表项。
>>> - 这是第三行列表项。
> ```c
> return 0;
> ```

效果如下

1.1 这是第一行列表项。

2.1 这是第二行列表项。

• 这是第三行列表项。

return 0;

引用中内容换行：
有时候引用的内容太长，需要分段落层次，可以使用 <br> 实现换行。

> $\underline{幽默小故事，笑死人不偿命}$<br>
我：“老板，你这清炒油麦菜是荤菜还是素菜？
老板：“当然是素菜了”<br>
我：“那这条虫是怎么回事”
老板：“呃……它也是来吃饭的。”<br>
我：“它吃饭凭什么我付钱？我又不认识它！”
老板哭着说：“它为了这顿饭，把命都丢了，你还能要求它AA制吗？”

显示效果：

$\underline{幽默小故事，笑死人不偿命}$

我：“老板，你这清炒油麦菜是荤菜还是素菜？
老板：“当然是素菜了”

我：“那这条虫是怎么回事”
老板：“呃……它也是来吃饭的。”

我：“它吃饭凭什么我付钱？我又不认识它！”
老板哭着说：“它为了这顿饭，把命都丢了，你还能要求它AA制吗？”

脚注

【参考：Markdown 添加注脚 - 简书】

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Typora[^T] 编辑器进行书写。
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^T]:NEW WAY TO READ & WRITE MARKDOWN.

使用 Markdown¹可以效率的书写文档, 直接转换成 HTML², 你可以使用 Typora³ 编辑器进行书写。

注：脚注会自动搬运到最后面，请到文章末尾查看，并且脚注后方的链接可以直接跳转回到加注的地方。

---

1. Markdown是一种纯文本标记语言 ↩︎

2. HyperText Markup Language 超文本标记语言 ↩︎

3. NEW WAY TO READ & WRITE MARKDOWN. ↩︎