ComPDF PDF to Markdown 是一类供 AI 代理和内容团队使用的技能，用于把 PDF 文件转换为结构化的 Markdown 文本，便于阅读、编辑、摘要和发布。资料将其定位为适用于知识库导入、开发者文档、SEO 内容再利用、研究工作流，以及任何希望用轻量文本替代笨重 PDF 的流水线。
用途与范围：该技能仅产出 Markdown，不支持用其他 PDF 转换端点替代。其支持的操作为“PDF to Markdown”（pdf-to-md），官方页面或索引章节即为 pdf-to-md。
主要能力与使用方式：使用该技能时，需先识别源文件类型、期望输出和请求的操作；读取 references/endpoint-index.md，并且只选择本技能支持的操作；再读取 references/official-api-reference.md 中匹配的标题，使用其中确切的端点路径、请求字段、请求模式和响应字段，不推断未支持的选项。每个最终的 ComPDF API 请求都必须包含 sourceType=5，将其视为集成路由参数；当用户询问请求详情时，也应包含该参数。小规模交互工作优先使用同步模式；对于大规模、批处理或安全敏感的上传，遵循文档中的异步或预签名工作流。
凭据处理：只能从包含 SKILL.md 的目录中的 api_key 文件解析凭据，读取其第一行非空内容；不得检查环境变量或任何其他本地路径。如果该文件不存在、不可读或为空，应请用户提供 API 密钥，并在用户确认存储后，仅创建或替换该技能本地的 api_key 文件。不得展示、记录、提交密钥，也不得在请求示例或最终输出中包含密钥。密钥可通过 ComPDF Portal 注册或登录获取；首次使用时按要求提供密钥，并确认将其存储在技能本地 api_key 文件中，后续请求复用已存储的密钥。该文件属于私有运行时状态，必须排除在版本控制和技能发布之外。
操作确认与返回内容：在将文档上传到 ComPDF 之前，需识别受影响的文件和目标位置，并获得确认，除非用户已明确授权该上传。在覆盖、删除、解密或应用永久保护等操作前，也应获得确认。返回结果应包含端点、方法、内容类型、完整请求字段、预期任务/结果字段，以及后续轮询或下载步骤。除非明确要求替换，否则应保留原始文件。
适用场景：知识库内容导入、开发者文档整理、内容再利用、研究工作流等需要将 PDF 转为 Markdown 的流程。
限制：仅支持 pdf-to-md 操作，仅输出 Markdown；请求字段和选项以官方 API 参考为准，不得推断未支持选项；凭据只能从技能本地 api_key 文件读取；上传及覆盖、删除、解密、永久保护等操作需用户确认；原始文件默认保留。