| name | doc-to-markdown |
| description | 将金山文档在线文档（智能文档 .otl、Word .docx、PDF .pdf）内容提取为 Markdown 格式输出。 当用户要求「读取文档内容」、「提取文档文本」、「导出 Markdown」、「文档转文本」时使用。 若需要写入或创建文档，请使用 create-doc 技能。 |
| homepage | null |
| version | 1.5.7 |
在线文档转 Markdown
在线文档转 Markdown 技能支持将云文档内容以 Markdown 格式提取。
本技能依赖 kdocs 技能的基础文档操作能力（认证、文件管理等），请确保已安装该技能。详见 references/core/ 目录。
操作指南
通用操作路由
| 意图 | 路由 |
|---|
| 读取文档内容 | read_file（统一入口，按后缀自动返回 Markdown 或结构化数据） |
| 创建/写入 | create_file_with_content（统一入口，新建文档并写入内容，返回 link_url） |
| 局部更新 | 改块/改段/改单元格，已有目标文档上的修改 → 按「支持的文档类型」→ 对应 reference |
| 类型专属能力 | 条件格式、导出转换、翻译、PDF 拆分、幻灯片主题、数据校验 |
| 获取文件标识指南 | 必读 references/file-locating-guide.md |
高频流程指引
文档内容转 Markdown
🎯 核心工具：read_file(format="markdown") 可将 .otl / .docx / .pdf 内容提取为 Markdown 文本。
适用类型：智能文档（.otl）、Word（.docx）、PDF（.pdf）
不适用：表格（.xlsx / .ksheet）、多维表格（.dbt）、演示文稿（.pptx）
步骤 1: 定位文档
- 用户给文件名/关键词 → search_files(keyword="文档名") 获取 file_id
- 用户给链接 → 直接提取 url 或 link_id
步骤 2: read_file(file_id=..., format="markdown") 或 read_file(url=...) / read_file(link_id=...)
→ status=ok 时取 data.content
→ status=pending 时原参数 + task_id 再次调用
步骤 3: 将 Markdown 文本直接返回给用户
⚠️ "导出为 MD 文件"：云端不支持创建 .md 后缀文件，应将 Markdown 文本直接输出给用户，由用户自行保存为本地 .md 文件。
风险控制
以下工具不可逆，调用前必须向用户确认（详细约束见各工具参考文档的「操作约束」区）：
cancel_share
工具组合速查
| 用户需求 | 推荐工具组合 |
|---|
| 将在线文档（智能文档、Word、PDF）内容转换为 Markdown 输出 | search_files → read_file(format=markdown) → 返回 Markdown 文本 |
