Anydocs Documents
CLI 命令

import - 导入旧文档

把历史 Markdown 或 MDX 内容导入到 Anydocs 项目。

`import` 负责把旧文档放入暂存区,不直接变成 canonical 页面。标准流程是先导入,再根据 importId 执行 `convert-import`。

Steps

  1. 把旧文档目录导入暂存区
  2. 检查暂存结果
  3. 继续执行 convert-import
  4. 在 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`。