用途：在首次发布文档目录、向已发布目录新增文件、Confluence 渲染效果差或从其他系统迁移文档时，把 Markdown 整理成 Confluence 期望的格式。
主要能力：目录级检查会要求每个含 Markdown 的目录有 INDEX.md，并规定其 frontmatter、简介、properties-report 指令及用 confluence ignore 块包裹子页表格；统一文件命名（小写连字符、无空格下划线、无版本号），建议扁平化嵌套。文件级检查会补全 YAML frontmatter（title、date、author、confluence_labels、confluence_properties 等），删除正文中重复的内联元数据，修正标题层级（正文用 ## 作顶层），为 3 个以上章节添加 TOC 并包裹 confluence:toc 指令，添加交叉引用与修订历史表。内容格式上替换原始 HTML、<br>、过深列表等。图表方面，默认 kroki 策略会把 mermaid、plantuml、graphviz、d2 等渲染为 PNG，并自动修复部分问题；也可用 markdown-macro 或 code-block 策略。
使用方式：先判断处理单文件还是目录，再逐项检查修复；完成后建议用 orbit confluence publish <directory> --space <SPACE> --parent <PAGE_ID> --dry-run -p <profile> 预览。
限制：不删除内容，只重构和补元数据；不覆盖 confluence_page_id 或 confluence_url；保留已有 frontmatter 字段；改动尽量最小，不重写正文；大目录应用前先向用户展示变更摘要。具体收费、平台支持等信息暂未提供。