如何从Markdown入门到精通，避免吃土？

Markdown学习，从入门到吃土 前言：为什么选择 Markdown？ 以前大家都喜欢使用word来进行文档编辑，然而在新时代，word的一些特性导致其在一些情景并没有那么好用。 作为富文本范式的WORD，编辑起来固然较为方便，然而，正是他的便捷性和可视化，导致他在迁移或编辑时有较大的局限性，尤其对于LLM来说，如果直接将word文件上传给LLM，会存在两个较大的问题，一是由于富文本隐藏的样式定义会使用户消耗比文本量多许多的token，二是读取过程可能导致格式错乱，进而出现逻辑错误，而作为一种轻量级标记语言的Markdown，其作为一种纯文本类型的语言，很好的解决了word的弊端，同时使用熟练后，效率可能比使用word还高。 当然，随着进一步人工智能的进一步发展，或许能够让LLM对于word的解析能力得到提高，但是在一段时间内，markdown依然是人们的一个良好的选择，这篇文章就让我来介绍一下markdown语言的基本用法 一、基础语法 1. 标题（Headings） 使用 # 符号表示标题，数量代表层级（1-6级）： # 一级标题（H1） ## 二级标题（H2） ### 三级标题（H3） #### 四级标题（H4） ##### 五级标题（H5） ###### 六级标题（H6） 渲染效果： 一级标题 二级标题 三级标题 注意：一级标题通常用于文章标题，文档内建议从二级标题开始使用，保持层级清晰，同时，如果你想写标题，那么最后一个#后面需要加空格如示例展示的一样，否则不会被识别为标题。 2. 段落与换行 段落：空行分隔即可 这是第一段。 这是第二段，与上文有空行分隔。 换行：行尾添加两个空格 + 回车 这是第一行·· 这是第二行（··代表两个空格） 3. 强调样式 样式 语法 示例 效果 粗体 **文字** 或 __文字__ **重要** 重要 斜体 *文字* 或 _文字_ *强调* 强调 删除线 ~~文字~~ ~~过时~~ 过时 粗斜体 ***文字*** ***关键*** 关键 注意：中文与强调符号间建议加空格，如 ** 重要 **，避免某些解析器识别失败。 4. 列表 无序列表 使用 -、+ 或 * 作为标记（建议统一使用 -）： - 苹果 - 香蕉 - 进口香蕉（缩进2空格） - 国产香蕉 - 橙子 效果： 苹果 香蕉 进口香蕉 国产香蕉 橙子 有序列表 使用数字加句点： 1. 第一步：准备工作 2. 第二步：执行操作 1. 子步骤 A（缩进3空格） 2. 子步骤 B 3. 第三步：检查结果 效果： 第一步：准备工作 第二步：执行操作 子步骤 A 子步骤 B 第三步：检查结果 技巧：数字不必连续，渲染时会自动排序（都写 1. 也可以）。 5. 链接与图片 链接 [链接文字](URL "可选标题") 示例： 访问 [Markdown 指南](https://markdown.com.cn "官方文档") 效果：访问 Markdown 指南 图片  示例：  效果： 引用式链接（适合长文档） [链接文字][id] 文末定义： [id]: URL "标题" 6. 引用块 使用 > 符号： > 这是一段引用文字。 > 可以跨越多行。 > > > 嵌套引用（多加一个 >） 效果： 这是一段引用文字。 可以跨越多行。 嵌套引用 7. 代码 行内代码 使用反引号 ` 包裹： 使用 `printf()` 函数输出 效果：使用 printf() 函数输出 代码块 使用三个反引号 ``` 包裹，并指定语言以获得语法高亮： ```python def hello(): print("Hello, Markdown!") ``` 效果： def hello(): print("Hello, Markdown!") 8. 分隔线 三种写法均可： --- *** ___ 效果均为一条水平分隔线： 9. 表格 使用 | 和 - 构建： | 姓名 | 年龄 | 城市 | | :--- | :---: | ---: | <!-- 左对齐 | 居中 | 右对齐 --> | 张三 | 25 | 北京 | | 李四 | 30 | 上海 | 效果： 姓名 年龄 城市 1张三 25 北京1 11李四 30 上海11 注意： 中间不添加内容只有-的放在表头下方，每一列的-的数量要在3个以上，同时可以通过在标题行中的连字符的左侧，右侧或两侧添加冒号（:），将列中的文本对齐到左侧，右侧或中心。如示例中所示 二、进阶技巧 1. 任务列表（GFM 扩展） - [x] 已完成任务 - [ ] 未完成任务 - [x] 子任务 A - [ ] 子任务 B 效果： 已完成任务 未完成任务 子任务 A 子任务 B 2. 脚注 这是一个需要脚注的句子[^1]。 [^1]: 这是脚注内容，会显示在文档底部。 3. 数学公式（LaTeX） 行内公式：$E=mc^2$ 渲染效果：\(E=mc^2\) 块级公式： $$ \sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n $$ 渲染效果： \[\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n \] 4. 折叠内容（HTML5 标签） <details> <summary>点击展开详情</summary> 这里是隐藏的内容，支持 Markdown 语法。 - 列表项 1 - 列表项 2 </details> 5. 与 HTML 混用 当 Markdown 无法满足需求时，可直接使用 HTML： <div align="center"> <img src ="https://ts3.tc.mm.bing.net/th/id/OIP-C.F3WG1F4go_JJ84hZ7xdvHAHaEK" width="200"> <p><b>这是谁</b></p> </div> <span style="color:red">红色文字</span> 效果： 这是谁 红色文字 三、实用工具推荐 工具类型 推荐工具 特点 编辑器 Typora 所见即所得，实时预览 编辑器 VS Code 插件丰富，适合技术写作 在线工具 墨滴编辑器 无需安装，即开即用 转换工具 Pandoc 支持 PDF/Word/EPUB 导出 图床 GitHub + jsDelivr 免费稳定，适合博客 四、写作建议 统一风格：选定一种列表符号（建议 -）和标题层级规范 善用空行：段落间留空行，提高源码可读性 图片本地化：重要图片建议本地备份，防止外链失效 版本控制：使用 Git 管理 Markdown 文档，追踪修改历史 预览习惯：写作时开启实时预览，及时发现格式问题 结语 Markdown 的精髓在于用最小的标记成本，实现最大的排版效果。掌握这十几个基础符号，你就能在任何支持 Markdown 的平台上，以纯文本的方式创作出结构清晰、格式优美的文档。 当然，word作为称霸多年的文本编辑器，仍有他的独到之处，其集成了一些较为复杂的功能，实际使用时还是按照自己的需求来，不过学习多一点总是好的。