Alterlab Markitdown
Converts files and Office documents to clean, LLM-friendly Markdown with Microsoft MarkItDown (markitdown CLI, Python API, and markitdown-mcp server), supporting PDF, DOCX, PPTX, XLSX/XLS, images (EXIF metadata, descriptions), audio (transcription), HTML, CSV, JSON, XML, ZIP archives, EPUB e-books, Outlook MSG, Jupyter notebooks, and YouTube transcript URLs. No API key needed — embedded images are extracted for Claude to describe and transcribe itself; an OpenRouter/OpenAI vision model, the markitdown-ocr plugin, or Azure Document Intelligence are optional. Use when converting a document, PDF,
Install
/plugin marketplace add AlterLab-IEU/AlterLab-Academic-SkillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add AlterLab-IEU/AlterLab-Academic-Skills --skill alterlab-markitdowngit clone --depth 1 https://github.com/AlterLab-IEU/AlterLab-Academic-Skills.git /tmp/AlterLab-Academic-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/AlterLab-Academic-Skills/skills/document-tools/alterlab-markitdown ~/.claude/skills/alterlab-markitdownPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# MarkItDown - File to Markdown Conversion ## Overview MarkItDown is Microsoft's Python package and CLI for converting documents, media, and web content to Markdown for LLM and text-analysis pipelines. It preserves structure that matters to models (headings, lists, tables, links) and is not meant for high-fidelity, human-facing document conversion. This skill targets **markitdown 0.1.x** (current release 0.1.8, Sept 2026; Python 3.10–3.14). ## When to Use This Skill Use this skill when the user wants to: - Convert a PDF, Word, PowerPoint, Excel, EPUB, HTML, or Outlook file into Markdown for an LLM prompt, RAG index, or text analysis - Batch-convert a folder of mixed document formats - Get a YouTube transcript or audio transcription as Markdown - Describe the images in a document, or pull the text out of scans and embedded images (keyless: Claude reads them) - Expose file conversion to an agent through the `markitdown-mcp` server ### Does NOT Trigger | Scenario | Use Instead | |----------|-------------| | Ingesting many sources into a self-hosted notebook with chat, search, or podcasts | `alterlab-open-notebook` | | Answering questions across the sections, figures, and tables of one PDF | `alterlab-pdf-explore` | | Building a one-row-per-paper evidence table from many PDFs | `alterlab-pdf-extract` | | Managing references, DOIs, or BibTeX libraries | `alterlab-pyzotero` |
Details
- Skill name
alterlab-markitdown- Repository
- AlterLab-IEU/AlterLab-Academic-Skills
- Path
skills/document-tools/alterlab-markitdown/SKILL.md- License
- MIT
- Repo updated
- 11 November 2026
- Listed in
- BehiSecc/awesome-claude-skills
FAQ
What does the Alterlab Markitdown skill do?
Converts files and Office documents to clean, LLM-friendly Markdown with Microsoft MarkItDown (markitdown CLI, Python API, and markitdown-mcp server), supporting PDF, DOCX, PPTX, XLSX/XLS, images (EXIF metadata, descriptions), audio (transcription), HTML, CSV, JSON, XML, ZIP archives, EPUB e-books, Outlook MSG, Jupyter notebooks, and YouTube transcript URLs. No API key needed — embedded images are extracted for Claude to describe and transcribe itself; an OpenRouter/OpenAI vision model, the markitdown-ocr plugin, or Azure Document Intelligence are optional. Use when converting a document, PDF,
How do I install the Alterlab Markitdown skill?
Claude Code plugin: /plugin marketplace add AlterLab-IEU/AlterLab-Academic-Skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Alterlab Markitdown popular?
It lives in AlterLab-IEU/AlterLab-Academic-Skills, which has 87 GitHub stars and 18 forks, and is included in 1 curated skill list.
Related skills
Alterlab Abm Mesa
87AlterLab-IEU/AlterLab-Academic-Skills
Builds agent-based models of social systems with Mesa 3 — the current AgentSet API (model.agents.shuffle_do('step'), auto-assigned unique_id, mandatory super().__init__(rng=...)), cell spaces (mesa.discrete_space OrthogonalMooreGrid / classic mesa.space grids), the DataCollector, batch_run parameter sweeps, and SolaraViz — for emergence, segregation, diffusion, opinion dynamics, and cooperation models. It uses the Mesa 3.x API (the old mesa.time schedulers like RandomActivation are removed) and treats the model as a generative theory to be validated, not just run. Use when the request mentions
Alterlab Academic Career
87AlterLab-IEU/AlterLab-Academic-Skills
Prepares academic career documents and professional-development materials for faculty and researchers. Use when drafting academic CVs, research statements, teaching philosophies, diversity statements, faculty-position cover letters, tenure dossiers, promotion narratives, academic portfolios, or mentorship statements, and when planning conference-networking strategy, building academic web presence, setting up ORCID profiles, or understanding impact metrics. Part of the AlterLab Academic Skills suite.
Alterlab Accreditation Aol
87AlterLab-IEU/AlterLab-Academic-Skills
Scaffolds program-level Assurance-of-Learning (AoL) documentation for AACSB (Standard 5 in the 2020 standards and the 2026 Global Standards) and ABET (Criterion 3 Student Outcomes, Criterion 4 Continuous Improvement) accreditation — program learning outcomes / competency goals, curriculum-to-outcome mapping matrices, direct- and indirect-assessment plans, rubric design, and closing-the-loop continuous-improvement narratives — and validates the structure of an outcome-mapping matrix with scripts/aol_matrix.py. Use when the user needs AACSB or ABET assurance-of-learning material, a program-learn
Alterlab Pathml
87AlterLab-IEU/AlterLab-Academic-Skills
Run full computational-pathology workflows with PathML — whole-slide-image (WSI) analysis across 160+ slide formats, multiplexed immunofluorescence (CODEX, Vectra, MERFISH), nucleus segmentation/classification (HoVer-Net, HACTNet), tissue- and cell-graph construction, HDF5 dataset management, and deep-learning model training on pathology data. Use when the user builds end-to-end deep-learning pathology pipelines, analyzes multiplexed or spatial-proteomics slides, or segments nuclei. For lightweight H&E slide preprocessing, tissue masking, or plain Random/Grid/Score tile extraction prefer alter
Alterlab Latex Posters
87AlterLab-IEU/AlterLab-Academic-Skills
Creates professional research posters in LaTeX using beamerposter, tikzposter, or baposter — handles layout design, color schemes, multi-column formats, figure integration, and poster-specific visual-communication best practices. Use when building a conference or academic poster in LaTeX (the default for a research poster when no format is named). For PowerPoint/PPTX or HTML poster output prefer alterlab-pptx-posters; to auto-generate a poster, website, or video straight from a finished paper use alterlab-paper-2-web. Part of the AlterLab Academic Skills suite.
Alterlab PDF Explore
87AlterLab-IEU/AlterLab-Academic-Skills
Explore a single PDF in depth — parse it once, then answer questions across its sections, figures, tables, and appendices — comparing methods across sections, extracting every instance of a pattern within the document, and reading values off its charts and tables. Use when interrogating one paper or report end-to-end, pulling every occurrence of something inside a document, or reading data from a figure/table in a PDF, serving the literature-review and paper-review pipeline. To build a comparison table across MANY papers prefer alterlab-pdf-extract; to simply convert a PDF to Markdown prefer a
Browse the most popular Claude skills, all documents & office files skills, or write your own with the skills generator.