# Docs Extensions Inline

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

- Skill: `xbotics-embodied-ai-club/docs-extensions-inline` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xbotics-embodied-ai-club/docs-extensions-inline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xbotics-embodied-ai-club/docs-extensions-inline/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: xbotics-embodied-ai-club (https://skillmd.com/u/xbotics-embodied-ai-club)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xbotics-embodied-ai-club/docs-extensions-inline

---


# 延伸与参考并入正文

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

---

## 一、适用场景

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

---

## 二、执行前必做：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 末 |

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

---

## 四、正文内格式

每条在正文中的写法（与现有项目一致）：

```markdown
- **延伸**：[链接显示文本](相对路径或锚点)（简短说明；可选 [笔记/索引](路径)）
```

- 保留原链接的 `[...](...)` 及可选子链接（如笔记、索引、摘要）。
- 相对路径以当前 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](../../docs/1-embodied-overview/1.3-世界模型综述.md)。可打开该文件查看「**延伸**：」在各小节末的分布方式及链接格式。