iwe extract与inline重构教程：一键拆分合并章节，所有引用链接自动修正

人工智能Agent 记忆MCP 服务CLI知识管理开发工具【免费下载链接】iweMarkdown knowledge graph — LSP for your editor, CLI MCP memory for your AI agents项目地址https://gitcode.com/gh_mirrors/iw/iwe点击查看免费下载 还在手动复制粘贴拆分长篇 Markdown 笔记吗IWE 是一款面向个人知识图谱的开源工具Markdown 知识图谱 LSP 编辑器插件 CLI MCP 记忆系统它的iwe extract与iwe inline命令可以让你一键把章节拆分成独立文档或把引用文档合并回正文——更妙的是拆分和合并过程中所有引用链接都会自动修正不用你手动改一个链接。本文用 5 分钟带你走完这两个命令的完整工作流哪怕你刚接触 IWE 也能直接上手。一、痛点长文档越改越长目录越来越乱 用 Markdown 记笔记的人都会遇到这个问题一篇《项目指南》写到 2000 行子章节内容互相纠缠改一处要翻半天想把配置说明拆出去单独维护复制粘贴后要手动维护两个文件还要保证两边引用不失效项目收尾了又想把拆出去的内容合并回主文档同样是一堆手工活。IWE 的解法很聪明它的 extract 操作 把拆变成一条命令inline 操作 把合也变成一条命令而中间的链接维护工作全部由工具自动完成。二、先搞懂一个概念包含链接Inclusion Link extract 拆分后原位置会留下一个独占一行的 Markdown 链接IWE 称之为包含链接Inclusion Link。比如# 项目指南 配置说明这条链接既是占位符也是知识图谱中的一条结构边——它让文档之间形成可导航的层级而不用依赖文件夹组织。这是 IWE 知识图谱的核心机制详见 inclusion-links.md。IWE 内部把每篇 Markdown 文档解析成二叉树结构节section就是树上的节点拆分/合并本质上就是对这棵树的搬枝操作 图注IWE 内部把 Markdown 文档建模为二叉树Document as binary-tree这也是它能精准修正引用的底层原因。三、iwe extract三步拆出一篇新文档 ✂️完整参数说明见 cli-extract.md核心流程只有三步第 1 步列出可拆分的章节iwe extract my-document --list # 输出 # 1: Introduction # 2: Getting Started # 3: Configuration第 2 步按标题或序号提取二选一# 按标题提取不区分大小写、支持部分匹配 iwe extract my-document --section Configuration # 按序号提取最不容易出错 iwe extract my-document --block 3第 3 步验证结果原文档中该章节被替换为包含链接Configuration新文件configuration.md自动生成且标题层级自动降级修正源文档的 H2 变成新文档的 H1目录结构会保留在原文档同级目录下。几个贴心的细节先预览后动手加--dry-run可预览所有变更而不写盘键名冲突自动避让configuration.md已存在时自动改名为configuration-1.md永远不会覆盖旧文件️新文件命名可定制默认用标题的 slug如configuration可通过 config.toml 中的key_template换成日期、随机 ID、父文档前缀等模板完整变量清单见 feature-extract.md编辑器内同样支持命令与 LSP 代码操作共用同一套提取逻辑在 VS Code、Neovim、Zed 等编辑器里也能触发同样的拆分章节动作。四、iwe inline把引用文档合并回正文 inline 是 extract 的逆操作完整参数见 cli-inline.md。查看文档中所有包含链接iwe inline my-document --list # 1: Introduction # 2: Getting Started执行合并# 按引用目标合并 iwe inline my-document --reference getting-started合并后包含链接被完整内容替换# My Document ## Getting Started Content from the getting started document...三个关键行为值得注意行为说明默认删除源文档内容已并入正文原getting-started.md会被删除保持工作区清爽--keep-target想保留原文档例如多处引用就加这个参数--as-quote以引用块形式嵌入适合嵌入他人材料、引用摘录五、亮点所有引用链接自动修正 ️这是整套机制里最让人安心的部分也是很多人手写拆分脚本时最头疼的坑。拆分时新文件生成后源文档的位置自动写入正确的包含链接路径、键名全部由 IWE 生成不存在拆完链接就断的情况。合并时假设getting-started.md被其他 2 篇文档引用目标文档内容并入正文删除目标文档全库扫描把其他文档里指向它的引用一并清理或转成纯文本不会出现任何指向已删除文件的死链。官方文档用一句话概括了这个清理范围When deleting the target, all other references to it are cleaned up见 cli-inline.md。合并前建议先用--dry-run预览波及面iwe inline my-document --reference getting-started --dry-run # Would inline Getting Started into my-document # Would delete getting-started # Would update 2 additional document(s)六、一键脚本与实用组合 两个命令都支持-f keys输出受影响的文档键方便写进脚本批量操作# 批量拆分先列出章节再逐段提取 iwe extract large-document --section Introduction iwe extract large-document --section Implementation iwe extract large-document --section Testing # 批量合并把索引页的所有引用逐个 inline 回去 iwe inline comprehensive-guide --reference intro iwe inline comprehensive-guide --reference setup iwe inline comprehensive-guide --reference usage推荐的心智模型 内容还在演化、要被多处引用 →extract 拆出去让每篇文档保持精简 内容已稳定、要出成完整交付物 →inline 合并回来一键得到自包含文档。拆了又合、合了再拆都可以反复进行因为链接维护始终是自动的——这就是重构两个字的意义你只管组织结构脏活 IWE 全包。七、更多资料 资料说明cli-extract.mdextract 命令完整参数与错误处理cli-inline.mdinline 命令完整参数与目标文档处理feature-extract.md提取动作配置与 key_template 模板变量全表feature-inline.mdinline 动作配置section / quote 两种模式inclusion-links.md包含链接设计原理多父级层级与知识导航data-model.mdIWE 数据模型理解链接自动修正的底层机制现在就可以试一下挑一篇你最长的笔记--list看看它有哪些章节--dry-run预览一次拆分然后放心地按回车。✅赞分享人工智能Agent 记忆MCP 服务CLI知识管理开发工具【免费下载链接】iweMarkdown knowledge graph — LSP for your editor, CLI MCP memory for your AI agents项目地址https://gitcode.com/gh_mirrors/iw/iwe点击查看免费下载相关推荐Webtoon漫画批量下载完整教程一键保存所有章节的终极方案Webtoon漫画批量下载完整教程一键保存所有章节的终极方案 想要永久收藏喜爱的Webtoon漫画作品吗Webtoon Downloader是一个专业的Py终极指南如何用Grbl_Esp32打造你的专属CNC控制器——从入门到精通终极指南如何用Grbl_Esp32打造你的专属CNC控制器——从入门到精通 Grbl_Esp32是一款基于ESP32平台的高性能数控控制器固件它完美移植区块链前端认证鉴权python-mini-projects 之 Merge CSV files用 pandas 一键合并目录内所有 CSV 文件python mini projects 之 Merge CSV files用 pandas 一键合并目录内所有 CSV 文件 本文以 python mini示例工程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考