用途
MarkItDown Online 是一个独立的托管式工作台，围绕开源项目 Microsoft MarkItDown 构建。其核心用途是将源文件转换为结构化的 Markdown 文本，使人和语言模型都能方便地阅读。它并非追求对 PDF、DOCX、电子表格、幻灯片、HTML 页面、图片、音频文件或压缩包进行像素级完美复制，而是生成包含标题、段落、列表、表格、链接、来源备注和警告的 Markdown，便于审阅者在内容进入搜索、RAG、文档、支持知识库或 LLM 上下文窗口之前进行检查。
主要能力
- 支持多种来源输入方式：上传文件、粘贴文本或 HTML、提交公开 URL、提供 data URI，以及通过 API 路径进行转换。
- 在转换前选择转换配置（conversion profile），以适应不同来源类型。
- 提供 Markdown 输出、解析器警告、来源详情和下载链接，供用户复查后再使用。
- 对解析器负担较重的格式，通过托管 worker 处理，并设有明确限制。
- 提供账户限制、托管 worker 边界、浏览器审阅、API 密钥、任务记录和定价路径，适合希望转换步骤比本地一次性命令更可重复的团队。
- 开发者可通过托管浏览器界面进行单次任务转换，或使用 MarkItDown API 进行服务器端集成。支持 Docker 打包解析器依赖以构建可重复的 worker。上游 Microsoft MarkItDown 项目为 Python 优先，可作为包或 CLI 在可信本地环境中使用。
使用方式
主页工作台将主要 MarkItDown 工作流集中在一个页面：选择来源、选择转换配置、在内容不应被分享时启用私有结果（private result）、运行任务、检查警告，然后复制或下载 Markdown。免费使用适用于快速检查。付费计划适合重复性 MarkItDown 工作，例如更大的文档、更多每月转换积分、API 访问、扩展来源配置和更高文件大小限制，具体计划边界请参见定价页面。
来源选择建议：上传用于被允许处理的文件；粘贴文本用于聚焦的摘录、CSV、JSON、HTML 片段或笔记；URL 转换仅用于无需登录、不指向私有网络的公开 HTTPS 页面；API 用于将 MarkItDown 嵌入产品工作流、内部摄取服务、支持队列或内部工具链。由于 MarkItDown 具有运行它的进程的权限，托管转换应限制输入、重定向、文件大小、私有网络访问、保留策略和输出共享。
适用场景
MarkItDown Online 适用于需要将文档转为 Markdown 以进行审阅、搜索、RAG 摄取、支持知识、文档或 LLM 上下文，且团队希望有可见的转换路径而非未跟踪的本地命令的场景。对于需要文件类型指导、解析器警告、可复制 Markdown、导出支持，并需要在上传、URL、data URI、批处理、Docker、Python 或 API 集成之间做出安全选择的用户而言，托管 MarkItDown 工作流最为合适。
当目标场景受益于纯结构时使用：RAG 和搜索索引中，Markdown 标题和表格比原始二进制文件产生更干净的块；ChatGPT、Claude、Gemini 等长上下文工作中，Markdown 减少界面噪音并保持来源可读；GitHub issues、文档仓库、Obsidian 库、Notion 迁移和支持回复中，Markdown 易于复制、差异比较、编辑和引用。
限制
MarkItDown 输出仍需人工审阅。PDF 提取可能重排栏、页眉、页脚、标题和脚注。Office 文档可能包含评论、隐藏文本、修订、嵌入对象、演讲者备注、公式、宏和 Markdown 无法自动保留的布局决策。HTML 可能包含脚本、样式块、导航、cookie 横幅、跟踪链接、相对 URL 和隐藏界面文本。图片和扫描文件可能需要 OCR 或人工描述。音频可能需要转写审阅。
MarkItDown 不适合所有文件。当法律布局、签名、精确幻灯片、图像含义、公式、图表或档案保真度重要时，应保留原始来源。当扫描页面和图表承载重要内容时，应使用 OCR、文档智能或人工审阅。不要对私有应用屏幕、账户页面、内部仪表板或任何服务不应获取的内容使用公开 URL 转换。未经审阅的 MarkItDown 输出不应成为训练数据、法律证据、医疗建议、财务记录或生产文档。
在转换敏感文件前，应确认源格式、预期保留边界、扫描页面是否需要 OCR，以及谁将在转换后审阅表格、图像、链接和元数据。团队还应决定转换后的 Markdown 如何命名、存储、引用和刷新。当 Markdown 成为模型上下文、检索输入或引用的操作记录时，可追溯性尤为重要。
实用质量检查
一个简单的质量检查：读者是否能在不立即重新打开原始文件的情况下理解来源标题、章节顺序、表格、链接和警告？模型是否能分辨来源结束和用户指令开始的位置？未来的同事是否能将 Markdown 追溯到产生它的文件、URL、任务或导出？如果答案都是肯定的，MarkItDown 已完成其工作。如果答案不明确，请编辑 Markdown、选择更窄的路径，或保留原生格式直到缺失的上下文得到解决。
