Markdown基础语法

目录

• Markdown语法
  • 1、Markdown标题
  • 2、Markdown段落
  • 3、Markdown字体
  • 4、Markdown分隔线
  • 5、Markdown删除线
  • 6、Markdown下划线
  • 7、Markdown脚注
  • 8、Markdown列表
  • 9、Markdown区块
    • 区块和列表的组合使用
  • 10、Markdown代码
    • 代码区块
  • 11、Markdown链接
    • 高级链接
  • 12、Markdown图片
  • 13、Markdown表格
  • 14、Markdown高级技巧
  • 15、公式
  • 16、流程图的绘制
  • 17、生成目录的方法

Markdown语法

1、Markdown标题

• 使用#表示1-6级标题，以及标题对应一个#号

2、Markdown段落

Markdown段落没有特殊的格式，直接编写文字就好，段落的换行是使用两个以上空格加回车

3、Markdown字体

Markdown可以使用一下几种字体

*斜体文本（号）

_斜体文本_（_号）

**粗体文本（号）

_粗体文本_（__号）

字体可以相互组合

4、Markdown分隔线

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

***
* * * 
*****
- - - 
-----
___
_ _ _

5、Markdown删除线

如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线即可

~~baidu.com~~

6、Markdown下划线

下划线可以通过HTML的标签实现

<u>带下划线文本

7、Markdown脚注

脚注是对文本的补充说明

Markdown脚注的格式

8、Markdown列表

Markdown支持有序列表和无序列表

无序列表使用（*）、（+）或（-）作为列表的标记，这些标记后面要加一个空格

• 第一项
• 第二项
• 第三项
  • 3.1
  • 3.2

有序列表使用数字并加上（.）表示

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

列表嵌套

列表嵌套只需要在子列表中的选项前面添加四个空格（tab）即可

1. 第一项
   1. 第一项的第一个元素
   2. 第一项的第二个元素
2. 第二项

9、Markdown区块

Markdown区块引用是在段落开头使用>符号，后面紧跟一个空格符号

区块的引用

这是区块

区块是为了让文字显得更加突出

另外区块是可以嵌套的,一个>符号代表最外层，两个>符号是第一层嵌套，以此类推

最外层

第一层嵌套

第二层嵌套

区块和列表的组合使用

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

列表中使用区块

• 第一项

  • 这是区块

    在列表中使用区块

• 第二项

10、Markdown代码

如果是段落上的一个函数或片段的代码可以用反引号把它包裹起来

print('hello world')python

代码区块

使用```包裹一段代码，并指定一种语言（也可以不指定）

import requests

resp = requests.get(url='https://www.baidu.com')
resp.enconding = 'utf-8'
print(resp.text)

11、Markdown链接

链接使用方法

[链接名称](链接地址)

或者

<链接地址>

这是一个链接百度一下

直接使用链接地址https://www.baidu.com

高级链接

我们可以通过变量来设置一个链接，变量赋值在文档末尾进行

这个链接用1作为网站变量[Google][1]

然后在文档的末尾为变量赋值(网址)[1]:https://www.googole.com "可选标题"

例如

Runoob

12、Markdown图片

Markdown图片语法格式如下


开头一个叹号!接着一个方括号，里面放上图片代替文字接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的'title'属性的文字

Markdown还没有指定图片的高度与宽度，如果你需要的话，你可以使用普通的标签

13、Markdown表格

Markdown制作表格使用|来分隔不同单元格使用（-）来分隔表头和其他行

语法格式如下

|表头|表头|

|------|------|

|单元格|单元格|

对齐方式

我们可以设置表格的对齐方式

• -: 设置内容和标题栏居左对齐
• :- 设置内容和标题栏居右对齐
• :-: 设置内容和标题栏居中对齐

左对齐	右对齐	居中对齐
单元格	单元格	单元格

14、Markdown高级技巧

支持HTML元素，不在Markdown涵盖范围内的标签，都可以直接在文档里面使用HTML编写

目前支持得的HTML元素有:等

转义Markdown使用了很多特殊符号则需要使用转义字符，Markdown使用（\）转义特殊字符

15、公式

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

16、流程图的绘制

• 定义元素

  • 

  • 使用示例

    ```mermaid
    	flowchat
    	st=>start: 开始
    	e=>end: 结束
    	op1=>operation: 操作1 | past
    	op2=>operation: 操作2 | current
    	op3=>operation: 操作3 | future
    	pa=>parallel: 多输出操作4 | approved
    	cond=>condition: 确认？ | rejected
    	
    	st->op1->cond
    	cond(true)->e	
    	cond(no)->op2(right)->op3->pa(path1,right)->op1
    	pa(path2,left) ->e
    	st@>op1({"stroke":"Blue"})@>cond({"stroke":"Green"})@>e({"stroke":"Red","stroke-width":6,"arrow-end":"classic-wide-long"})
    	```
    

• 定义元素的走向

  • 标志	方向
    TB、TD	top bottom - 从上到下
    BT	bottom top - 从下到上
    RL	right left - 从右到左
    LR	left right - 从左到右

    上面那张图片在这样使用

  • 使用 -> 来连接两个元素

    

  • 对于condition类型，有yes和no两个分支，cond(yes)和cond(no)

  • 每个元素可以制定分支走向，默认向下，也可以用right指向右边，如sub1(right)。

• 节点类型

  • 默认节点： A
  • 矩形节点： B[矩形]
  • 圆角矩形节点： C(圆角矩形)
  • 圆形节点： D((圆形))
  • 非对称节点： E>非对称]
  • 菱形节点： F

17、生成目录的方法

在文章开始地方输入[toc]，即可在对应位置插入目录

基本用法差不多就这些，如有遗漏，请留言！

​

​