markitdown-file-to-markdown

name	markitdown-file-to-markdown
description	Convert local files and office documents into Markdown using Microsoft MarkItDown. Use when the user asks to convert a PDF, DOCX, PPTX, XLSX, HTML, CSV, JSON, XML, EPUB, or similar local file into Markdown, including generic requests to "use MarkItDown" or "convert this document/file to Markdown".

MarkItDown File To Markdown

Use this skill to convert a local file into reusable Markdown in any workspace.

Default behavior:

• Use MarkItDown as the only conversion engine.
• Write the final Markdown next to the source file unless the user provides a destination.
• Keep the MarkItDown body as close as possible to the raw conversion.
• Add a metadata block at the top, but avoid rewriting the document into a separate summary structure unless the user explicitly asks for that.

Workflow

1. Verify the source file exists and is a local path.
2. Infer the file type from the extension and fail clearly if the file is obviously unsupported.
3. Run bash scripts/run_markitdown.sh "<source-path>" from this skill directory to get the raw MarkItDown conversion.
4. Inspect the raw Markdown before writing anything. If the conversion fails, is empty, or is clearly unusable, stop and report the failure.
5. Build the final Markdown by prepending a metadata block when source metadata is available, then keep the MarkItDown output body substantially intact.
6. Apply only minimal cleanup when needed for readability:
   • normalize an obviously bad title derived from the filename if better metadata is unavailable
   • remove accidental leading or trailing empty noise
   • keep page breaks, lists, headings, and extracted wording unless the user asks for a rewrite
   • add a short note only when a conversion caveat is important enough that the raw body would otherwise be misleading
7. Default the output path to a sibling Markdown file with the same basename as the source file.