[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M739Y1R3FZSDNTEPVF15D3J1":3,"skill-same:01M739Y1R3FZSDNTEPVF15D3J1":88},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":31,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":34,"ownerDescription":6,"updatedAt":35,"install":36,"resources":49},"01M739Y1R3FZSDNTEPVF15D3J1","markitdown",null,"Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.","qhjqhj00\u002Fresearch-skills-pool","qhjqhj00","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F29684092?v=4","01M72AE0ZGXVM5C57N512DGQG8","Tommy Chien","01M72AE107ESJMHT7QC5SXX144",3,"MIT","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Fskills_collected\u002FK-Dense-AI--scientific-agent-skills--scientific-skills__markitdown\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: markitdown\ndescription: Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.\nallowed-tools: Read Write Edit Bash\nlicense: MIT license\nmetadata:\n    skill-author: K-Dense Inc.\n---\n\n# MarkItDown - File to Markdown Conversion\n\n## Overview\n\nMarkItDown 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.\n\n**Key Benefits**:\n- Convert documents to clean, structured Markdown\n- Token-efficient format for LLM processing\n- Supports 15+ file formats\n- Optional AI-enhanced image descriptions\n- OCR for images and scanned documents\n- Speech transcription for audio files\n\n## Visual Enhancement with Scientific Schematics\n\n**When creating documents with this skill, always consider adding scientific diagrams and schematics to enhance visual communication.**\n\nIf your document does not already contain schematics or diagrams:\n- Use the **scientific-schematics** skill to generate AI-powered publication-quality diagrams\n- Simply describe your desired diagram in natural language\n- Nano Banana Pro will automatically generate, review, and refine the schematic\n\n**For new documents:** Scientific schematics should be generated by default to visually represent key concepts, workflows, architectures, or relationships described in the text.\n\n**How to generate schematics:**\n```bash\npython scripts\u002Fgenerate_schematic.py \"your diagram description\" -o figures\u002Foutput.png\n```\n\nThe AI will automatically:\n- Create publication-quality images with proper formatting\n- Review and refine through multiple iterations\n- Ensure accessibility (colorblind-friendly, high contrast)\n- Save outputs in the figures\u002F directory\n\n**When to add schematics:**\n- Document conversion workflow diagrams\n- File format architecture illustrations\n- OCR processing pipeline diagrams\n- Integration workflow visualizations\n- System architecture diagrams\n- Data flow diagrams\n- Any complex concept that benefits from visualization\n\nFor detailed guidance on creating schematics, refer to the scientific-schematics skill documentation.\n\n---\n\n## Supported Formats\n\n| Format | Description | Notes |\n|--------|-------------|-------|\n| **PDF** | Portable Document Format | Full text extraction |\n| **DOCX** | Microsoft Word | Tables, formatting preserved |\n| **PPTX** | PowerPoint | Slides with notes |\n| **XLSX** | Excel spreadsheets | Tables and data |\n| **Images** | JPEG, PNG, GIF, WebP | EXIF metadata + OCR |\n| **Audio** | WAV, MP3 | Metadata + transcription |\n| **HTML** | Web pages | Clean conversion |\n| **CSV** | Comma-separated values | Table format |\n| **JSON** | JSON data | Structured representation |\n| **XML** | XML documents | Structured format |\n| **ZIP** | Archive files | Iterates contents |\n| **EPUB** | E-books | Full text extraction |\n| **YouTube** | Video URLs | Fetch transcriptions |\n\n## Quick Start\n\n### Installation\n\n```bash\n# Install with all features\npip install 'markitdown[all]'\n\n# Or from source\ngit clone https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fmarkitdown.git\ncd markitdown\npip install -e 'packages\u002Fmarkitdown[all]'\n```\n\n### Command-Line Usage\n\n```bash\n# Basic conversion\nmarkitdown document.pdf > output.md\n\n# Specify output file\nmarkitdown document.pdf -o output.md\n\n# Pipe content\ncat document.pdf | markitdown > output.md\n\n# Enable plugins\nmarkitdown --list-plugins  # List available plugins\nmarkitdown --use-plugins document.pdf -o output.md\n```\n\n### Python API\n\n```python\nfrom markitdown import MarkItDown\n\n# Basic usage\nmd = MarkItDown()\nresult = md.convert(\"document.pdf\")\nprint(result.text_content)\n\n# Convert from stream\nwith open(\"document.pdf\", \"rb\") as f:\n    result = md.convert_stream(f, file_extension=\".pdf\")\n    print(result.text_content)\n```\n\n## Advanced Features\n\n### 1. AI-Enhanced Image Descriptions\n\nUse LLMs via OpenRouter to generate detailed image descriptions (for PPTX and image files):\n\n```python\nfrom markitdown import MarkItDown\nfrom openai import OpenAI\n\n# Initialize OpenRouter client (OpenAI-compatible API)\nclient = OpenAI(\n    api_key=\"your-openrouter-api-key\",\n    base_url=\"https:\u002F\u002Fopenrouter.ai\u002Fapi\u002Fv1\"\n)\n\nmd = MarkItDown(\n    llm_client=client,\n    llm_model=\"anthropic\u002Fclaude-opus-4.5\",  # recommended for scientific vision\n    llm_prompt=\"Describe this image in detail for scientific documentation\"\n)\n\nresult = md.convert(\"presentation.pptx\")\nprint(result.text_content)\n```\n\n### 2. Azure Document Intelligence\n\nFor enhanced PDF conversion with Microsoft Document Intelligence:\n\n```bash\n# Command line\nmarkitdown document.pdf -o output.md -d -e \"\u003Cdocument_intelligence_endpoint>\"\n```\n\n```python\n# Python API\nfrom markitdown import MarkItDown\n\nmd = MarkItDown(docintel_endpoint=\"\u003Cdocument_intelligence_endpoint>\")\nresult = md.convert(\"complex_document.pdf\")\nprint(result.text_content)\n```\n\n### 3. Plugin System\n\nMarkItDown supports 3rd-party plugins for extending functionality:\n\n```bash\n# List installed plugins\nmarkitdown --list-plugins\n\n# Enable plugins\nmarkitdown --use-plugins file.pdf -o output.md\n```\n\nFind plugins on GitHub with hashtag: `#markitdown-plugin`\n\n## Optional Dependencies\n\nControl which file formats you support:\n\n```bash\n# Install specific formats\npip install 'markitdown[pdf, docx, pptx]'\n\n# All available options:\n# [all]                  - All optional dependencies\n# [pptx]                 - PowerPoint files\n# [docx]                 - Word documents\n# [xlsx]                 - Excel spreadsheets\n# [xls]                  - Older Excel files\n# [pdf]                  - PDF documents\n# [outlook]              - Outlook messages\n# [az-doc-intel]         - Azure Document Intelligence\n# [audio-transcription]  - WAV and MP3 transcription\n# [youtube-transcription] - YouTube video transcription\n```\n\n## Common Use Cases\n\n### 1. Convert Scientific Papers to Markdown\n\n```python\nfrom markitdown import MarkItDown\n\nmd = MarkItDown()\n\n# Convert PDF paper\nresult = md.convert(\"research_paper.pdf\")\nwith open(\"paper.md\", \"w\") as f:\n    f.write(result.text_content)\n```\n\n### 2. Extract Data from Excel for Analysis\n\n```python\nfrom markitdown import MarkItDown\n\nmd = MarkItDown()\nresult = md.convert(\"data.xlsx\")\n\n# Result will be in Markdown table format\nprint(result.text_content)\n```\n\n### 3. Process Multiple Documents\n\n```python\nfrom markitdown import MarkItDown\nimport os\nfrom pathlib import Path\n\nmd = MarkItDown()\n\n# Process all PDFs in a directory\npdf_dir = Path(\"papers\u002F\")\noutput_dir = Path(\"markdown_output\u002F\")\noutput_dir.mkdir(exist_ok=True)\n\nfor pdf_file in pdf_dir.glob(\"*.pdf\"):\n    result = md.convert(str(pdf_file))\n    output_file = output_dir \u002F f\"{pdf_file.stem}.md\"\n    output_file.write_text(result.text_content)\n    print(f\"Converted: {pdf_file.name}\")\n```\n\n### 4. Convert PowerPoint with AI Descriptions\n\n```python\nfrom markitdown import MarkItDown\nfrom openai import OpenAI\n\n# Use OpenRouter for access to multiple AI models\nclient = OpenAI(\n    api_key=\"your-openrouter-api-key\",\n    base_url=\"https:\u002F\u002Fopenrouter.ai\u002Fapi\u002Fv1\"\n)\n\nmd = MarkItDown(\n    llm_client=client,\n    llm_model=\"anthropic\u002Fclaude-opus-4.5\",  # recommended for presentations\n    llm_prompt=\"Describe this slide image in detail, focusing on key visual elements and data\"\n)\n\nresult = md.convert(\"presentation.pptx\")\nwith open(\"presentation.md\", \"w\") as f:\n    f.write(result.text_content)\n```\n\n### 5. Batch Convert with Different Formats\n\n```python\nfrom markitdown import MarkItDown\nfrom pathlib import Path\n\nmd = MarkItDown()\n\n# Files to convert\nfiles = [\n    \"document.pdf\",\n    \"spreadsheet.xlsx\",\n    \"presentation.pptx\",\n    \"notes.docx\"\n]\n\nfor file in files:\n    try:\n        result = md.convert(file)\n        output = Path(file).stem + \".md\"\n        with open(output, \"w\") as f:\n            f.write(result.text_content)\n        print(f\"✓ Converted {file}\")\n    except Exception as e:\n        print(f\"✗ Error converting {file}: {e}\")\n```\n\n### 6. Extract YouTube Video Transcription\n\n```python\nfrom markitdown import MarkItDown\n\nmd = MarkItDown()\n\n# Convert YouTube video to transcript\nresult = md.convert(\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=VIDEO_ID\")\nprint(result.text_content)\n```\n\n## Docker Usage\n\n```bash\n# Build image\ndocker build -t markitdown:latest .\n\n# Run conversion\ndocker run --rm -i markitdown:latest \u003C ~\u002Fdocument.pdf > output.md\n```\n\n## Best Practices\n\n### 1. Choose the Right Conversion Method\n\n- **Simple documents**: Use basic `MarkItDown()`\n- **Complex PDFs**: Use Azure Document Intelligence\n- **Visual content**: Enable AI image descriptions\n- **Scanned documents**: Ensure OCR dependencies are installed\n\n### 2. Handle Errors Gracefully\n\n```python\nfrom markitdown import MarkItDown\n\nmd = MarkItDown()\n\ntry:\n    result = md.convert(\"document.pdf\")\n    print(result.text_content)\nexcept FileNotFoundError:\n    print(\"File not found\")\nexcept Exception as e:\n    print(f\"Conversion error: {e}\")\n```\n\n### 3. Process Large Files Efficiently\n\n```python\nfrom markitdown import MarkItDown\n\nmd = MarkItDown()\n\n# For large files, use streaming\nwith open(\"large_file.pdf\", \"rb\") as f:\n    result = md.convert_stream(f, file_extension=\".pdf\")\n    \n    # Process in chunks or save directly\n    with open(\"output.md\", \"w\") as out:\n        out.write(result.text_content)\n```\n\n### 4. Optimize for Token Efficiency\n\nMarkdown output is already token-efficient, but you can:\n- Remove excessive whitespace\n- Consolidate similar sections\n- Strip metadata if not needed\n\n```python\nfrom markitdown import MarkItDown\nimport re\n\nmd = MarkItDown()\nresult = md.convert(\"document.pdf\")\n\n# Clean up extra whitespace\nclean_text = re.sub(r'\\n{3,}', '\\n\\n', result.text_content)\nclean_text = clean_text.strip()\n\nprint(clean_text)\n```\n\n## Integration with Scientific Workflows\n\n### Convert Literature for Review\n\n```python\nfrom markitdown import MarkItDown\nfrom pathlib import Path\n\nmd = MarkItDown()\n\n# Convert all papers in literature folder\npapers_dir = Path(\"literature\u002Fpdfs\")\noutput_dir = Path(\"literature\u002Fmarkdown\")\noutput_dir.mkdir(exist_ok=True)\n\nfor paper in papers_dir.glob(\"*.pdf\"):\n    result = md.convert(str(paper))\n    \n    # Save with metadata\n    output_file = output_dir \u002F f\"{paper.stem}.md\"\n    content = f\"# {paper.stem}\\n\\n\"\n    content += f\"**Source**: {paper.name}\\n\\n\"\n    content += \"---\\n\\n\"\n    content += result.text_content\n    \n    output_file.write_text(content)\n\n# For AI-enhanced conversion with figures\nfrom openai import OpenAI\n\nclient = OpenAI(\n    api_key=\"your-openrouter-api-key\",\n    base_url=\"https:\u002F\u002Fopenrouter.ai\u002Fapi\u002Fv1\"\n)\n\nmd_ai = MarkItDown(\n    llm_client=client,\n    llm_model=\"anthropic\u002Fclaude-opus-4.5\",\n    llm_prompt=\"Describe scientific figures with technical precision\"\n)\n```\n\n### Extract Tables for Analysis\n\n```python\nfrom markitdown import MarkItDown\nimport re\n\nmd = MarkItDown()\nresult = md.convert(\"data_tables.xlsx\")\n\n# Markdown tables can be parsed or used directly\nprint(result.text_content)\n```\n\n## Troubleshooting\n\n### Common Issues\n\n1. **Missing dependencies**: Install feature-specific packages\n   ```bash\n   pip install 'markitdown[pdf]'  # For PDF support\n   ```\n\n2. **Binary file errors**: Ensure files are opened in binary mode\n   ```python\n   with open(\"file.pdf\", \"rb\") as f:  # Note the \"rb\"\n       result = md.convert_stream(f, file_extension=\".pdf\")\n   ```\n\n3. **OCR not working**: Install tesseract\n   ```bash\n   # macOS\n   brew install tesseract\n   \n   # Ubuntu\n   sudo apt-get install tesseract-ocr\n   ```\n\n## Performance Considerations\n\n- **PDF files**: Large PDFs may take time; consider page ranges if supported\n- **Image OCR**: OCR processing is CPU-intensive\n- **Audio transcription**: Requires additional compute resources\n- **AI image descriptions**: Requires API calls (costs may apply)\n\n## Next Steps\n\n- See `references\u002Fapi_reference.md` for complete API documentation\n- Check `references\u002Ffile_formats.md` for format-specific details\n- Review `scripts\u002Fbatch_convert.py` for automation examples\n- Explore `scripts\u002Fconvert_with_ai.py` for AI-enhanced conversions\n\n## Resources\n\n- **MarkItDown GitHub**: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fmarkitdown\n- **PyPI**: https:\u002F\u002Fpypi.org\u002Fproject\u002Fmarkitdown\u002F\n- **OpenRouter**: https:\u002F\u002Fopenrouter.ai (for AI-enhanced conversions)\n- **OpenRouter API Keys**: https:\u002F\u002Fopenrouter.ai\u002Fkeys\n- **OpenRouter Models**: https:\u002F\u002Fopenrouter.ai\u002Fmodels\n- **MCP Server**: markitdown-mcp (for Claude Desktop integration)\n- **Plugin Development**: See `packages\u002Fmarkitdown-sample-plugin`\n\n\n","# MarkItDown - File to Markdown Conversion\n\n## Overview\n\nMarkItDown 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.\n\n**Key Benefits**:\n- Convert documents to clean, structured Markdown\n- Token-efficient format for LLM processing\n- Supports 15+ file formats\n- Optional AI-enhanced image descriptions\n- OCR for images and scanned documents\n- Speech transcription for audio files\n\n## Visual Enhancement with Scientific Schematics\n\n**When creating documents with this skill, always consider adding scientific diagrams and schematics to enhance visual communication.**\n\nIf your document does not already contain schematics or diagrams:\n- Use the **scientific-schematics** skill to generate AI-powered publication-quality diagrams\n- Simply describe your desired diagram in natural language\n- Nano Banana Pro will automatically generate, review, and refine the schematic\n\n**For new documents:** Scientific schematics should be generated by default to visually represent key concepts, workflows, architectures, or relationships described in the text.\n\n**How to generate schematics:**\n```bash\npython scripts\u002Fgenerate_schematic.py \"your diagram description\" -o figures\u002Foutput.png\n```\n\nThe AI will automatically:\n- Create publication-quality images with proper formatting\n- Review and refine through multiple iterations\n- Ensure accessibility (colorblind-friendly, high contrast)\n- Save outputs in the figures\u002F directory\n\n**When to add schematics:**\n- Document conversion workflow diagrams\n- File format architecture illustrations\n- OCR processing pipeline diagrams\n- Integration workflow visualizations\n- System architecture diagrams\n- Data flow diagrams\n- Any complex concept that benefits from visualization\n\nFor detailed guidance on creating schematics, refer to the scientific-schematics skill documentation.\n\n---\n\n## Supported Formats\n\n| Format | Description | Notes |\n|--------|-------------|-------|\n| **PDF** | Portable Document Format | Full text extraction |\n| **DOCX** | Microsoft Word | Tables, formatting preserved |\n| **PPTX** | PowerPoint | Slides with notes |\n| **XLSX** | Excel spreadsheets | Tables and data |\n| **Images** | JPEG, PNG, GIF, WebP | EXIF metadata + OCR |\n| **Audio** | WAV, MP3 | Metadata + transcription |\n| **HTML** | Web pages | Clean conversion |\n| **CSV** | Comma-separated values | Table format |\n| **JSON** | JSON data | Structured representation |\n| **XML** | XML documents | Structured format |\n| **ZIP** | Archive files | Iterates contents |\n| **EPUB** | E-books | Full text extraction |\n| **YouTube** | Video URLs | Fetch transcriptions |\n\n## Quick Start\n\n### Installation\n\n```bash\n# Install with all features\npip install 'markitdown[all]'\n\n# Or from source\ngit clone https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fmarkitdown.git\ncd markitdown\npip install -e 'packages\u002Fmarkitdown[all]'\n```\n\n### Command-Line Usage\n\n```bash\n# Basic conversion\nmarkitdown document.pdf > output.md\n\n# Specify output file\nmarkitdown document.pdf -o output.md\n\n# Pipe content\ncat document.pdf | markitdown > output.md\n\n# Enable plugins\nmarkitdown --list-plugins  # List available plugins\nmarkitdown --use-plugins document.pdf -o output.md\n```\n\n### Python API\n\n```python\nfrom markitdown import MarkItDown\n\n# Basic usage\nmd = MarkItDown()\nresult = md.convert(\"document.pdf\")\nprint(result.text_content)\n\n# Convert from stream\nwith open(\"document.pdf\", \"rb\") as f:\n    result = md.convert_stream(f, file_extension=\".pdf\")\n    print(result.text_content)\n```\n\n## Advanced Features\n\n### 1. AI-Enhanced Image Descriptions\n\nUse LLMs via OpenRouter to generate detailed image descriptions (for PPTX and image files):\n\n```python\nfrom markitdown import MarkItDown\nfrom openai import OpenAI\n\n# Initialize OpenRouter client (OpenAI-compatible API)\nclient = OpenAI(\n    api_key=\"your-openrouter-api-key\",\n    base_url=\"https:\u002F\u002Fopenrouter.ai\u002Fapi\u002Fv1\"\n)\n\nmd = MarkItDown(\n    llm_client=client,\n    llm_model=\"anthropic\u002Fclaude-opus-4.5\",  # recommended for scientific vision\n    llm_prompt=\"Describe this image in detail for scientific documentation\"\n)\n\nresult = md.convert(\"presentation.pptx\")\nprint(result.text_content)\n```\n\n### 2. Azure Document Intelligence\n\nFor enhanced PDF conversion with Microsoft Document Intelligence:\n\n```bash\n# Command line\nmarkitdown document.pdf -o output.md -d -e \"\u003Cdocument_intelligence_endpoint>\"\n```\n\n```python\n# Python API\nfrom markitdown import MarkItDown\n\nmd = MarkItDown(docintel_endpoint=\"\u003Cdocument_intelligence_endpoint>\")\nresult = md.convert(\"complex_document.pdf\")\nprint(result.text_content)\n```\n\n### 3. Plugin System\n\nMarkItDown supports 3rd-party plugins for extending functionality:\n\n```bash\n# List installed plugins\nmarkitdown --list-plugins\n\n# Enable plugins\nmarkitdown --use-plugins file.pdf -o output.md\n```\n\nFind plugins on GitHub with hashtag: `#markitdown-plugin`\n\n## Optional Dependencies\n\nControl which file formats you support:\n\n```bash\n# Install specific formats\npip install 'markitdown[pdf, docx, pptx]'\n\n# All available options:\n# [all]                  - All optional dependencies\n# [pptx]                 - PowerPoint files\n# [docx]                 - Word documents\n# [xlsx]                 - Excel spreadsheets\n# [xls]                  - Older Excel files\n# [pdf]                  - PDF documents\n# [outlook]              - Outlook messages\n# [az-doc-intel]         - Azure Document Intelligence\n# [audio-transcription]  - WAV and MP3 transcription\n# [youtube-transcription] - YouTube video transcription\n```\n\n## Common Use Cases\n\n### 1. Convert Scientific Papers to Markdown\n\n```python\nfrom markitdown import MarkItDown\n\nmd = MarkItDown()\n\n# Convert PDF paper\nresult = md.convert(\"research_paper.pdf\")\nwith open(\"paper.md\", \"w\") as f:\n    f.write(result.text_content)\n```\n\n### 2. Extract Data from Excel for Analysis\n\n```python\nfrom markitdown import MarkItDown\n\nmd = MarkItDown()\nresult = md.convert(\"data.xlsx\")\n\n# Result will be in Markdown table format\nprint(result.text_content)\n```\n\n### 3. Process Multiple Documents\n\n```python\nfrom markitdown import MarkItDown\nimport os\nfrom pathlib import Path\n\nmd = MarkItDown()\n\n# Process all PDFs in a directory\npdf_dir = Path(\"papers\u002F\")\noutput_dir = Path(\"markdown_output\u002F\")\noutput_dir.mkdir(exist_ok=True)\n\nfor pdf_file in pdf_dir.glob(\"*.pdf\"):\n    result = md.convert(str(pdf_file))\n    output_file = output_dir \u002F f\"{pdf_file.stem}.md\"\n    output_file.write_text(result.text_content)\n    print(f\"Converted: {pdf_file.name}\")\n```\n\n### 4. Convert PowerPoint with AI Descriptions\n\n```python\nfrom markitdown import MarkItDown\nfrom openai import OpenAI\n\n# Use OpenRouter for access to multiple AI models\nclient = OpenAI(\n    api_key=\"your-openrouter-api-key\",\n    base_url=\"https:\u002F\u002Fopenrouter.ai\u002Fapi\u002Fv1\"\n)\n\nmd = MarkItDown(\n    llm_client=client,\n    llm_model=\"anthropic\u002Fclaude-opus-4.5\",  # recommended for presentations\n    llm_prompt=\"Describe this slide image in detail, focusing on key visual elements and data\"\n)\n\nresult = md.convert(\"presentation.pptx\")\nwith open(\"presentation.md\", \"w\") as f:\n    f.write(result.text_content)\n```\n\n### 5. Batch Convert with Different Formats\n\n```python\nfrom markitdown import MarkItDown\nfrom pathlib import Path\n\nmd = MarkItDown()\n\n# Files to convert\nfiles = [\n    \"document.pdf\",\n    \"spreadsheet.xlsx\",\n    \"presentation.pptx\",\n    \"notes.docx\"\n]\n\nfor file in files:\n    try:\n        result = md.convert(file)\n        output = Path(file).stem + \".md\"\n        with open(output, \"w\") as f:\n            f.write(result.text_content)\n        print(f\"✓ Converted {file}\")\n    except Exception as e:\n        print(f\"✗ Error converting {file}: {e}\")\n```\n\n### 6. Extract YouTube Video Transcription\n\n```python\nfrom markitdown import MarkItDown\n\nmd = MarkItDown()\n\n# Convert YouTube video to transcript\nresult = md.convert(\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=VIDEO_ID\")\nprint(result.text_content)\n```\n\n## Docker Usage\n\n```bash\n# Build image\ndocker build -t markitdown:latest .\n\n# Run conversion\ndocker run --rm -i markitdown:latest \u003C ~\u002Fdocument.pdf > output.md\n```\n\n## Best Practices\n\n### 1. Choose the Right Conversion Method\n\n- **Simple documents**: Use basic `MarkItDown()`\n- **Complex PDFs**: Use Azure Document Intelligence\n- **Visual content**: Enable AI image descriptions\n- **Scanned documents**: Ensure OCR dependencies are installed\n\n### 2. Handle Errors Gracefully\n\n```python\nfrom markitdown import MarkItDown\n\nmd = MarkItDown()\n\ntry:\n    result = md.convert(\"document.pdf\")\n    print(result.text_content)\nexcept FileNotFoundError:\n    print(\"File not found\")\nexcept Exception as e:\n    print(f\"Conversion error: {e}\")\n```\n\n### 3. Process Large Files Efficiently\n\n```python\nfrom markitdown import MarkItDown\n\nmd = MarkItDown()\n\n# For large files, use streaming\nwith open(\"large_file.pdf\", \"rb\") as f:\n    result = md.convert_stream(f, file_extension=\".pdf\")\n    \n    # Process in chunks or save directly\n    with open(\"output.md\", \"w\") as out:\n        out.write(result.text_content)\n```\n\n### 4. Optimize for Token Efficiency\n\nMarkdown output is already token-efficient, but you can:\n- Remove excessive whitespace\n- Consolidate similar sections\n- Strip metadata if not needed\n\n```python\nfrom markitdown import MarkItDown\nimport re\n\nmd = MarkItDown()\nresult = md.convert(\"document.pdf\")\n\n# Clean up extra whitespace\nclean_text = re.sub(r'\\n{3,}', '\\n\\n', result.text_content)\nclean_text = clean_text.strip()\n\nprint(clean_text)\n```\n\n## Integration with Scientific Workflows\n\n### Convert Literature for Review\n\n```python\nfrom markitdown import MarkItDown\nfrom pathlib import Path\n\nmd = MarkItDown()\n\n# Convert all papers in literature folder\npapers_dir = Path(\"literature\u002Fpdfs\")\noutput_dir = Path(\"literature\u002Fmarkdown\")\noutput_dir.mkdir(exist_ok=True)\n\nfor paper in papers_dir.glob(\"*.pdf\"):\n    result = md.convert(str(paper))\n    \n    # Save with metadata\n    output_file = output_dir \u002F f\"{paper.stem}.md\"\n    content = f\"# {paper.stem}\\n\\n\"\n    content += f\"**Source**: {paper.name}\\n\\n\"\n    content += \"---\\n\\n\"\n    content += result.text_content\n    \n    output_file.write_text(content)\n\n# For AI-enhanced conversion with figures\nfrom openai import OpenAI\n\nclient = OpenAI(\n    api_key=\"your-openrouter-api-key\",\n    base_url=\"https:\u002F\u002Fopenrouter.ai\u002Fapi\u002Fv1\"\n)\n\nmd_ai = MarkItDown(\n    llm_client=client,\n    llm_model=\"anthropic\u002Fclaude-opus-4.5\",\n    llm_prompt=\"Describe scientific figures with technical precision\"\n)\n```\n\n### Extract Tables for Analysis\n\n```python\nfrom markitdown import MarkItDown\nimport re\n\nmd = MarkItDown()\nresult = md.convert(\"data_tables.xlsx\")\n\n# Markdown tables can be parsed or used directly\nprint(result.text_content)\n```\n\n## Troubleshooting\n\n### Common Issues\n\n1. **Missing dependencies**: Install feature-specific packages\n   ```bash\n   pip install 'markitdown[pdf]'  # For PDF support\n   ```\n\n2. **Binary file errors**: Ensure files are opened in binary mode\n   ```python\n   with open(\"file.pdf\", \"rb\") as f:  # Note the \"rb\"\n       result = md.convert_stream(f, file_extension=\".pdf\")\n   ```\n\n3. **OCR not working**: Install tesseract\n   ```bash\n   # macOS\n   brew install tesseract\n   \n   # Ubuntu\n   sudo apt-get install tesseract-ocr\n   ```\n\n## Performance Considerations\n\n- **PDF files**: Large PDFs may take time; consider page ranges if supported\n- **Image OCR**: OCR processing is CPU-intensive\n- **Audio transcription**: Requires additional compute resources\n- **AI image descriptions**: Requires API calls (costs may apply)\n\n## Next Steps\n\n- See `references\u002Fapi_reference.md` for complete API documentation\n- Check `references\u002Ffile_formats.md` for format-specific details\n- Review `scripts\u002Fbatch_convert.py` for automation examples\n- Explore `scripts\u002Fconvert_with_ai.py` for AI-enhanced conversions\n\n## Resources\n\n- **MarkItDown GitHub**: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fmarkitdown\n- **PyPI**: https:\u002F\u002Fpypi.org\u002Fproject\u002Fmarkitdown\u002F\n- **OpenRouter**: https:\u002F\u002Fopenrouter.ai (for AI-enhanced conversions)\n- **OpenRouter API Keys**: https:\u002F\u002Fopenrouter.ai\u002Fkeys\n- **OpenRouter Models**: https:\u002F\u002Fopenrouter.ai\u002Fmodels\n- **MCP Server**: markitdown-mcp (for Claude Desktop integration)\n- **Plugin Development**: See `packages\u002Fmarkitdown-sample-plugin`\n\n\n",{"name":5,"license":24,"metadata":25,"description":7,"allowed-tools":27},"MIT license",{"skill-author":26},"K-Dense Inc.","Read Write Edit Bash","master","c247302c836de6438d746b45670990eb71691166","skills_collected\u002FK-Dense-AI--scientific-agent-skills--scientific-skills__markitdown",1,"https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool","https:\u002F\u002Fgithub.com\u002Fqhjqhj00","chien.io","2026-05-11 15:07:59",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add qhjqhj00\u002Fresearch-skills-pool --skill markitdown",{"tool":42,"command":43},"bunx","bunx skills add qhjqhj00\u002Fresearch-skills-pool --skill markitdown",{"tool":45,"command":46},"pnpm","pnpm dlx skills add qhjqhj00\u002Fresearch-skills-pool --skill markitdown","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Fskills_collected\u002FK-Dense-AI--scientific-agent-skills--scientific-skills__markitdown\u002FSKILL.md",true,[50,56,62,66,72,76,80,84],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"assets\u002Fexample_usage.md","ASSET","资产文件",10378,"https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Fskills_collected\u002FK-Dense-AI--scientific-agent-skills--scientific-skills__markitdown\u002Fassets\u002Fexample_usage.md",{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Fapi_reference.md","REFERENCE","参考文档",8851,"https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Fskills_collected\u002FK-Dense-AI--scientific-agent-skills--scientific-skills__markitdown\u002Freferences\u002Fapi_reference.md",{"path":63,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":64,"sourceHtmlUrl":65},"references\u002Ffile_formats.md",8985,"https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Fskills_collected\u002FK-Dense-AI--scientific-agent-skills--scientific-skills__markitdown\u002Freferences\u002Ffile_formats.md",{"path":67,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":70,"sourceHtmlUrl":71},"scripts\u002Fbatch_convert.py","SCRIPT","脚本",6650,"https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Fskills_collected\u002FK-Dense-AI--scientific-agent-skills--scientific-skills__markitdown\u002Fscripts\u002Fbatch_convert.py",{"path":73,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":74,"sourceHtmlUrl":75},"scripts\u002Fconvert_literature.py",8915,"https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Fskills_collected\u002FK-Dense-AI--scientific-agent-skills--scientific-skills__markitdown\u002Fscripts\u002Fconvert_literature.py",{"path":77,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":78,"sourceHtmlUrl":79},"scripts\u002Fconvert_with_ai.py",7461,"https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Fskills_collected\u002FK-Dense-AI--scientific-agent-skills--scientific-skills__markitdown\u002Fscripts\u002Fconvert_with_ai.py",{"path":81,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":82,"sourceHtmlUrl":83},"scripts\u002Fgenerate_schematic_ai.py",32647,"https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Fskills_collected\u002FK-Dense-AI--scientific-agent-skills--scientific-skills__markitdown\u002Fscripts\u002Fgenerate_schematic_ai.py",{"path":85,"resourceType":68,"resourceTypeDesc":69,"sizeBytes":86,"sourceHtmlUrl":87},"scripts\u002Fgenerate_schematic.py",5146,"https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Fskills_collected\u002FK-Dense-AI--scientific-agent-skills--scientific-skills__markitdown\u002Fscripts\u002Fgenerate_schematic.py",[89,96,103,110,117,124],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M73JJB6EQPFPPVQK2Y9N67Q0","transformer-lens-interpretability","Provides guidance for mechanistic interpretability research using TransformerLens to inspect and manipulate transformer internals via HookPoints and activation caching. Use when reverse-engineering model algorithms, studying attention patterns, or performing activation patching experiments.","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Ftop100-runs\u002F130-transformer-lens\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M73JHTANRRWEE9HP98TPEHAY","wiki-vitepress","Packages generated wiki Markdown into a VitePress static site with dark theme, dark-mode Mermaid diagrams with click-to-zoom, and production build output. Use when the user wants to create a browsable website from generated wiki pages.","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Ftop100-runs\u002F126-wiki-vitepress\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":19},"01M73JHJBMVFW46F1Y8K3SBF43","phoenix-observability","Open-source AI observability platform for LLM tracing, evaluation, and monitoring. Use when debugging LLM applications with detailed traces, running evaluations on datasets, or monitoring production AI systems with real-time insights.","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Ftop100-runs\u002F124-phoenix\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":19},"01M73JHFPA3A2806PMP42ZN86Q","frontend-ui-dark-ts","Build dark-themed React applications using Tailwind CSS with custom theming, glassmorphism effects, and Framer Motion animations. Use when creating dashboards, admin panels, or data-rich interfaces with a refined dark aesthetic.","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Ftop100-runs\u002F123-frontend-ui-dark-ts\u002FSKILL.md",[],[],{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":19},"01M73JFVBVK57NRJS49TT2VDCT","tensorboard","Visualize training metrics, debug models with histograms, compare experiments, visualize model graphs, and profile performance with TensorBoard - Google's ML visualization toolkit","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Ftop100-runs\u002F113-tensorboard\u002FSKILL.md",[],[],{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":128,"licenseFileUrl":6,"sourceHtmlUrl":129,"categories":130,"keywords":131,"publishedAt":19},"01M73JFF6PK6ZCN41C89J7HS2B","markdown-mermaid-writing","Comprehensive markdown and Mermaid diagram writing skill. Use when creating any scientific document, report, analysis, or visualization. Establishes text-based diagrams as the default documentation standard with full style guides (markdown + mermaid), 24 diagram type references, and 9 document templates.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fqhjqhj00\u002Fresearch-skills-pool\u002Fblob\u002Fmaster\u002Ftop100-runs\u002F110-markdown-mermaid-writing\u002FSKILL.md",[],[]]