Markdown 完全指南

https://appstore.lazycat.cloud/#/shop/detail/chestnut.app.obsidian Markdown 是一种轻量级的标记语言，广泛应用于编写文档、博客、README 文件等。由于其简单的语法和良好的可读性，Markdown 已成为技术人员和写作者常用的文档撰写工具之一。本教程将介绍 Markdown 的常用语法、进阶用法及各种扩展功能，帮助你快速掌握这项技能。 ## 1. 标题 Markdown 使用 `#` 符号表示标题，`#` 的数量决定标题的级别，从一级标题到六级标题不等。 ``` # 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题 ``` ## 2. 段落与换行直接输入文字即为段落，段落之间需要空行隔开。行内换行需要在行尾加两个空格。 ``` 这是第一段。这是第二段。这是同一段中的新行。 ``` ## 3. 强调 Markdown 支持文本加粗、斜体及同时加粗斜体。 ``` _斜体_ **加粗** **_加粗并斜体_** ``` 效果： _斜体_ **加粗** **\*加粗并斜体\*** ## 4. 引用使用 `>` 符号可以创建引用块，并且可以嵌套。 ``` > 这是一个引用。 > > > 这是嵌套引用。 ``` ## 5. 列表 #### 无序列表无序列表使用 `-`、`+` 或 `*` 作为列表标记。 ``` - 项目一 - 项目二 - 子项目 ``` 效果： - 项目一 - 项目二 - 子项目 #### 有序列表有序列表使用数字加 `.` 来表示。 ``` 1. 项目一 2. 项目二 1. 子项目 ``` 效果： 1. 项目一 2. 项目二 1. 子项目 ## 6. 链接与图片使用 `[文本](URL "文本")` 语法创建超链接，使用 `![图片描述](图片地址)` 插入图片。 ``` [Google](https://www.google.com "Google") ![Markdown Logo](https://markdown-here.com/img/icon256.png) ``` ## 7. 代码块行内代码使用反引号 ````，多行代码使用三个反引号包围，并且可以指定代码语言以启用语法高亮。 ``` def hello_world(): print("Hello, World!") ``` ## 8. 表格使用 `|` 和 `-` 创建表格，并通过 `:` 控制对齐方式。 ``` | 名字 | 年龄 | 性别 | | :--- | :--: | ---: | | 张三 | 25 | 男 | | 李四 | 30 | 女 | ``` 效果： | 名字 | 年龄 | 性别 | | :--- | :--: | ---: | | 张三 | 25 | 男 | | 李四 | 30 | 女 | ## 9. 水平分割线使用 `---`、`***` 或 `___` 创建分割线。 ``` --- ``` 效果： --- ## 10. 转义字符使用反斜杠 `\` 来转义 Markdown 特殊符号。 ``` \*这是不被解析的星号\* ``` 效果： _这是不被解析的星号_ ## 11. 注脚 Markdown 支持注脚功能，通过 `[^注脚]` 来实现，注脚内容放在文档底部。 ``` 这是一个带注脚的例子[^1]。 [^1]: 这是注脚的内容。 ``` 效果：这是一个带注脚的例子^1。 ## 12. 任务列表 Markdown 中可以创建任务列表，常用于跟踪任务状态。 ``` - [ ] 未完成任务 - [x] 已完成任务 ``` ## 13. 内部链接（锚点链接）可以通过 `#` 创建文档内部的跳转链接，常用于创建目录或快速导航。 ``` [跳转到高级用法](#高阶用法 "跳转到高级用法") ``` ## 14. LaTeX 公式 Markdown 支持 LaTeX 数学公式，可以通过 `$` 或 `$$` 来包围公式内容。 ```latex 这是行内公式：$E=mc^2$ 这是块级公式： $$ \sum_{i=1}^n a_i^2 $$ ``` 效果：这是行内公式：这是块级公式： $$ \sum_{i=1}^n a_i^2 $$ ## 15. Mermaid 流程图借助 Mermaid，可以在 Markdown 中创建流程图或时序图等可视化内容。 ```` /Users/xu/Library/Containers/com.tencent.xinWeChat/Data/Documents/xwechat_files/wxid_neghhff72jo721_cb5c/temp/InputTemp/b699a258-8d44-4dbb-8c7c-ea70f37fa743.png```mermaid graph TD; A-->B; A-->C; B-->D; C-->D; ``` ```` ![b699a258-8d44-4dbb-8c7c-ea70f37fa743](https://raw.githubusercontent.com/cloudsmithy/picgo-imh/master/b699a258-8d44-4dbb-8c7c-ea70f37fa743.png) ## 16. 折叠内容使用 `` 和 `` 标签来实现可折叠的内容。 ``` 点击展开这是隐藏的内容。 ``` 效果：点击展开这是隐藏的内容。 ## 结语 Markdown 的简洁、灵活和易读性，使其成为撰写文档的首选工具。通过本教程，你不仅能掌握 Markdown 的基本语法，还能利用其高级功能扩展文档的可读性和功能性。无论是编写博客、项目文档，还是生成结构复杂的技术手册，Markdown 都能够帮助你轻松完成任务。希望本教程对你有所帮助，助你在文档编写中更高效地应用 Markdown。