markdown 文档语法

1、标题

#空格
    在想要设置为标题的文字前面加#来表示
    一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。
    标准语法一般在#后跟个空格再写文字
    <center></center>标签可以让文字居中
    一级二级标题也可使用如下，标题下使用一串=号-号分别为一级二级标题
    这是一级标题
    =================
    这是二级标题
    -----------------

2、字体

1.斜体italic：* 或 _
	在文字左右分别用一个*号包起来
2.粗体bold：** 或 __
	在文字左右分别用两个**号包起来
3.斜体加粗：***
	在文字左右分别用三个***号包起来
4.删除线Strikethrough：~~
	在文字左右分别用两个~~号包起来
5.高亮：==
	在文字左右分别用两个==号包起来
6.下划线: <u></u>
	下划线可以通过 HTML 的 <u> 标签来实现

3、分割线

---或***
	三个或者三个以上的 - 或者 * 都可以
	在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。
	也可以在星号或是减号中间插入空格

4、段落

段落的换行是使用两个以上空格加上回车
也可以在段落后面使用一个空行来表示重新开始一个段落

5、区块(引用)

>空格	
	区块引用是在段落开头使用 > 符号 ，然后后面紧跟一个空格符号
	在引用的文字前加>即可。引用也可以嵌套，如加两个>>三个>>>
	如下：
	> 最外层
    > > 第一层嵌套
    > > > 第二层嵌套
    > 区块中使用列表
    > > 1. 第一项
    > > 2. 第二项
    > >    + 第一项
    > >    + 第二项
    > >    + 第三项

区块中使用列表

第一项

第二项

第一项

第二项

第三项

列表中使用区块
如果要在列表项目内放进区块，那么就需要在 > 前添加四个空格的缩进。

第一项
item
item

>     item
第二项
item

5、脚注

[^要注明的文本]
	示例
	后面的hello是需要脚注的内容[^hello]
	[^hello]: 对hello的脚注

对 ^[1]使用脚注

7、图片

![名称](地址 "title")
	title可有可无
	也可使用变量，语法：[名称][变量]
	指定图片的高度与宽度，如果你需要的话，你可以使用普通的 <img> 标签
	<img src="http://static.runoob.com/images/runoob-logo.png" width="50%">

8、链接

[名称](地址 "title")
	title可有可无
	或者不写名称，语法：<地址>
	可使用html的a标签代替
	<a href="地址" target="_blank">名称</a>
高级链接，可以通过变量来设置一个链接，变量赋值在文档末尾进行
	语法：
	[名称][变量]
	如：
	[百度][baidu]
	在文档的结尾为变量赋值：
	[baidu]: http://www.baidu.com

9、列表

1.无序：- + *
	无序列表用 - + * 任何一种都可以
	使用一个- + *加空格加内容
2.有序：数字.空格内容
	数字点'.'空格加内容
3.列表嵌套：上一级和下一级之间敲两或四个空格即可，无序有序可相互嵌套
    如：
    - 一级无序列表内容
       - 二级无序列表内容
       - 二级无序列表内容
       - 二级无序列表内容
       
    一级无序列表内容
        1. 二级有序列表内容
        2.二级有序列表内容
        3. 二级有序列表内容

10、表格

使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行， - 使用一个以上
如：

表头	表头	表头
内容	内容	内容
内容	内容	内容

	第二行分割表头和内容，- 有一个就行，为了对齐，多加了几个
    :- 设置内容和标题栏居左对齐（默认方式）。
    -: 设置内容和标题栏居右对齐。
    :-: 设置内容和标题栏居中对齐。
    注：原生的语法两边都要用 | 包起来。此处省略

11、代码块

单行代码Inline：代码之间分别用一个反引号包起来
代码块Block：代码之间分别用三个反引号包起来，且两边的反引号单独占一行
代码缩进Indented: 4个空格
	代码区块使用 4 个空格或者一个制表符（Tab 键）
    // Some comments
    line 1 of code
    line 2 of code
    line 3 of code
使用三个反引号包裹，可指定语言如java，js，shell，py等等，写在头三个反引号后

12、流程图

st=>start: 开始
op=>operation: My Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op

横向流程图

graph LR A[方形] -->B(圆角) B --> C{条件a} C -->|a=1| D[结果1] C -->|a=2| E[结果2] F[横向流程图]

竖向流程图

graph TD A[方形] --> B(圆角) B --> C{条件a} C --> |a=1| D[结果1] C --> |a=2| E[结果2] F[竖向流程图]

标准流程图

st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st->op->cond
cond(yes)->io->e
cond(no)->sub1(right)->op

标准流程图（横向）

st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st(right)->op(right)->cond
cond(yes)->io(bottom)->e
cond(no)->sub1(right)->op

UML时序图

对象A->对象B: 对象B你好吗?（请求）
Note right of 对象B: 对象B的描述
Note left of 对象A: 对象A的描述(提示)
对象B-->对象A: 我很好(响应)
对象A->对象B: 你真的好吗？

UML时序图(复杂)

Title: 标题：复杂使用
对象A->对象B: 对象B你好吗?（请求）
Note right of 对象B: 对象B的描述
Note left of 对象A: 对象A的描述(提示)
对象B-->对象A: 我很好(响应)
对象B->小三: 你好吗
小三-->>对象A: 对象B找我了
对象A->对象B: 你真的好吗？
Note over 小三,对象B: 我们是朋友
participant C
Note right of C: 没人陪我玩

UML标准时序图

%% 时序图例子,-> 直线，-->虚线，->>实线箭头 sequenceDiagram participant 张三 participant 李四张三->王五: 王五你好吗？ loop 健康检查王五->王五: 与疾病战斗 end Note right of 王五: 合理食物 <br/>看医生... 李四-->>张三: 很好! 王五->李四: 你怎么样? 李四-->王五: 很好!

甘特图

%% 语法示例 gantt dateFormat YYYY-MM-DD title 软件开发甘特图 section 设计需求 :done, des1, 2014-01-06,2014-01-08 原型 :active, des2, 2014-01-09, 3d UI设计 : des3, after des2, 5d 未来任务 : des4, after des3, 5d section 开发学习准备理解需求 :crit, done, 2014-01-06,24h 设计框架 :crit, done, after des2, 2d 开发 :crit, active, 3d 未来任务 :crit, 5d 耍 :2d section 测试功能测试 :active, a1, after des3, 3d 压力测试 :after a1 , 20h 测试报告 : 48h

13、高级

HTML 元素

html标签，都可以直接在文档里面用 HTML 撰写

目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等

如：
使用 Ctrl+Alt+Del 重启电脑

转义

Markdown 使用了很多特殊符号来表示特定的意义，如果需要显示特定的符号则需要使用转义字符，Markdown 使用反斜杠转义特殊字符
如：

**文本加粗** 
\*\* 正常显示星号 \*\*

文本加粗
** 正常显示星号 **
不建议转义，建议使用代码块

公式

当你需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后，问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如：

$$
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \
\end{vmatrix}
${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$

对hello的脚注 ↩︎

原文地址：https://www.cnblogs.com/ttaolu/p/15236186.html

markdown 笔记