用途：将 PDF、Word、PowerPoint、Excel、HTML、EPUB、Jupyter、RSS、CSV、JSON、YAML、图片、音频、ZIP、URL、维基百科页面和源代码等转换为 Markdown。既可作为全局 CLI 使用，也可作为 TypeScript/Node.js 库引入，支持可插拔转换器。
安装：npm install -g markit-ai 安装全局 CLI，或 npm install markit-ai 作为项目依赖（也支持 bun add、pnpm add）。
主要能力：CLI 支持 markit report.pdf 等文件转换、markit https://example.com/article 等 URL 转换，以及图片和音频转换；输出选项包括 -o 写入文件、-q 仅输出原始 Markdown、--json 结构化输出；支持从 stdin 读取（cat file.pdf | markit -）和管道输出；markit formats 列出支持格式。
AI/LLM 配置：图片与音频默认做免费的元数据提取；AI 描述和转写需要 API 密钥。OpenAI 使用 OPENAI_API_KEY，Anthropic 使用 ANTHROPIC_API_KEY，并可用 markit config set llm.provider 切换；兼容 OpenAI 的接口（如 Ollama、Groq、Together）可设置 llm.apiBase 与 llm.model。配置由 markit init 生成 .markit/config.json，环境变量优先于配置文件，且不要把密钥存入配置文件。
SDK 用法：new Markit() 后可调用 convertFile、convertUrl 或 convert(buffer, { extension })；可将 describe 与 transcribe 回调传入构造函数以接入自定义模型，也可通过 createLlmFunctions、loadConfig、loadAllPlugins 使用内置提供方与插件。
插件：可注册自定义转换器或覆盖内置转换器，也可注册自定义 LLM 提供方；用 markit plugin install npm:...、git:... 或本地路径安装，用 plugin list 与 plugin remove 管理。
适用场景：文档批量转 Markdown、网页正文抓取、图片描述、音频转写，以及在智能体和自动化脚本中通过 -q 或 --json 做程序化处理。
限制：内置 PDF 转换器使用文本提取而非 OCR，扫描版 PDF 需要 OCR 插件或先做 OCR 预处理；AI 功能依赖相应 API 密钥与模型能力；配置文件相对当前工作目录读取；实际收费与价格暂未提供。