anymd

本地把任意文件秒变干净 Markdown，直接喂给 AI

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署自动化工作流 🍴 复刻 93 🐛 待处理 10 👀 关注 3

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1069

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，无需API密钥

项目预览

项目数据

分类自动化工作流

开发团队SylphxAI

官网地址https://sylphxai.github.io/anymd

GitHubhttps://github.com/SylphxAI/anymd

定价模式🏷️完全免费

价格说明开源免费，无需API密钥

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型ai-agents,cli,document-conversion,docx,docx-to-markdown,epub,html-to-markdown,llm,markdown,markitdown-alternative,mcp,model-context-protocol,ocr,pdf,pdf-to-markdown,pptx,rag,rust,transcription,xlsx

GitHub 星标★ 1069

上线时间2025-04-04 00:00:00

代码更新2026-11-07

仓库体积24.5 MB

本站数据更新2026-11-12

维护状态活跃

收录时间2026-09-28

浏览次数2

项目介绍

anymd 是一个用 Rust 编写的本地文档转换工具，目标是把各种格式的文件统一转成干净的 Markdown，方便喂给 AI 智能体或大模型。它支持 PDF、Word、PowerPoint、Excel、EPUB、HTML 网页，以及图片 OCR、音视频的元数据、字幕和转录文本。项目同时提供 MCP 服务器和命令行两种形态，全部在你本机运行，不需要任何 API Key，也不依赖云端服务。相比常见的 MarkItDown 类方案，它强调速度快、隐私好、开箱即用，适合把杂乱资料批量整理成结构化文本，再交给 AI 做总结、检索或知识库构建。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-28 · 当前星标 ★ 1069

技术标签

ai-agents cli docx epub html-to-markdown

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Node 18+（npx / npm 方式必需，npm 会自动安装对应平台的原生二进制）
Docker（可选，官方镜像支持 amd64 与 arm64）
Python 环境（可选，用于 uvx / pip 方式）
Rust 1.95+，以及 CMake 和 C++ 编译器（仅从源码 cargo install 时需要）

安装与启动步骤

1零安装快速试用

不用先安装，直接用 npx 运行一次并把转换结果重定向到 Markdown 文件；README 中的示例文件名为 report.pdf，换成你自己的文件即可。
```
npx -y @sylphx/anymd report.pdf > report.md
```
2一键接入 MCP 客户端

自动把 anymd 添加到本机所有 MCP 客户端（Claude Code、Codex、Cursor、VS Code、Claude Desktop、Windsurf、Gemini CLI）。加 --dry-run 可先预览，加 --remo
```
npx -y @sylphx/anymd setup
```
3手动添加单个客户端

不想用 setup 时，可只给某一个客户端注册。所有 MCP 客户端执行的都是同一条 npx 命令，把它填进对应的 MCP 配置即可。
```
claude mcp add anymd -- npx -y @sylphx/anymd
```
4全局安装 CLI

希望随时用 anymd 命令而不是每次 npx，可全局安装；安装后本地任意目录都能调用。
```
npm install -g @sylphx/anymd
```
5用 Docker 运行

把当前目录挂载进容器做一次性转换，输出到宿主机；也可以直接以 stdio 方式启动 MCP 服务器。-i 让容器保持标准输入，MCP 客户端才能通信。
```
docker run --rm -v "$PWD:/data" ghcr.io/sylphxai/anymd report.pdf > report.md
docker run -i --rm ghcr.io/sylphxai/anymd
```
6用 Python 方式运行

Python 渠道的 wheel 内置同一份预编译二进制，uvx 可一次性运行，pip 用于安装，uvx anymd mcp 可启动 MCP 服务器。
```
uvx anymd report.pdf > report.md
pip install anymd
uvx anymd mcp
```
7从源码编译安装

需要 Rust 1.95+、CMake 和 C++ 编译器，在本机编译，含 doc-VLM OCR 与本地 ASR 能力。npm、pip、Docker 渠道则是预编译二进制。
```
cargo install anymd
```

关键配置

配置项	必填	说明	示例
`mcpServers.anymd.command`	是	MCP 客户端启动 anymd 所使用的命令	`npx`
`mcpServers.anymd.args`	是	传给命令的参数，固定为下面两项	`["-y", "@sylphx/anymd"]`
`--allow-dir`	否	把 MCP 服务器限制在指定目录内，避免访问其他路径	`--allow-dir=/path/to/docs`
`servers.anymd.type（VS Code）`	否	VS Code 的 .vscode/mcp.json 需额外声明传输类型	`stdio`