A versatile document conversion tool that transforms various file formats into clean Markdown for LLM processing and text analysis.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install markdown-converter
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install markdown-converter using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Markdown Converter?
Markdown Converter is a robust utility designed to bridge the gap between proprietary document formats and AI-friendly text. By leveraging the markitdown library via uvx, this skill allows users to transform everything from complex PDFs and Excel spreadsheets to media files with EXIF data into Markdown. It is an essential component for Openclaw Skills users who need to prepare diverse datasets for LLM analysis, search indexing, or structured documentation workflows.
This skill is particularly powerful because it preserves the logical structure of the source material—including headings, tables, and lists—ensuring that the semantic meaning of the document remains intact after conversion. Whether you are dealing with legacy Word documents, PowerPoint presentations, or even YouTube URLs, this tool provides a unified path to high-quality Markdown output.
Markdown Converter Use Cases
- Converting legacy Word documents and PowerPoint presentations into searchable Markdown documentation for Openclaw Skills repositories.
- Extracting data from Excel spreadsheets and CSV files for ingestion into AI-driven data pipelines.
- Processing image and audio files to extract metadata, OCR text, and transcriptions in a text-based format.
- Preparing web content or EPub files for LLM training or RAG-based search systems.
- Rapidly cleaning up HTML and XML files into human-readable Markdown for technical analysis.
How Markdown Converter Works
- The user identifies a source file or provides a stream of data in a supported format like PDF, DOCX, or XLSX.
- The skill invokes the
uvx markitdowncommand, which handles environment provisioning and dependency management on the fly. - The conversion engine parses the document structure, intelligently identifying elements like headers, tables, and nested lists.
- For specialized media files, the skill utilizes OCR or EXIF extraction to generate text descriptions and metadata.
- The finalized Markdown content is output to the terminal or written to a specified
.mdfile for immediate use within Openclaw Skills workflows.
Markdown Converter Setup
To utilize this skill within the Openclaw Skills ecosystem, ensure you have the uv package manager installed. No pre-installation of the converter itself is necessary as it runs via uvx.
# Example: Convert a PDF to Markdown immediately
uvx markitdown input.pdf -o output.md
# Example: Convert a Word document to standard output
uvx markitdown report.docx
Markdown Converter Data Schema & Taxonomy
The Markdown Converter skill produces standardized Markdown output. It organizes data by mapping source document elements to their Markdown equivalents as follows:
| Source Element | Markdown Mapping |
|---|---|
| Headings | H1 through H6 (# to ######) |
| Lists | Unordered (-) and Ordered (1.) lists |
| Tables | GitHub Flavored Markdown (GFM) tables |
| Links | Standard Markdown links text |
| Images | Alt text and extracted EXIF metadata |
| Excel/CSV | Formatted Markdown tables |
| Media | Transcriptions and metadata summaries |
Markdown Converter Advanced Features
- Azure Document Intelligence integration for high-fidelity extraction from complex or low-quality scanned PDFs.
- Support for ZIP archives, enabling the skill to iterate through and convert all compatible files within a compressed folder.
- YouTube URL processing to extract video metadata and descriptions directly into a Markdown summary.
- Hinting system using MIME types and file extensions to correctly process data coming through standard input (stdin).
- Plugin architecture support to enable 3rd-party conversion tools for specialized industry formats.
SKILL.md
Loading
Related Openclaw Skills
Local Places
A local API proxy that enables AI agents to search for venues and resolve geographic locations via the Google Places API.
Instruments Profiling (macOS/iOS)
A comprehensive guide for profiling native Apple platform applications using xctrace and the Instruments suite to eliminate performance bottlenecks.
imsg
A command-line interface for macOS that enables AI agents and developers to interact with iMessage and SMS services programmatically.
goplaces
A modern command-line interface for the Google Places API (New) that provides both human-readable and JSON-structured location data.
mcporter
A CLI utility for interacting with Model Context Protocol (MCP) servers, allowing direct tool execution, authentication, and code generation.
Model Usage
A Python-based utility to parse CodexBar CLI data and summarize costs by specific AI models for granular budget tracking.
Featured*
