docs-extensions-inline

star 919

将 MD 文档文末的「延伸与参考」等链接块按主题分散到正文相关小节末尾,文末不再保留独立块。适用于 docs 及项目中任意 Markdown 文件。当用户希望把延伸链接放入正文、或对某篇文档做「延伸与参考并入正文」时使用。

Xbotics-Embodied-AI-club By Xbotics-Embodied-AI-club schedule Updated 2/24/2026

name: docs-extensions-inline description: 将 MD 文档文末的「延伸与参考」等链接块按主题分散到正文相关小节末尾,文末不再保留独立块。适用于 docs 及项目中任意 Markdown 文件。当用户希望把延伸链接放入正文、或对某篇文档做「延伸与参考并入正文」时使用。

延伸与参考并入正文

将文档末尾的延伸与参考(或类似名称的链接列表)按主题分散到正文对应小节末尾,删除文末独立块,使读者在相关段落即可看到延伸链接。


一、适用场景

  • 文档末尾有「### 延伸与参考」「### 延伸阅读」「### 参考」等独立小节,下列多条链接。
  • 用户希望这些链接放入正文,即分布到各相关小节末,而非集中在文末。

二、执行前必做:Plan 阶段

  1. 读取目标 MD 全文,定位文末「延伸与参考」块(或等价标题)。
  2. 列出每条链接:序号、链接文本/主题、目标文件或锚点。
  3. 为每条选定目标位置:正文中与主题最相关的小节末尾(见下「放置原则」)。
  4. 确认:共 N 条,分别放入小节 A 末、B 末……;文末块整块删除。

只有在 Plan 中明确「每条 → 哪一小节」后再执行分散与删除。


三、放置原则

链接主题类型 建议目标位置 示例
世界模型/评估/概念 核心问题或概念小节末 1.3.1 核心问题与主要贡献
视频生成 / VAM / 预测未来 视频生成或预测未来小节末 1.3.6.1 视频生成世界模型
机器人 / VLA / 灵巧操作 / 人-物交互 机器人或操作小节末 1.3.7.2 机器人
产业/公司/商业化 应用场景节末或对应领域小节末 1.3.7 三大应用场景末、或 1.3.7.2 末

同一小节末可放多条延伸;若某节已有「延伸:」行,在其后追加,保持格式一致。


四、正文内格式

每条在正文中的写法(与现有项目一致):

- **延伸**:[链接显示文本](相对路径或锚点)(简短说明;可选 [笔记/索引](路径))
  • 保留原链接的 [...](...) 及可选子链接(如笔记、索引、摘要)。
  • 相对路径以当前 MD 所在目录为基准(如 ../../files/source/xxx.md)。

五、实施步骤

  1. 按 Plan:对每条链接在目标小节末插入一行「延伸:……」。
  2. 删除文末块:删除从「### 延伸与参考」(或等价标题)到该块内最后一条之间的全部内容。
  3. 保留文末导航:若文档末尾有「返回目录」「返回主 README」等导航,保留不动。
  4. 检查:确认每条链接在正文中只出现一次、路径有效、无重复或遗漏。

六、可复用到其他文档

  • docs/ 下任意 .md(如 1.4-运控综述.md、5.1-VLA.md):若存在文末延伸块,同样先 Plan(每条→哪一节),再分散、删块。
  • 文件名与路径:不同文档层级不同,相对路径需按该文档相对 docs/ 或项目根计算;插入位置为该文档内的小节标题或段落末。

七、参考示例

已按本流程处理的文档:docs/1-embodied-overview/1.3-世界模型综述.md。可打开该文件查看「延伸:」在各小节末的分布方式及链接格式。

Install via CLI
npx skills add https://github.com/Xbotics-Embodied-AI-club/Xbotics-Embodied-Guide --skill docs-extensions-inline
Repository Details
star Stars 919
call_split Forks 75
navigation Branch main
article Path SKILL.md
Occupations
More from Creator
Xbotics-Embodied-AI-club
Xbotics-Embodied-AI-club Explore all skills →