Markdown 语法完全指南：一篇学完全部语法

目录一. 前言二. Markdown 标题语法三. Markdown 段落语法四. Markdown 换行语法五. Markdown 强调语法六. Markdown 引用语法七. Markdown 列表语法无序列表有序列表八. Markdown 代码语法九. Markdown 分隔线语法十. Markdown 链接语法十一. Markdown 图片语法十二. Markdown 转义字符语法十三. Markdown 内嵌 HTML 标签十四. Markdown 图表语法总结一. 前言Markdown 是一种轻量级标记语言由约翰·格鲁伯John Gruber于2004年创建。它允许人们使用易读易写的纯文本格式编写文档然后转换成有效的HTML文档。Markdown 语法简洁明了学习成本低已成为程序员、作家、博客作者等广泛使用的文档编写工具。二. Markdown 标题语法标题用于创建文档的结构层次Markdown 支持两种标题语法语法示例效果说明# 一级标题# 这是H1这是H1使用1-6个#号表示1-6级标题## 二级标题## 这是H2这是H2#号后需加一个空格### 三级标题### 这是H3这是H3最多支持六级标题#### 四级标题#### 这是H4这是H4##### 五级标题##### 这是H5这是H5###### 六级标题###### 这是H6这是H6标题1\n标题1\n标题1另一种语法仅支持一级和二级标题2\n-----标题2\n-----标题2用等号或减号下划线表示注意大多数Markdown解析器要求#号后必须有一个空格。三. Markdown 段落语法段落是Markdown文档的基本单位语法示例效果说明直接书写文本这是一个段落。这是一个段落。段落之间用空行分隔空行分隔第一段。\n\n第二段。第一段。第二段。两个段落之间需要空一行行尾两个空格行1 \n行2行1行2行尾加两个空格实现强制换行最佳实践保持段落简洁每段3-5句话为宜使用空行提高可读性。四. Markdown 换行语法换行控制文本的换行方式语法示例效果说明行尾两个空格第一行 \n第二行第一行第二行最常用的换行方式HTML标签第一行br第二行第一行第二行使用HTML的标签段落分隔第一行\n\n第二行第一行第二行创建新段落而非简单换行五. Markdown 强调语法强调用于突出显示文本中的重要内容语法示例效果说明*斜体**这是斜体*这是斜体使用单个星号或下划线_斜体__这也是斜体_这也是斜体效果相同**粗体****这是粗体**这是粗体使用两个星号或下划线__粗体____这也是粗体__这也是粗体效果相同***粗斜体******粗斜体文本***粗斜体文本三个星号或下划线___粗斜体______这也是粗斜体___这也是粗斜体效果相同~~删除线~~~~删除的文本~~删除的文本使用两个波浪线六. Markdown 引用语法引用用于标注引用的内容或创建注释块语法示例效果说明 引用内容 这是一段引用这是一段引用基本引用语法多级引用 一级\n 二级嵌套引用效果使用多个号创建嵌套引用中其他语法 **加粗引用**引用中可包含其他格式引用内支持所有Markdown语法七. Markdown 列表语法列表用于创建有序或无序的项目列表无序列表语法示例效果说明* 项目* 苹果\n* 香蕉• 苹果• 香蕉使用星号- 项目- 苹果\n- 香蕉- 苹果- 香蕉使用减号推荐 项目 苹果\n 香蕉 苹果 香蕉使用加号嵌套列表- 水果\n - 苹果\n - 香蕉嵌套列表效果缩进两个空格创建子列表有序列表语法示例效果说明1. 项目1. 第一步\n2. 第二步1. 第一步2. 第二步数字后加点和空格自动编号1. 第一步\n1. 第二步1. 第一步2. 第二步数字可重复会自动排序嵌套有序列表1. 步骤\n 1. 子步骤嵌套有序列表缩进创建子列表八. Markdown 代码语法代码语法用于显示代码片段或内联代码语法示例效果说明内联代码console.log()console.log()单个反引号包裹内联代码代码块js\nconsole.log()\n代码块显示三个反引号创建代码块缩进代码块缩进4个空格或1个制表符代码块效果传统方式不推荐语法高亮python\ndef hello():\n print(“Hello”)\n带高亮的代码指定语言名称常用语言标识javascript、python、java、html、css、sql、bash等。九. Markdown 分隔线语法分隔线用于在文档中创建视觉分隔语法示例效果说明*********三个星号------—三个减号常用_________三个下划线前后空行上文\n\n---\n\n下文正确显示分隔线分隔线前后需要空行注意分隔线符号至少三个且符号之间可以有空格* * *。十. Markdown 链接语法链接用于创建超链接语法示例效果说明[文本](URL)[百度](https://baidu.com)百度基本链接语法[文本](URL 标题)[百度](https://baidu.com 百度首页)带标题的链接鼠标悬停显示标题引用式链接[百度][1]\n[1]: https://baidu.com引用式链接便于管理多个链接自动链接https://baidu.comhttps://baidu.com尖括号包裹URL邮件链接exampleemail.comexampleemail.com自动创建邮件链接十一. Markdown 图片语法图片语法用于插入图像语法示例效果说明显示图片基本图片语法带标题的图片鼠标悬停显示标题引用式图片![Logo][logo]\n[logo]: logo.png引用式图片类似引用式链接带链接的图片[](full.png)可点击的图片图片嵌套在链接中最佳实践始终提供有意义的替代文本便于无障碍访问和SEO。十二. Markdown 转义字符语法转义字符用于显示Markdown中的特殊符号语法示例效果说明\*\*不是斜体\*不是斜体转义星号\_\_不是斜体\_不是斜体转义下划线不是代码不是代码转义反引号\[\[不是链接\][不是链接]转义方括号\(\(不是链接\)(不是链接)转义括号\#\#不是标题#不是标题转义井号\\不是列表不是列表转义加号\-\-不是列表-不是列表转义减号\.1\.不是列表1.不是列表转义点号十三. Markdown 内嵌 HTML 标签Markdown 支持直接使用HTML标签扩展格式功能HTML标签示例效果说明br第一行br第二行强制换行换行标签hrhr水平线分隔线标签supXsup2/supX2上标subHsub2/subOH2O下标kbdkbdCtrlC/kbdCtrlC键盘按键markmark高亮文本/mark高亮文本高亮文本detailsdetailssummary详情/summary内容/details可折叠内容折叠面板tableHTML表格语法复杂表格Markdown表格功能有限时使用注意在HTML标签内的内容Markdown语法将不会被解析。十四. Markdown 图表语法Markdown 本身不直接支持图表绘制但可以通过扩展语法或嵌入外部代码块来创建图表语法/工具示例效果说明Mermaidmermaidgraph TDA[开始] -- B[处理]B -- C[结束]生成流程图使用三个反引号包裹标注语言为mermaidPlantUMLplantumlstartumlAlice - Bob: 请求Bob -- Alice: 响应enduml生成UML图需要支持PlantUML的渲染器Graphvizdotdigraph G {A - BB - C}生成关系图使用DOT语言描述图结构LaTeX 数学公式$E mc^2$或$$ \sum_{i1}^n i \frac{n(n1)}{2} $$数学公式行内公式用单块级公式用双 块级公式用双块级公式用双表格扩展使用HTMLtable标签复杂表格Markdown基础表格功能有限时可使用HTML注意图表功能需要渲染器支持如GitHub、Typora、VS Code插件等并非所有Markdown解析器都支持。总结Markdown 语法简洁而强大通过上述表格可以快速掌握各种语法元素的使用方法。实际写作时建议保持一致性选择一种风格并坚持使用适当使用空格提高可读性善用代码块展示代码时使用语法高亮添加图片替代文本提高可访问性预览效果写作过程中经常预览最终效果随着实践的增加这些语法将成为您的第二本能让文档编写变得更加高效和愉快。