markitai 0.23.0

Opinionated Markdown converter with native LLM enhancement support

Markitai

Opinionated Markdown converter with native LLM enhancement support.

• Multi-format: DOCX, PPTX, XLSX, PDF, TXT, MD, images (JPG/PNG/WebP), and URLs → clean Markdown
• LLM enhancement: AI-powered format cleaning, frontmatter metadata, and vision analysis of embedded images via litellm, so any provider works (OpenAI, Anthropic, Gemini, local CLIs, and more)
• Batch processing: concurrent conversion with progress display and --resume for interrupted jobs
• OCR: scanned PDFs and images via RapidOCR
• Web fetching: static HTTP with cache revalidation, or Playwright rendering for JS-heavy pages
• Local web workspace: upload files or folders, submit URLs, configure LLM providers, compare results, retry failures, and revisit conversion history

Docs: https://markitai.dev

Install

Recommended: guided installer. Checks/installs Python and uv, lets you pick extras, installs optional components (Playwright browser, LibreOffice, FFmpeg), offers China-mainland mirror acceleration, and is bilingual (EN/中文):

# Linux/macOS
curl -fsSL https://markitai.dev/setup.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://markitai.dev/setup.ps1 | iex"

Minimal (uv / pip), if you already have Python 3.11-3.13 and just want the package:

uv tool install markitai     # isolated environment (recommended)
pipx install markitai        # or pipx

After a uv/pip install, do the setup steps the guided installer would have done for you:

markitai doctor           # check core and optional capabilities
markitai init             # create a config and set up an LLM provider

If you need Playwright browser rendering, add its package before asking doctor to install Chromium:

uv tool install "markitai[browser]" --force     # uv tool install
# pipx install "markitai[browser]" --force      # pipx alternative
markitai doctor --fix                           # install Chromium

Both installs provide the markitai command and the shorter mkai alias. They are the same command (mkai --help == markitai --help). If you already have a different mkai on your PATH, use the full markitai to avoid ambiguity.

Extras

Extra	Enables
browser	Playwright rendering for JS-heavy pages
claude-agent	Claude Agent SDK as an LLM provider
copilot	GitHub Copilot SDK as an LLM provider
extra-fetch	curl-cffi HTTP client (better anti-bot compatibility)
kreuzberg	Kreuzberg extraction backend
serve	Local web workspace and REST API
svg	SVG rasterization via cairosvg
all	Everything above

Launch the local web workspace with:

uv tool install "markitai[serve]" --force
markitai serve

Quick start

markitai document.pdf -o out/            # convert a file
markitai https://example.com -o out/     # convert a URL
markitai ./docs -o out/ --llm            # batch convert with LLM enhancement
markitai document.pdf --preset rich      # LLM + alt text + descriptions + screenshots
markitai doctor                          # check dependencies and configuration
markitai init                            # interactive configuration setup

See the Getting Started guide for LLM configuration, presets, caching, and batch options.

License

MIT