markitai 0.16.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, ...)
• 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

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://raw.githubusercontent.com/Ynewtime/markitai/main/scripts/setup.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/Ynewtime/markitai/main/scripts/setup.ps1 | iex"

Minimal — uv / pip, if you already have Python 3.11–3.14 and just want the package:

uv tool install "markitai[all]"     # isolated environment (recommended)
pipx install "markitai[all]"        # or pipx

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

markitai doctor           # check what's installed / missing
markitai doctor --fix     # install the Playwright Chromium browser if you use --playwright
markitai init             # create a config and set up an LLM provider

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
gemini-cli	Gemini CLI OAuth as an LLM provider
extra-fetch	curl-cffi HTTP client (better anti-bot compatibility)
kreuzberg	Kreuzberg extraction backend
svg	SVG rasterization via cairosvg
all	Everything above

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