English Français العربية

markitai

السجل الرسمي البحث والويب

Convert documents, images and web pages to clean Markdown, for agents: single, URL and batch tools.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package markitai
Claude Code 
claude mcp add markitai -e 'MODEL=<MODEL>' -e 'MARKITAI_HOME=<MARKITAI_HOME>' -- uvx markitai==2.3.1 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "markitai": {
            "command": "uvx",
            "args": [
                "markitai==2.3.1",
                "mcp"
            ],
            "env": {
                "MODEL": "<MODEL>",
                "MARKITAI_HOME": "<MARKITAI_HOME>"
            }
        }
    }
}

متغيرات البيئة

  • MODEL provider/model for --llm enhancement, e.g. gemini/gemini-flash-lite-latest; with the matching API key env var set
  • MARKITAI_HOME Markitai's configuration, cache and model directory (default ~/.markitai)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Markitai
  2. Install
  3. Quick start
  4. Documentation
  5. License

Markitai

Markitai converts documents, web pages and images to Markdown. A single Rust core powers the markitai command (alias mkai), a local REST service with a browser workspace, an MCP server, and in-process Node.js, Python and Go bindings. The CLI executable needs no Python, Node.js or Go runtime; language bindings need their respective language runtime.

Markitai 2.0 is the Rust rewrite of Python markitai 1.2. See the changelog and compatibility contracts.

Install

macOS and Linux:

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

Windows (PowerShell):

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

The setup scripts download the release archive for your machine from GitHub Releases, check it against the release's SHA256SUMS, and install markitai, mkai and markitai-mcp for the current user, without administrator rights. Releases cover macOS 11+ (Apple silicon, Intel), Linux with glibc 2.28+ (x86-64, ARM64) and Windows (x64, ARM64). Python users can instead run pip install markitai or uv tool install markitai: PyPI has wheels for the same six platforms (Python 3.10+); elsewhere pip keeps markitai 1.x. Manual downloads, updates and uninstalling are in the installation steps.

The archives include license notices and selected Markdown guides for offline use. OCR models, Chromium and LibreOffice are optional separate components. See platform support for requirements, unsigned macOS builds for Gatekeeper, and bindings for language packages.

Quick start

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

For a separate trial state, set MARKITAI_HOME before using the CLI: export MARKITAI_HOME="$PWD/.local/try-home". Plain document conversion does not need a model connection. Existing configuration still applies; use --no-llm -b native for local document processing without model enhancement. URL inputs still need the network, even with --no-remote-fetch. Local OCR uses the portable Paddle engine on every platform (macOS Vision with MARKITAI_OCR_BACKEND=vision); doctor --fix can prepare missing Paddle models before offline use. JavaScript pages need Chrome/Chromium; Office page images need LibreOffice. Model enhancement (--llm) uses configured provider credentials or a subscription runtime.

Documentation

  • Quick start: installation and the first ten tasks.
  • CLI and MCP: command and Agent contracts.
  • Agent index and standalone Agent guide: plain Markdown entry points, also included in CLI archives.
  • Documentation index: the full source-checkout documentation. The offline archive contains selected guides; other topic links require this repository checkout.

License

MIT; see LICENSE and NOTICE.

الأسئلة الشائعة

ما هو markitai؟

Convert documents, images and web pages to clean Markdown, for agents: single, URL and batch tools.

كيف أثبّت markitai؟

يعمل على جهازك. في Claude Code: claude mcp add markitai -e 'MODEL=<MODEL>' -e 'MARKITAI_HOME=<MARKITAI_HOME>' -- uvx markitai==2.3.1 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج markitai إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل markitai مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون markitai؟

ينشره Ynewtime. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.