markitdown

npx skills add LeonChaoX/qinyan-academic-skills --skill markitdown --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# MarkItDown - File to Markdown Conversion ## Overview MarkItDown is a Python tool developed by Microsoft for converting various file formats to Markdown. It's particularly useful for converting documents into LLM-friendly text format, as Markdown is token-efficient and well-understood by modern language models. **Key Benefits**: - Convert documents to clean, structured Markdown - Token-efficient format for LLM processing - Supports 15+ file formats - Optional AI-enhanced image descriptions - OCR for images and scanned documents - Speech transcription for audio files ## Visual Enhancement with Scientific Schematics **When creating documents with this skill, always consider adding scientific diagrams and schematics to enhance visual communication.** If your document does not already contain schematics or diagrams: - Use the **scientific-schematics** skill to generate AI-powered publication-quality diagrams - Simply describe your desired diagram in natural language - Nano Banana Pro will automatically generate, review, and refine the schematic **For new documents:** Scientific schematics should be generated by default to visually represent key concepts, workflows, architectures, or r

python scripts/generate_schematic.py "your diagram description" -o figures/output.png
Install with all features
pip install 'markitdown[all]'
Or from source
git clone https://github.com/microsoft/markitdown.git
cd markitdown
pip install -e 'packages/markitdown[all]'
Basic conversion
markitdown document.pdf > output.md
Specify output file