Markdown语法

说明:记录markdown语法。建议读者在页面使用Ctrl+F查找需要的markdown语法


段落

换行

段落的换行是使用两个以上空格加上回车

缩进字符

在缩进文字前添加    4个中的一个,即可缩进一个字符
如:
 缩进一个字符
 缩进
缩进

使用注意:

  1. 输入时要带上分号“;”
  2. 切换至英文状态输入
  3. 可两两混用

字体

Markdown 可以使用以下几种字体:

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本

上下标

输入上标,如:x2,则输入 x^2^ ; $2^{7}$

输入下标,如:x0,则输入 x~0~

题注


题注
题注

题注

脚注

脚注是对文本的补充说明。

脚注的格式:[^要注明的文本]

脚注的用法:

创建脚注格式类似这样 [^ps]。
[^ps]: what_how_why!!!

创建脚注格式类似这样 1

超链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式

行内式超链接:

[](地址)
[行内式链接名称](链接地址https://www.baidu.com/ "可选择性地接标题内容,可以用单引号``、双引号""或是括弧包()着,地址后需有空格,鼠标指向图片时会显示标题")
[行内式链接名称](相对文件路径../about/master/ 如果是要链接到同样主机的资源,可以使用相对路径)

简书-行内式链接

参考式超链接:

[] [1]

[1]:地址
[参考式链接名称][id链接辨识标签的名称-用以辨识参考链接的标记]`  
 `空白行`  
 `[id链接辨识标签]:链接地址https:www.baidu.com/或<https:www.baidu.com> 有时候 www.baidu.com也可以"选择性地接的标题内容,可以用单引号、双引号或是括弧包着"

参考式链接名称

参考式链接中,选择性接的标题内容"可以放到下一行,也可以缩进。 隐式链接标记功能让你可以省略指定链接标记,这种情形下,链接标记会视为等同于链接名称

两个[]之间可以选择性地加入空格
[id链接辨识标签]在至少一个空白行后任意位置将该标记的内容链接定义出来即可
[id链接辨识标签]方括号前可选择性地加入至多3个空格用于缩进
[id链接辨识标签]:在冒号:后可加入一个以上的空格或制表符Tab
:链接地址 后接的 "选择性接的标题内容,可以用单引号、双引号或是括弧包着"可以放到下一行,也可以缩进"

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址,只要是用尖括号<>包起来, Markdown 就会自动把它转成链接

  1. <http://www.baidu.com >

<http://www.baidu.com >

http://www.baidu.com

  1. [链接文字](链接网址)

百度

划线

  分隔线

分割线的语法只需要三个或三个以上的星号*减号-下划线_

行内不能有其他东西,可以在星号*减号-下划线_中间插入空格

***
* * *
******
---
- - - 





  删除线

只需要在文字的两端加上两个波浪线 ~~即可

~~删除线~~

  删除线

下划线

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

<u>带下划线文本</u>

  带下划线文本

区块


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

> 区块引用

区块引用

区块嵌套

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

> 最外层
> > 第一层嵌套
> > > 第二层嵌套

最外层

第一层嵌套

第二层嵌套

只要根据层次加上不同数量的 >
如果未用空白行分分隔,引用层级会自动延续上一行,
使用少于或省略的引用标记符合>均不影响该引用层级

只要根据层次加上不同数量的 >> 在嵌套引用时如果未用空白行分隔,引用层级会自动延续上一行,使用少于或省略的引用标记符合>均不影响该引用层级。但是最好在每行的最前面加上 >

区块中使用列表

> 区块中使用列表
> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项

区块中使用列表

  1. 第一项
  2. 第二项
  • 第一项
  • 第二项
  • 第三项

列表中使用区块

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

区块中使用列表实例如下:

* 第一项
    > what
    > how_why
* 第二项
  • 第一项

    what
    how_why

  • 第二项

表格


| Tables | Are | Cool |
|:-----| :--------: |  ------:|
| 靠左对齐 | 居中对齐 | 靠右对齐 |
| 书写时 | 原始文字 | 可以不用对整齐 |
|*斜体* | **加粗** | `渲染效果` |
TablesAreCool
靠左对齐居中对齐靠右对齐
书写时原始文字可以不用对整齐
斜体加粗渲染效果

冒号: 在第二行中不同的位置表示对齐方式,在无冒号:的情况下默认靠左对齐
标题元件(表头)至少需要3个—来分隔
最外面的竖线|可以省略,书写的时候也可以不必需让原始的文字对得很整齐

列表

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

  无序列表使用星号(*)加号(+)或是减号(-)作为列表标记,这些标记后面要添加一个空格,然后再填写内容:

* 第一行
+ 第二行
- 第三行
  • 第一行
  • 第二行
  • 第三行

  有序列表使用数字并加上 .号来表示,如:

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

列表嵌套

  列表嵌套只需在父列表中的符号后添加一个Tab键

1. 第一项:
   1. 第一项嵌套的第一个元素
   2. 第一项嵌套的第二个元素
2. 第二项:
   1. 第二项嵌套的第一个元素
   2. 第二项嵌套的第二个元素
  1. 第一项:
    1. 第一项嵌套的第一个元素
    2. 第一项嵌套的第二个元素
  2. 第二项:
    1. 第二项嵌套的第一个元素
    2. 第二项嵌套的第二个元素

  注意:不同的编辑器有不同列表效果

代码

https://www.runoob.com/markdown/md-code.html

图片

https://www.runoob.com/markdown/md-image.html

高级技巧

https://www.runoob.com/markdown/md-advance.html

画图

1、横向流程图

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

2、竖向流程图

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

3、标准流程图

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

4、标准流程图(横向)

​```mermaid
flowchat
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
​```
Created with Raphaël 2.3.0 开始框 处理框 判断框(是或否?) 输入输出框 结束框 子流程 yes no

5、UML时序图

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

6、UML标准时序图

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

  1. what_how_why!!! ↩︎

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值