markitai

本地服务

markitai.dev生产力12 天前更新

代码仓库访问官网

关于 markitai

markitai 将文档、图片和网页转换为 Markdown，面向开发者和 Agent。其 Rust 核心同时支持命令行、本地服务、浏览器工作区、MCP 服务及多种语言绑定。

主要功能

01转换文档和网页
02通过 OCR 转换图片
03处理单项及批量任务
04命令行、本地服务和浏览器工作区
05Node.js、Python 和 Go 绑定

适用场景

01将文档文件夹转换为 Markdown
02从扫描图片中提取文本
03为 Agent 工作流准备网页内容

MCP 相关

MCP 服务向客户端提供单项、URL 和批量转换工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ynewtime-markitai": {
      "command": "uvx",
      "args": [
        "markitai"
      ],
      "env": {
        "MODEL": "<MODEL>",
        "MARKITAI_HOME": "<MARKITAI_HOME>"
      }
    }
  }
}

启动命令uvx markitai

需要配置的环境变量

MODELprovider/model for --llm enhancement, e.g. gemini/gemini-flash-lite-latest; with the matching API key env var set

MARKITAI_HOMEMarkitai's configuration, cache and model directory (default ~/.markitai)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypimarkitai2.3.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Markitai

Markitai 可将文档、网页和图像转换为 Markdown。一个 Rust 核心为 markitai 命令（别名 mkai）、带有浏览器工作区的本地 REST 服务、MCP 服务，以及进程内 Node.js、Python 和 Go 绑定提供支持。CLI 可执行文件无需 Python、Node.js 或 Go 运行时；语言绑定则需要各自的语言运行时。

Markitai 2.0 是 Python 版 markitai 1.2 的 Rust 重写版。请参阅更新日志和兼容性约定。

安装

macOS 和 Linux：

curl -fsSL https://markitai.dev/setup.sh | sh

Windows（PowerShell）：

powershell -ExecutionPolicy ByPass -c "irm https://markitai.dev/setup.ps1 | iex"

安装脚本会从 GitHub Releases 下载适用于你设备的发行版压缩包，根据发行版的 SHA256SUMS 校验文件，并在无需管理员权限的情况下为当前用户安装 markitai、mkai 和 markitai-mcp。发行版支持 macOS 11 及更高版本（Apple 芯片、Intel）、使用 glibc 2.28 及更高版本的 Linux（x86-64、ARM64）和 Windows（x64、ARM64）。Python 用户也可以运行 pip install markitai 或 uv tool install markitai（需要 Python 3.10 及更高版本）。PyPI 仅为这六个平台提供 wheel，且不再提供 1.x：其他平台上，pip 没有可安装的内容，并会保留已安装的 1.x 版本。手动下载、更新、卸载以及回退到 1.x 的说明，请参阅安装步骤。

压缩包包含许可证声明和精选的 Markdown 指南，便于离线使用。OCR 模型、Chromium 和 LibreOffice 是可选的独立组件。有关要求，请参阅平台支持；有关 Gatekeeper，请参阅未签名的 macOS 构建；有关语言包，请参阅绑定。

快速入门

markitai report.docx -o out/                  # writes out/report.docx.md
markitai ./documents -o out/                  # whole folder, with a report
markitai scan.png --ocr -o out/               # local OCR; models may need preparation
markitai report.docx -o out/ --json           # structured result for automation
markitai doctor                              # inspect optional components
markitai --help                              # commands, options and examples
markitai serve                               # browser workspace on 127.0.0.1:3600

如需使用独立的试用状态，请在使用 CLI 前设置 MARKITAI_HOME： export MARKITAI_HOME="$PWD/.local/try-home"。普通文档转换无需连接模型。现有配置仍然适用；使用 --no-llm -b native 可在不进行模型增强的情况下本地处理文档。即使使用 --no-remote-fetch，URL 输入仍需要网络。所有平台上的本地 OCR 都使用便携式 Paddle 引擎（macOS 上可设置 MARKITAI_OCR_BACKEND=vision 使用 Vision）；离线使用前，可运行 doctor --fix 准备缺失的 Paddle 模型。JavaScript 网页需要 Chrome/Chromium；Office 页面图像需要 LibreOffice。模型增强（--llm）使用已配置的服务商凭据或订阅运行时。