Markdown语法全攻略：从基础到高级

Markdown是一种轻量级的标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成结构化的HTML（超文本标记语言）文档。Markdown的语法简洁明了，易于学习，因此被广泛用于博客、笔记、文档撰写、论坛等场景。 ### 1. 标题 Markdown使用`#`符号来创建不同级别的标题。一级标题使用一个`#`，二级标题使用两个`#`，以此类推，直到六级标题，使用六个`#`。注意，七级标题在Markdown中不被支持。 ### 2. 正文 Markdown的正文非常简单，直接输入文字即可。没有特殊格式时，Markdown会将连续的文本视为一个段落。 ### 3. 换行 在Markdown中，如果想在一行之后换行而不是开始新段落，可以在一行末尾加上两个或以上空格，然后按回车键。 ### 4. 代码和代码块 代码可以通过在代码前后各加上一个反引号（`）来实现单行代码的引用。若要创建代码块，可以使用四个空格或一个Tab键加空格来缩进，或者使用围栏式代码块，即使用三个反引号（```）包裹代码，可选择性地指定代码的编程语言以实现语法高亮。 ### 5. 行中代码 在正文中插入行内代码，可以使用双反引号（``）将代码包围，例如`#include "asdasd"`。 ### 6. 列表 Markdown支持有序和无序列表。有序列表使用数字加句点（.）后跟空格，无序列表使用减号（-）或星号（*）后跟空格。列表可以嵌套，通过增加缩进来实现。 ### 7. 加粗和倾斜 使用一对星号（**）包围文本进行加粗，如**加粗**；使用一对下划线（_）包围文本进行倾斜，如_倾斜_。同时使用星号和下划线（***）可以实现斜体加粗的效果，如***斜体加粗***。 ### 8. 段落 连续的文本被视为一个段落，没有特殊标记的情况下，Markdown会自动处理段落间距。 ### 9. 引用 在行首添加一个大于号（>）表示引用，如： > 这是一段引用 ### 10. 分割线 可以使用三个或以上连字符（-）或等号（=）来创建水平分割线，用于分隔内容。 ### 11. 链接 Markdown中链接由方括号和圆括号组成，例如：[文本](URL)。 ### 12. 图片 插入图片使用感叹号、方括号和圆括号，例如：。 ### 13. 表格 Markdown的表格语法相对复杂，通常使用竖线（|）定义列，破折号（-）定义表头和数据行的分隔，例如： ``` | 列1 | 列2 | 列3 | | --- | --- | --- | | 数据1 | 数据2 | 数据3 | ``` ### 14. 脚注 Markdown支持脚注，使用`[^1]`创建脚注标记，然后在文档末尾定义脚注内容，例如： ``` 这是有脚注的文本[^1] [^1]: 这是脚注的内容。 ``` ### 15. 复选框 Markdown结合HTML可以实现复选框功能，例如： ```html - [ ] 未完成的任务 - [x] 已完成的任务 ``` ### 16. Mermaid超级绘图工具 Mermaid是一个JavaScript库，可以用于在Markdown中绘制流程图、饼状图、子图等。通过在Markdown中使用特定的Mermaid语法，可以自动生成可视化图表。 ### 17. 流程图 流程图的Mermaid语法示例： ```mermaid graph TD; A[开始] --> B{条件判断}; B -- 是 --> C[操作]; B -- 否 --> D[结束]; ``` ### 18. 饼状图 饼状图的Mermaid语法示例： ```mermaid pie title 饼状图示例 "部分1" : 35 "部分2" : 25 "部分3" : 40 ``` ### 19. 子图 Mermaid支持在图表中嵌套子图，方便组织复杂的图形结构。 Markdown语法的灵活性和简洁性使得它成为文档编写和分享的首选工具，无论是简单的文本格式化还是复杂的图表绘制，Markdown都能轻松应对。学习并熟练掌握Markdown，能极大地提高编写和阅读文档的效率。