markdown-converter
Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, or EPubs to Markdown format for LLM processing or text analysis.
Security Assessment
About markdown-converter
The 'markdown-converter' skill provides an easy way to convert a wide range of documents and files into Markdown format using the `uvx markitdown` tool. This skill addresses the need for efficiently transforming diverse file types such as PDFs, Word documents, PowerPoint presentations, Excel spreadsheets, and more into a clean, editable Markdown format. By offering a simple command-line interface, users can streamline the conversion process without needing additional software installations or complicated configurations. It is especially useful for LLM processing and text analysis tasks that require content to be presented in a standardized, machine-readable format.
The skill supports an extensive list of input formats, including documents (PDF, DOCX, PPTX, XLSX), web and data files (HTML, CSV, JSON, XML), media files (Images with EXIF/OCR, audio with transcription), and other content types like ZIP archives and YouTube URLs. The conversion process preserves the document's structure, such as headings, tables, lists, and links, ensuring that the output retains its readability and organization. With options like using Azure Document Intelligence for better PDF extraction, enabling third-party plugins, and providing file type hints, the tool is highly customizable to suit various needs and workflows.
This skill is ideal for users who need to quickly convert multiple file types into Markdown for processing, analysis, or further documentation purposes. It is particularly useful for data analysts, content managers, or developers working with large volumes of diverse content that need to be standardized into Markdown format for machine learning, text parsing, or archiving purposes. Its compatibility with different file types and ease of use make it an essential tool for users across various domains, including research, technical documentation, and content conversion projects.
FAQ
What file formats are supported by markdown-converter?
markdown-converter supports a wide range of file formats including PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, and EPubs.
How do I convert files using markdown-converter?
You can convert files using the `uvx markitdown` command followed by the input file. For example: `uvx markitdown input.pdf` for standard output, or `uvx markitdown input.pdf -o output.md` to save the output to a file.
Can markdown-converter handle complex PDFs with poor extraction?
Yes, for complex PDFs with poor extraction, you can use the `-d` option to enable Azure Document Intelligence, which provides enhanced PDF extraction capabilities.
Are there any additional configuration options for markdown-converter?
Yes, markdown-converter offers several options such as `-o` to specify output file, `-x` to hint the file extension for stdin, `-m` for MIME type hints, and `--use-plugins` to enable third-party plugins.
Do I need to install any software to use markdown-converter?
No, markdown-converter uses `uvx markitdown`, which requires no installation. It works directly from the command line.
Install markdown-converter
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
steipete/agent-scripts