如何写出结构清晰的markmap思维导图标题、列表与嵌套的6个实用技巧【免费下载链接】markmapBuild mindmaps with plain text项目地址: https://gitcode.com/gh_mirrors/ma/markmapmarkmap 是一个用纯文本写思维导图的开源工具——它会把Markdown直接可视化成可缩放、可折叠的交互式 mindmap。你只需掌握 6 个关于标题层级、列表与嵌套的实用技巧就能让 markmap 思维导图结构清晰、层次分明完全不需要拖拽画布。markmap 的核心逻辑很简单解析器只认两类结构块——标题h1~h6和列表ul/ol/li其余普通段落会被当作父节点的补充内容。源码中这组选择器定义在 packages/markmap-html-parser/src/index.ts这也是后面所有技巧的根基。技巧 1用标题划分主干一次只出现一个 H1H1 是整张图的根节点H2 是主干分支H3 是细分主题。层级越深节点越小所以建议全文只用一个 H1正文从 H2 开始# 我的项目 ## 背景 ## 目标 ## 计划如果你从 H1 直接跳到 H3解析器会先把 H2 的位置跳过结构容易乱——相关逻辑见 packages/markmap-html-parser/src/index.ts 中的标题栈处理。原则层级可以跳着省略子节点但不要跳着写父级。技巧 2标题之间不要夹普通段落markmap 中紧跟在标题后面的普通段落会成为该标题节点的内容相当于给分支加描述而不是独立分支## 目标 把思维导图做得更清晰 ### 短期目标这里把思维导图做得更清晰会挂在目标节点下短期目标才是它的子节点。想表达并列关系就用同级标题或列表不要用段落当分支否则主干会变得又长又乱。技巧 3用列表做分支缩进即嵌套列表是最灵活的分支方式。缩进一层就嵌套一层无序-和有序1.列表都支持且可以在列表项内部继续嵌套列表## 计划 - 第一阶段 - 调研 - 设计 - 第二阶段 - 开发 - 测试li内的嵌套列表会被识别为子节点规则见 packages/markmap-html-parser/src/index.ts。技巧同一段落里的列表保持统一缩进混合使用不同缩进宽度2 空格 vs 4 空格是最常见的图歪了原因。技巧 4有序列表会自动带上序号如果你的列表是1. 2. 3.这种有序列表markmap 会把序号渲染进节点文字里方便你直接引用第 3 步。这个行为在 packages/markmap-html-parser/src/index.ts 中实现还会读取start属性支持从任意数字开始。 写 SOP、步骤类导图时优先用有序列表写并列要点时用无序列表更干净。技巧 5标题 列表自由混搭先分块再列点最佳实践是标题负责大结构列表负责细节。先搭好 2~3 层标题骨架再在叶子标题下展开列表导图会像一棵清晰的树# 学习笔记 ## 第一章 ### 核心概念 - 节点 - 边 ## 第二章 - 要点一 - 要点二层级建议控制在3~4 层以内超过 5 层后横向空间爆炸可读性急剧下降。渲染侧的节点宽度、间距等参数maxWidth、spacingHorizontal定义在 packages/markmap-view/src/types.ts层次越少画面留白越舒服。技巧 6用好隐藏武器frontmatter 标题与折叠注释两个不显眼但非常好用的功能frontmatter 作为根节点文字文件开头用---包裹的 YAML 中title会自动成为整张图的根标题见 packages/markmap-lib/src/plugins/frontmatter/index.ts。配合markmap配置块还能在文件内部直接设置initialExpandLevel初始展开层级、maxWidth等做到一份文件自带一张调好参数的图。折叠注释在任意位置插入 HTML 注释!-- markmap: foldAll --全部折叠或!-- markmap: fold --折叠该分支对应实现在 packages/markmap-html-parser/src/index.ts。复选框变状态图标标题或列表项开头写- [x]/- [ ]会渲染成打勾/未打勾图标是任务清单类导图的神器见 packages/markmap-lib/src/plugins/checkbox/index.ts。速查清单 ✅想表达用 Markdown 写主干分支##同级标题细分主题更深一级标题并列细节同缩进列表嵌套子项列表下再缩进一层步骤序号有序列表1.任务状态- [x]/- [ ]给分支加描述标题紧跟一段文字最后提一句项目结构转换 Markdown 的核心库是 packages/markmap-lib/浏览器渲染由 packages/markmap-view/ 负责命令行生成 HTML 用 packages/markmap-cli/。掌握了以上 6 个技巧你写的任何 Markdown 文档都能一键变成一张结构清晰的 markmap 思维导图。【免费下载链接】markmapBuild mindmaps with plain text项目地址: https://gitcode.com/gh_mirrors/ma/markmap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考