markdown-converter

Convert local PDF, Office, HTML, and media files to Markdown using MarkItDown.

55|41|Updated Aug 9, 2026
One-click install
npx skills add https://github.com/Rylaispirit/rylai-codex-hermes-skills --skill markdown-converter-rylaispirit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: markdown-converter
Source: https://github.com/Rylaispirit/rylai-codex-hermes-skills/tree/main/skills/markdown-converter
Command: npx skills add https://github.com/Rylaispirit/rylai-codex-hermes-skills --skill markdown-converter-rylaispirit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markitdown, and includes scripts (resource) components.

What problem does it solve? Converting documents like PDFs, Word files, spreadsheets, and HTML pages into clean Markdown for notes, documentation, or LLM ingestion usually requires manual copy-pasting or ad-hoc tools. This Skill wraps MarkItDown with guarded input handling so local files convert safely without overwriting sources or accepting untrusted remote URLs. ## Core Features & Use Cases - Single-File Conversion: Convert one local file (PDF, DOCX, XLSX, HTML, images, audio, archives) to a validated UTF-8 Markdown file with atomic writes. - Batch Folder Conversion: Recursively convert an entire directory, mirroring relative paths and filtering by extension with --include flags. - Safety Guardrails: Rejects URI inputs, prevents source overwrite, requires explicit --overwrite for existing destinations, and keeps MarkItDown plugins disabled. - Use Case: You have a folder of 50 PDF reports and DOCX memos. Run the batch command to produce a mirrored directory of Markdown files ready for a knowledge base or RAG pipeline. ## Quick Start Ask the assistant to convert a local file such as report.pdf into report.md using the markdown-converter skill, then verify the output headings and tables.

Frequently Asked Questions about markdown-converter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a PDF or DOCX file to Markdown?▼

Run the wrapper script with the convert command, passing the source path and a .md destination, for example converting report.docx to report.md. The tool invokes MarkItDown, writes to a temporary file, validates the output as UTF-8, and only then replaces the destination.

How do I batch convert a folder of documents to Markdown?▼

Use the batch command with a source directory and output directory, adding --recursive to include subfolders and --include to filter extensions like pdf or docx. The command mirrors relative paths and changes each file extension to .md.

What file formats does MarkItDown support for Markdown conversion?▼

The wrapper accepts local PDF, Office documents, HTML, text, data files, images, archives, and audio files, delegating parsing to MarkItDown. Only local regular files are accepted; HTTP, HTTPS, and other URI-style inputs are rejected.

Why does the conversion fail with a MarkItDown unavailable error?▼

The wrapper requires either an installed markitdown executable or uv with uvx as a fallback. Run the doctor command to check which route is selected, then install markitdown or uv if both are missing.

Can the converter overwrite my original files or existing Markdown?▼

No. The source and destination must be different files, and existing destinations are only replaced when you explicitly pass --overwrite. Conversions write to a temporary file first and atomically replace the destination only after validation.