主页 > 其他  > 

【Markdown语法简洁讲解】

【Markdown语法简洁讲解】

Markdown 语法简洁语法讲解 什么是 Markdown1. 标题2. 列表3.文本样式4. 链接与图片5. 代码6. 表格7. 分割线8. 流程图9. 数学公式10. 快捷键11. 字体、字号与颜色

什么是 Markdown

Markdown 是一种轻量级标记语言,通过简单的符号实现排版格式化,专注于内容而非样式。它被广泛用于文档编写、博客、README 文件等场景,兼容性强,可转换为 HTML、PDF 等多种格式。


1. 标题

使用 # 符号表示标题,数量代表层级(1-6 级):

# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题
2. 列表

无序列表 用 -、+ 或 * 开头:

- 苹果 - 香蕉 - 子项(缩进 2 空格)

效果如下:

苹果香蕉 子项(缩进 2 空格)

有序列表 数字 + 英文句点:

1. 第一步 2. 第二步

效果如下:

第一步第二步
3.文本样式

强调文本

粗体:**文本** 或 __文本__ 斜体:*文本* 或 _文本_ ~~删除线~~:~~文本~~ ==标记文本== > 引用文本

效果如下: 粗体:文本 或 文本

斜体:文本 或 文本

删除线:文本

标记文本

引用文本


4. 链接与图片

链接

[显示文本](链接地址 "可选标题")

效果如下:

访问百度

图片

图片: ![Alt]( img-home.csdnimg /images/20220524100510.png) 带尺寸的图片: ![Alt]( img-home.csdnimg /images/20220524100510.png =60x60) 宽度确定高度等比例的图片: ![Alt]( img-home.csdnimg /images/20220524100510.png =60x) 高度确定宽度等比例的图片: ![Alt]( img-home.csdnimg /images/20220524100510.png =x60) 居中的图片: ![Alt]( img-home.csdnimg /images/20220524100510.png#pic_center) 居中并且带尺寸的图片: ![Alt]( img-home.csdnimg /images/20220524100510.png#pic_center =60x60) 居右的图片: ![Alt]( img-home.csdnimg /images/20220524100510.png#pic_right)

图片:

带尺寸的图片:

宽度确定高度等比例的图片:

高度确定宽度等比例的图片:

居中的图片:

居中并且带尺寸的图片:

居右的图片:


5. 代码

使用三个反引号 + 语言名称(可选语法高亮):

效果如下:

def hello(): print("Markdown 真方便!")
6. 表格

用 | 分隔列,- 分隔表头与内容:

| 姓名 | 年龄 | 职业 | |--------|------|---------| | 张三 | 28 | 工程师 | | 李四 | 32 | 设计师 |

效果如下:

姓名年龄职业张三28工程师李四32设计师 7. 分割线

三个及以上 -、* 或 _:

--- *** ___

效果如下:




任务列表 - [ ] 未完成 - [x] 已完成

效果如下:

未完成

已完成


8. 流程图

插入Mermaid流程图

参考文档

graph LR A[开始] --> B(处理步骤) B --> C{判断} C -->|是| D[完成] C -->|否| B

效果如下:

#mermaid-svg-G3WgG6svFSDxva5o {font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}#mermaid-svg-G3WgG6svFSDxva5o .error-icon{fill:#552222;}#mermaid-svg-G3WgG6svFSDxva5o .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-G3WgG6svFSDxva5o .edge-thickness-normal{stroke-width:2px;}#mermaid-svg-G3WgG6svFSDxva5o .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-G3WgG6svFSDxva5o .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-G3WgG6svFSDxva5o .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-G3WgG6svFSDxva5o .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-G3WgG6svFSDxva5o .marker{fill:#333333;stroke:#333333;}#mermaid-svg-G3WgG6svFSDxva5o .marker.cross{stroke:#333333;}#mermaid-svg-G3WgG6svFSDxva5o svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-G3WgG6svFSDxva5o .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-G3WgG6svFSDxva5o .cluster-label text{fill:#333;}#mermaid-svg-G3WgG6svFSDxva5o .cluster-label span{color:#333;}#mermaid-svg-G3WgG6svFSDxva5o .label text,#mermaid-svg-G3WgG6svFSDxva5o span{fill:#333;color:#333;}#mermaid-svg-G3WgG6svFSDxva5o .node rect,#mermaid-svg-G3WgG6svFSDxva5o .node circle,#mermaid-svg-G3WgG6svFSDxva5o .node ellipse,#mermaid-svg-G3WgG6svFSDxva5o .node polygon,#mermaid-svg-G3WgG6svFSDxva5o .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-G3WgG6svFSDxva5o .node .label{text-align:center;}#mermaid-svg-G3WgG6svFSDxva5o .node.clickable{cursor:pointer;}#mermaid-svg-G3WgG6svFSDxva5o .arrowheadPath{fill:#333333;}#mermaid-svg-G3WgG6svFSDxva5o .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-G3WgG6svFSDxva5o .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-G3WgG6svFSDxva5o .edgeLabel{background-color:#e8e8e8;text-align:center;}#mermaid-svg-G3WgG6svFSDxva5o .edgeLabel rect{opacity:0.5;background-color:#e8e8e8;fill:#e8e8e8;}#mermaid-svg-G3WgG6svFSDxva5o .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-G3WgG6svFSDxva5o .cluster text{fill:#333;}#mermaid-svg-G3WgG6svFSDxva5o .cluster span{color:#333;}#mermaid-svg-G3WgG6svFSDxva5o div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-G3WgG6svFSDxva5o :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 是 否 开始 处理步骤 判断 完成

插入甘特图

参考文档

gantt dateFormat YYYY-MM-DD title Adding GANTT diagram functionality to mermaid section 现有任务 已完成 :done, des1, 2014-01-06,2014-01-08 进行中 :active, des2, 2014-01-09, 3d 计划中 : des3, after des2, 5d

效果如下:

#mermaid-svg-BsFVQNX6NL5vNrWZ {font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}#mermaid-svg-BsFVQNX6NL5vNrWZ .error-icon{fill:#552222;}#mermaid-svg-BsFVQNX6NL5vNrWZ .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-BsFVQNX6NL5vNrWZ .edge-thickness-normal{stroke-width:2px;}#mermaid-svg-BsFVQNX6NL5vNrWZ .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-BsFVQNX6NL5vNrWZ .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-BsFVQNX6NL5vNrWZ .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-BsFVQNX6NL5vNrWZ .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-BsFVQNX6NL5vNrWZ .marker{fill:#333333;stroke:#333333;}#mermaid-svg-BsFVQNX6NL5vNrWZ .marker.cross{stroke:#333333;}#mermaid-svg-BsFVQNX6NL5vNrWZ svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-BsFVQNX6NL5vNrWZ .mermaid-main-font{font-family:"trebuchet ms",verdana,arial,sans-serif;font-family:var(--mermaid-font-family);}#mermaid-svg-BsFVQNX6NL5vNrWZ .exclude-range{fill:#eeeeee;}#mermaid-svg-BsFVQNX6NL5vNrWZ .section{stroke:none;opacity:0.2;}#mermaid-svg-BsFVQNX6NL5vNrWZ .section0{fill:rgba(102, 102, 255, 0.49);}#mermaid-svg-BsFVQNX6NL5vNrWZ .section2{fill:#fff400;}#mermaid-svg-BsFVQNX6NL5vNrWZ .section1,#mermaid-svg-BsFVQNX6NL5vNrWZ .section3{fill:white;opacity:0.2;}#mermaid-svg-BsFVQNX6NL5vNrWZ .sectionTitle0{fill:#333;}#mermaid-svg-BsFVQNX6NL5vNrWZ .sectionTitle1{fill:#333;}#mermaid-svg-BsFVQNX6NL5vNrWZ .sectionTitle2{fill:#333;}#mermaid-svg-BsFVQNX6NL5vNrWZ .sectionTitle3{fill:#333;}#mermaid-svg-BsFVQNX6NL5vNrWZ .sectionTitle{text-anchor:start;font-family:'trebuchet ms',verdana,arial,sans-serif;font-family:var(--mermaid-font-family);}#mermaid-svg-BsFVQNX6NL5vNrWZ .grid .tick{stroke:lightgrey;opacity:0.8;shape-rendering:crispEdges;}#mermaid-svg-BsFVQNX6NL5vNrWZ .grid .tick text{font-family:"trebuchet ms",verdana,arial,sans-serif;fill:#333;}#mermaid-svg-BsFVQNX6NL5vNrWZ .grid path{stroke-width:0;}#mermaid-svg-BsFVQNX6NL5vNrWZ .today{fill:none;stroke:red;stroke-width:2px;}#mermaid-svg-BsFVQNX6NL5vNrWZ .task{stroke-width:2;}#mermaid-svg-BsFVQNX6NL5vNrWZ .taskText{text-anchor:middle;font-family:'trebuchet ms',verdana,arial,sans-serif;font-family:var(--mermaid-font-family);}#mermaid-svg-BsFVQNX6NL5vNrWZ .taskTextOutsideRight{fill:black;text-anchor:start;font-family:'trebuchet ms',verdana,arial,sans-serif;font-family:var(--mermaid-font-family);}#mermaid-svg-BsFVQNX6NL5vNrWZ .taskTextOutsideLeft{fill:black;text-anchor:end;}#mermaid-svg-BsFVQNX6NL5vNrWZ .task.clickable{cursor:pointer;}#mermaid-svg-BsFVQNX6NL5vNrWZ .taskText.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-BsFVQNX6NL5vNrWZ .taskTextOutsideLeft.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-BsFVQNX6NL5vNrWZ .taskTextOutsideRight.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-BsFVQNX6NL5vNrWZ .taskText0,#mermaid-svg-BsFVQNX6NL5vNrWZ .taskText1,#mermaid-svg-BsFVQNX6NL5vNrWZ .taskText2,#mermaid-svg-BsFVQNX6NL5vNrWZ .taskText3{fill:white;}#mermaid-svg-BsFVQNX6NL5vNrWZ .task0,#mermaid-svg-BsFVQNX6NL5vNrWZ .task1,#mermaid-svg-BsFVQNX6NL5vNrWZ .task2,#mermaid-svg-BsFVQNX6NL5vNrWZ .task3{fill:#8a90dd;stroke:#534fbc;}#mermaid-svg-BsFVQNX6NL5vNrWZ .taskTextOutside0,#mermaid-svg-BsFVQNX6NL5vNrWZ .taskTextOutside2{fill:black;}#mermaid-svg-BsFVQNX6NL5vNrWZ .taskTextOutside1,#mermaid-svg-BsFVQNX6NL5vNrWZ .taskTextOutside3{fill:black;}#mermaid-svg-BsFVQNX6NL5vNrWZ .active0,#mermaid-svg-BsFVQNX6NL5vNrWZ .active1,#mermaid-svg-BsFVQNX6NL5vNrWZ .active2,#mermaid-svg-BsFVQNX6NL5vNrWZ .active3{fill:#bfc7ff;stroke:#534fbc;}#mermaid-svg-BsFVQNX6NL5vNrWZ .activeText0,#mermaid-svg-BsFVQNX6NL5vNrWZ .activeText1,#mermaid-svg-BsFVQNX6NL5vNrWZ .activeText2,#mermaid-svg-BsFVQNX6NL5vNrWZ .activeText3{fill:black!important;}#mermaid-svg-BsFVQNX6NL5vNrWZ .done0,#mermaid-svg-BsFVQNX6NL5vNrWZ .done1,#mermaid-svg-BsFVQNX6NL5vNrWZ .done2,#mermaid-svg-BsFVQNX6NL5vNrWZ .done3{stroke:grey;fill:lightgrey;stroke-width:2;}#mermaid-svg-BsFVQNX6NL5vNrWZ .doneText0,#mermaid-svg-BsFVQNX6NL5vNrWZ .doneText1,#mermaid-svg-BsFVQNX6NL5vNrWZ .doneText2,#mermaid-svg-BsFVQNX6NL5vNrWZ .doneText3{fill:black!important;}#mermaid-svg-BsFVQNX6NL5vNrWZ .crit0,#mermaid-svg-BsFVQNX6NL5vNrWZ .crit1,#mermaid-svg-BsFVQNX6NL5vNrWZ .crit2,#mermaid-svg-BsFVQNX6NL5vNrWZ .crit3{stroke:#ff8888;fill:red;stroke-width:2;}#mermaid-svg-BsFVQNX6NL5vNrWZ .activeCrit0,#mermaid-svg-BsFVQNX6NL5vNrWZ .activeCrit1,#mermaid-svg-BsFVQNX6NL5vNrWZ .activeCrit2,#mermaid-svg-BsFVQNX6NL5vNrWZ .activeCrit3{stroke:#ff8888;fill:#bfc7ff;stroke-width:2;}#mermaid-svg-BsFVQNX6NL5vNrWZ .doneCrit0,#mermaid-svg-BsFVQNX6NL5vNrWZ .doneCrit1,#mermaid-svg-BsFVQNX6NL5vNrWZ .doneCrit2,#mermaid-svg-BsFVQNX6NL5vNrWZ .doneCrit3{stroke:#ff8888;fill:lightgrey;stroke-width:2;cursor:pointer;shape-rendering:crispEdges;}#mermaid-svg-BsFVQNX6NL5vNrWZ .milestone{transform:rotate(45deg) scale(0.8,0.8);}#mermaid-svg-BsFVQNX6NL5vNrWZ .milestoneText{font-style:italic;}#mermaid-svg-BsFVQNX6NL5vNrWZ .doneCritText0,#mermaid-svg-BsFVQNX6NL5vNrWZ .doneCritText1,#mermaid-svg-BsFVQNX6NL5vNrWZ .doneCritText2,#mermaid-svg-BsFVQNX6NL5vNrWZ .doneCritText3{fill:black!important;}#mermaid-svg-BsFVQNX6NL5vNrWZ .activeCritText0,#mermaid-svg-BsFVQNX6NL5vNrWZ .activeCritText1,#mermaid-svg-BsFVQNX6NL5vNrWZ .activeCritText2,#mermaid-svg-BsFVQNX6NL5vNrWZ .activeCritText3{fill:black!important;}#mermaid-svg-BsFVQNX6NL5vNrWZ .titleText{text-anchor:middle;font-size:18px;fill:#333;font-family:'trebuchet ms',verdana,arial,sans-serif;font-family:var(--mermaid-font-family);}#mermaid-svg-BsFVQNX6NL5vNrWZ :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 2014-01-06 2014-01-07 2014-01-08 2014-01-09 2014-01-10 2014-01-11 2014-01-12 2014-01-13 2014-01-14 2014-01-15 2014-01-16 2014-01-17 已完成 进行中 计划中 现有任务 Adding GANTT diagram functionality to mermaid

插入UML图

参考文档

sequenceDiagram 张三 ->> 李四: 你好!李四, 最近怎么样? 李四–>>王五: 你最近怎么样,王五? 李四–x 张三: 我很好,谢谢! 李四-x 王五: 我很好,谢谢! Note right of 王五: 李四想了很长时间, 文字太长了不适合放在一行. 李四–>>张三: 打量着王五… 张三->>王五: 很好… 王五, 你怎么样?

效果如下:

#mermaid-svg-VZvLtSieSnMmyPUe {font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}#mermaid-svg-VZvLtSieSnMmyPUe .error-icon{fill:#552222;}#mermaid-svg-VZvLtSieSnMmyPUe .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-VZvLtSieSnMmyPUe .edge-thickness-normal{stroke-width:2px;}#mermaid-svg-VZvLtSieSnMmyPUe .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-VZvLtSieSnMmyPUe .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-VZvLtSieSnMmyPUe .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-VZvLtSieSnMmyPUe .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-VZvLtSieSnMmyPUe .marker{fill:#333333;stroke:#333333;}#mermaid-svg-VZvLtSieSnMmyPUe .marker.cross{stroke:#333333;}#mermaid-svg-VZvLtSieSnMmyPUe svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-VZvLtSieSnMmyPUe .actor{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-VZvLtSieSnMmyPUe text.actor>tspan{fill:black;stroke:none;}#mermaid-svg-VZvLtSieSnMmyPUe .actor-line{stroke:grey;}#mermaid-svg-VZvLtSieSnMmyPUe .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#333;}#mermaid-svg-VZvLtSieSnMmyPUe .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#333;}#mermaid-svg-VZvLtSieSnMmyPUe #arrowhead path{fill:#333;stroke:#333;}#mermaid-svg-VZvLtSieSnMmyPUe .sequenceNumber{fill:white;}#mermaid-svg-VZvLtSieSnMmyPUe #sequencenumber{fill:#333;}#mermaid-svg-VZvLtSieSnMmyPUe #crosshead path{fill:#333;stroke:#333;}#mermaid-svg-VZvLtSieSnMmyPUe .messageText{fill:#333;stroke:#333;}#mermaid-svg-VZvLtSieSnMmyPUe .labelBox{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-VZvLtSieSnMmyPUe .labelText,#mermaid-svg-VZvLtSieSnMmyPUe .labelText>tspan{fill:black;stroke:none;}#mermaid-svg-VZvLtSieSnMmyPUe .loopText,#mermaid-svg-VZvLtSieSnMmyPUe .loopText>tspan{fill:black;stroke:none;}#mermaid-svg-VZvLtSieSnMmyPUe .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-VZvLtSieSnMmyPUe .note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-svg-VZvLtSieSnMmyPUe .noteText,#mermaid-svg-VZvLtSieSnMmyPUe .noteText>tspan{fill:black;stroke:none;}#mermaid-svg-VZvLtSieSnMmyPUe .activation0{fill:#f4f4f4;stroke:#666;}#mermaid-svg-VZvLtSieSnMmyPUe .activation1{fill:#f4f4f4;stroke:#666;}#mermaid-svg-VZvLtSieSnMmyPUe .activation2{fill:#f4f4f4;stroke:#666;}#mermaid-svg-VZvLtSieSnMmyPUe .actorPopupMenu{position:absolute;}#mermaid-svg-VZvLtSieSnMmyPUe .actorPopupMenuPanel{position:absolute;fill:#ECECFF;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#mermaid-svg-VZvLtSieSnMmyPUe .actor-man line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-VZvLtSieSnMmyPUe .actor-man circle,#mermaid-svg-VZvLtSieSnMmyPUe line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;stroke-width:2px;}#mermaid-svg-VZvLtSieSnMmyPUe :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 张三 李四 王五 你好!李四, 最近怎么样? 你最近怎么样,王五? 我很好,谢谢! 我很好,谢谢! 李四想了很长时间, 文字太长了 不适合放在一行. 打量着王五... 很好... 王五, 你怎么样? 张三 李四 王五
9. 数学公式

参考文档

Gamma公式展示 Γ ( n ) = ( n − 1 ) ! ∀ n ∈ N \Gamma(n) = (n-1)!\quad\forall n\in\mathbb N Γ(n)=(n−1)!∀n∈N 是通过 Euler integral

\Gamma(z) = \int_0^\infty t{z-1}e{-t}dt,

效果如下: Gamma公式展示 Γ ( n ) = ( n − 1 ) ! ∀ n ∈ N \Gamma(n) = (n-1)!\quad\forall n\in\mathbb N Γ(n)=(n−1)!∀n∈N 是通过 Euler integral

Γ ( z ) = ∫ 0 ∞ t z − 1 e − t d t   . \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. Γ(z)=∫0∞​tz−1e−tdt.


10. 快捷键 功能快捷键加粗Ctrl + B斜体Ctrl + I引用Ctrl + Q插入链接Ctrl + L插入代码Ctrl + K插入图片Ctrl + G提升标题Ctrl + H有序列表Ctrl + O无序列表Ctrl + U横线Ctrl + R撤销Ctrl + Z重做Ctrl + Y
11. 字体、字号与颜色

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过类似HTML的标记语法,它可以使普通文本内容具有一定的格式。但是它本身是不支持修改字体、字号与颜色等功能的!

<font face="黑体">我是黑体字</font> <font face="微软雅黑">我是微软雅黑</font> <font face="STCAIYUN">我是华文彩云</font> Size:规定文本的尺寸大小。可能的值:从 1 到 7 的数字。浏览器默认值是 3。

我是黑体字 我是微软雅黑 我是华文彩云 Size:规定文本的尺寸大小。可能的值:从 1 到 7 的数字。浏览器默认值是 3。

HTML 颜色参考网站

标签:

【Markdown语法简洁讲解】由讯客互联其他栏目发布,感谢您对讯客互联的认可,以及对我们原创作品以及文章的青睐,非常欢迎各位朋友分享到个人网站或者朋友圈,但转载请说明文章出处“【Markdown语法简洁讲解】