MarkDown基本常用语法

时间：2025-03-27 08:59:04

markdown基本语法

    • 一、目录
      • 标题Setext方式
  • 大标题
    • 小标题
      • 标题：Atx方式
  • 一级标题
    • 二级标题
      • 三级标题
        • 四级标题
          • 五级标题
            • 六级标题
    • 二、段落缩进（空格）
    • 三、格式
      • 1. 字体、字号、颜色
      • 2.分割线
      • 3. 删除线
      • 4. 下划线
      • 5.脚注
    • 四、列表
      • 1. 无序列表
      • 2. 有序列表
      • 3. 嵌套列表
    • 五、区块引用
    • 六、代码
      • 行内代码
      • 段落代码
    • 七、链接
      • 1.文字超链：Inline方式
      • 2. 高级链接- 索引超链：Reference方式
      • 3. 图片超链
      • 4. 自动链接
    • 八、表格
    • 九、其他
      • 1.注释
      • 2.转义字符
    • 十、高级
      • 1. 键符、上标字、下标字
      • 2. 公式
      • 3.流程图
      • 4.标准流程图
      • 5. UML时序图
      • 6.甘特图样例：

本文是对于markdown语法的基础学习，用于日常基本使用足矣，代码块内为markdown代码，下面是代码的响应效果。欢迎各位点赞关注！互相学习！

一、目录

@[TOC](文章标题名)
一级目录 #+空格
二级目录 ##+空格
三级目录 ###+空格
......

标题Setext方式

三个或更多

大标题
===
小标题
---

大标题

小标题

标题：Atx方式

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题

二级标题

三级标题

四级标题
五级标题
六级标题

二、段落缩进（空格）

半个字符大的空白 或 看，飞碟
全字符大的空白 或 看，飞碟
不断行的空白格 或 看，飞碟
  段落从此开始。

如下：
 半个字符大的空白 或 看，飞碟
 全字符大的空白 或 看，飞碟
 不断行的空白格 或 看，飞碟
   段落从此开始。

三、格式

星号与下划线都可以，单是斜体，双是粗体，符号可跨行，符号可加空格

1. 字体、字号、颜色

斜体    _+内容+_

粗体    __+内容+__

粗斜体  ___+内容+___

如：
 斜体
 粗体
 粗斜体

<font face="黑体">我是黑体字</font>
<font face="微软雅黑">我是微软雅黑</font>
<font face="STCAIYUN">我是华文彩云</font>
<font color=#0099ff size=12 face="黑体">黑体</font>
<font color=#00ffff size=3>null</font>
<font color=gray size=5>gray</font>

如下：
  我是黑体字
  我是微软雅黑
  我是华文彩云
  黑体
  null
  gray

2.分割线

三个或更多-_*，必须单独一行，可含空格

	---
	***
	___

3. 删除线

内容前后~~

~~我是删除线~~

我是删除线

4. 下划线

<u>我是下划线</u>

我是下划线

5.脚注

创建脚注[^脚注]
[^脚注]:脚注文本

创建1脚注2

四、列表

1. 无序列表

无序列表 *或-或+加上空格

* 无序列表1
* 无序列表2
  • 无序列表1
  • 无序列表2

2. 有序列表

有序列表 数字+.+空格

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

3. 嵌套列表

1.  第一项
*  第一项子项
* 第一项子项
2. 第二项
* 第二项子项
	* 第二项子项的子项
  1. 第一项
  • 第一项子项
  • 第一项子项
  1. 第二项
  • 第二项子项
    • 第二项子项的子项

五、区块引用

">"加空格,可省略
内层符号前的空格必须要

>引用
 >>引用的引用
  >>>引用的引用的引用

引用

引用的引用

引用的引用的引用

六、代码

键+代码

2.反引号（`）包起来/三个反引号加语言名

行内代码

  1. 反引号（`）包起来
`val s = "hello Markdown"
println( s )`

val s = "hello Markdown" println( s )

  1. 三个反引号加语言名
```java
public static void main() ```


public static void main()

段落代码

每行文字前加4个空格或者1个Tab

    val s = "hello Markdown"
    println( s )
    val s = "hello Markdown"
    println( s )

val s = "hello Markdown"
println( s )
val s = "hello Markdown"
println( s )

七、链接

1.文字超链：Inline方式

[文字](链接地址 "提示内容")
如：
[A-Itfuture](/weixin_43431218?spm=1011.2124.3001.5343 "A-itfuture的博客")

A-Itfuture

2. 高级链接- 索引超链：Reference方式

设置变量

这是 [百度][1]的地址
空行
[1]:

这是 百度的地址

3. 图片超链

多个感叹号，Tooltips可省略，要设置大小只能借助HTML标记

![风景图](/images/search?view=detailV2&ccid=A6TpC4oo&  
id=18E0F0DCC4093907CF8FCA6D75617F54A0D "风景图" size="15px")

[由于在线图片盗链机制故不作展示]

4. 自动链接

尖括号

<>

八、表格

| 分隔单元格 - - -分隔表头和其他行
对齐方式
  -：右对齐
  :-左对齐
  :—: 居中

| 表头一 | 表头二 | 表头三 |
| :--- | :---: | ---: |
| 1号|2号|3号|
| 1号|2号|3号|
表头一 表头二 表头三
1号 2号 3号
1号 2号 3号

或者

项目     | 价格
-------- | ---
Computer | $1600
Phone    | $12
Pipe     | $1
项目 价格
Computer $1600
Phone $12
Pipe $1

九、其他

1.注释

用html的注释，好像只有这样？

<!-- 注释 -->

2.转义字符

用html的注释，好像只有这样？

Markdown中的转义字符为\，转义的有：

\\ 反斜杠

\` 反引号

\* 星号

\_ 下划线

\{\} 大括号

\[\] 中括号

\(\) 小括号

\# 井号

\+ 加号

\- 减号

\. 英文句号

\! 感叹号

\ 反斜杠

` 反引号

* 星号

_ 下划线

{} 大括号

[] 中括号

() 小括号

# 井号

+ 加号

- 减号

. 英文句号

! 感叹号

十、高级

支持 html元素标签

1. 键符、上标字、下标字

kbd： 使用<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>重启电脑
sup:   <sup>saa</sup>       sub:      <sub>ss</sub> 
br:   <br>
hr:   <hr>

kbd： 使用Ctrl+Alt+Del重启电脑
sup: saa sub: ss
br:

2. 公式

两个$

$$
a*c=b
\sum_p\pi(t)
$$

a ∗ c = b ∑ p π ( t ) a*c=b \sum_p\pi(t) a∗c=bp∑​π(t)

3.流程图

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

```mermaid
graph TD
A[fang]-->B(yaun)
B-->c{tiaojian }
c-->|a=1|D[jie1]
c-->|a=0|E(jie2)```
a=1
a=0
方形
圆角
条件
结果1
结果2
横向流程图
a=1
a=0
fang
yaun
tiaojian
jie1
jie2
竖向流程图

4.标准流程图

```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

横向标准流程：

 ```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 标题：复杂使用

UML时序图源码复杂样例：

```mermaid
sequenceDiagram
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: 没人陪我玩```
对象A 对象B 小三 C 对象B你好吗?（请求） 对象B的描述 对象A的描述(提示) 我很好(响应) 你好吗 对象B找我了 你真的好吗？ 我们是朋友 没人陪我玩 对象A 对象B 小三 C 标题：复杂使用

6.甘特图样例：

```mermaid
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```
Mon 06 Mon 13 Mon 20 需求 原型 UI设计 未来任务 学习准备理解需求 设计框架 开发 未来任务 耍 功能测试 压力测试 测试报告 设计 开发 测试 软件开发甘特图

未经作者许可，不允许转发。联系QQ:1756865612

  1. 创建的脚注内容 ↩︎

  2. 脚注的脚注文本 ↩︎

相关文章