CLI 命令
import - 导入旧文档
把历史 Markdown 或 MDX 内容导入到 Anydocs 项目。
`import` 负责把旧文档放入暂存区,不直接变成 canonical 页面。标准流程是先导入,再根据 importId 执行 `convert-import`。
Steps
- 把旧文档目录导入暂存区
- 检查暂存结果
- 继续执行 convert-import
- 在 Studio 或 MCP 中整理后再发布
把旧文档目录导入暂存区
`import` 会读取源目录中的 `.md` 与 `.mdx` 文件,并把结果写入目标项目的 `imports/<importId>/`。
npx @anydocs/cli import ./legacy-docs ./my-docs-project zh检查暂存结果
导入完成后,先查看 `imports/<importId>/manifest.json` 与 `items/*.json`,确认语言、条目数和基础字段都合理。
继续执行 convert-import
拿到 `importId` 后,再把该批次转换为 canonical draft 页面与导航分组。
npx @anydocs/cli convert-import <importId> ./my-docs-project在 Studio 或 MCP 中整理后再发布
转换结果默认是 `draft`。在 Studio 或 MCP 中补 metadata、调整导航和正文细节,再发布需要上线的页面。
支持的输入: 当前导入流程面向 Markdown (`.md`) 与 MDX (`.mdx`) 目录,并支持按目录批量导入。
如果不是目录级迁移: 若你只是把单份 Markdown 交给 agent 转成页面,通常更适合使用 `page_create_from_markdown` 或 `page_update_from_markdown`。