doc-to-markdown

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 文本