✨ What is Markdown Exporter?
Markdown Exporter is a Agent Skill that transforms your Markdown text into a wide variety of professional formats. Whether you need to create polished reports, stunning presentations, organized spreadsheets, or code files—this tool has you covered.
Tools and Supported Formats Prerequisites
To use the Markdown Exporter skill, ensure you have the following prerequisites installed:
Python 3.11 or higher (optional) uv package manager 📦 Usage Overview
All scripts provided in this project are Python scripts located in the scripts/ directory. All required Python dependencies are declared in the project's pyproject.toml file.
Recommended Execution Method - Using Bash Scripts
We strongly recommend using the bash scripts located in the scripts/ directory. These scripts provide a seamless experience by automatically handling dependency management and execution:
Automatic Dependency Management: When you run a bash script from the scripts/ directory, it will:
First check if the uv package manager is installed If uv is available, it will use uv run to automatically install dependencies and execute the Python script in one step If uv is not available, it will fall back to using pip to install dependencies from requirements.txt before executing the script Check that Python 3.11 or higher is installed (when using pip fallback)
Execute scripts with bash:
scripts/md-exporter
Alternative Execution Method - Direct Python Execution
You can also run the Python scripts directly, but you'll need to manage dependencies yourself:
Using uv (recommended if running directly):
uv run python scripts/parser/
Using pip:
Install dependencies first
pip install -r requirements.txt
Then run the script
python scripts/parser/
Important Notes Always navigate to the root directory of the project before executing any scripts. The bash scripts in scripts/ provide the most convenient way to run the tools, as they handle all dependency management automatically. All scripts only support file paths as input 🔧 Scripts md_to_csv - Convert Markdown tables to CSV
Converts Markdown tables to CSV format.
Usage:
scripts/md-exporter md_to_csv
Arguments:
input - Input Markdown file path output - Output CSV file path
Options:
--strip-wrapper - Remove code block wrapper if present
Example:
scripts/md-exporter md_to_csv /path/input.md /path/output.csv
md_to_pdf - Convert Markdown to PDF
Converts Markdown text to PDF format with support for Chinese, Japanese, and other languages.
Usage:
scripts/md-exporter md_to_pdf
Arguments:
input - Input Markdown file path output - Output PDF file path
Options:
--strip-wrapper - Remove code block wrapper if present
Example:
scripts/md-exporter md_to_pdf /path/input.md /path/output.pdf
md_to_docx - Convert Markdown to DOCX
Converts Markdown text to DOCX format using pandoc.
Usage:
scripts/md-exporter md_to_docx
Arguments:
input - Input Markdown file path output - Output DOCX file path
Options:
--template - Path to DOCX template file (optional) --strip-wrapper - Remove code block wrapper if present
Example:
scripts/md-exporter md_to_docx /path/input.md /path/output.docx scripts/md-exporter md_to_docx /path/input.md /path/output.docx --template /path/template.docx
md_to_xlsx - Convert Markdown tables to XLSX
Converts Markdown tables to XLSX format with multiple sheets support.
Usage:
scripts/md-exporter md_to_xlsx
Arguments:
input - Input Markdown file path output - Output XLSX file path
Options:
--force-text - Convert cell values to text type (default: True) --strip-wrapper - Remove code block wrapper if present
Example:
scripts/md-exporter md_to_xlsx /path/input.md /path/output.xlsx
md_to_pptx - Convert Markdown to PPTX
Converts Markdown text to PPTX format using md2pptx.
Usage:
scripts/md-exporter md_to_pptx
Arguments:
input - Input Markdown file path output - Output PPTX file path
Options:
--template - Path to PPTX template file (optional)
Example:
scripts/md-exporter md_to_pptx /path/input.md /path/output.pptx
md_to_codeblock - Extract Codeblocks to Files
Extracts code blocks from Markdown and saves them as individual files.
Usage:
scripts/md-exporter md_to_codeblock
Arguments:
input - Input Markdown file path output - Output file or directory path
Options:
--compress - Compress all code blocks into a ZIP file
Example:
scripts/md-exporter md_to_codeblock /path/input.md /path/output_dir scripts/md-exporter md_to_codeblock /path/input.md /path/output.zip --compress
md_to_json - Convert Markdown Tables to JSON
Converts Markdown tables to JSON or JSONL format.
Usage:
scripts/md-exporter md_to_json
Arguments:
input - Input Markdown file path output - Output JSON file path
Options:
--style - JSON output style: jsonl (default) or json_array --strip-wrapper - Remove code block wrapper if present
Example:
scripts/md-exporter md_to_json /path/input.md /path/output.json scripts/md-exporter md_to_json /path/input.md /path/output.json --style json_array
md_to_xml - Convert Markdown to XML
Converts Markdown text to XML format.
Usage:
scripts/md-exporter md_to_xml
Arguments:
input - Input Markdown file path output - Output XML file path
Options:
--strip-wrapper - Remove code block wrapper if present
Example:
scripts/md-exporter md_to_xml /path/input.md /path/output.xml
md_to_latex - Convert Markdown Tables to LaTeX
Converts Markdown tables to LaTeX format.
Usage:
scripts/md-exporter md_to_latex
Arguments:
input - Input Markdown file path output - Output LaTeX file path
Options:
--strip-wrapper - Remove code block wrapper if present
Example:
scripts/md-exporter md_to_latex /path/input.md /path/output.tex
md_to_html - Convert Markdown to HTML
Converts Markdown text to HTML format using pandoc.
Usage:
scripts/md-exporter md_to_html
Arguments:
input - Input Markdown file path output - Output HTML file path
Options:
--strip-wrapper - Remove code block wrapper if present
Example:
scripts/md-exporter md_to_html /path/input.md /path/output.html
md_to_html_text - Convert Markdown to HTML Text
Converts Markdown text to HTML and outputs to stdout.
Usage:
scripts/md-exporter md_to_html_text
Arguments:
input - Input Markdown file path
Example:
scripts/md-exporter md_to_html_text /path/input.md
md_to_png - Convert Markdown to PNG Images
Converts Markdown text to PNG images (one per page).
Usage:
scripts/md-exporter md_to_png
Arguments:
input - Input Markdown file path output - Output PNG file path or directory path
Options:
--compress - Compress all PNG images into a ZIP file --strip-wrapper - Remove code block wrapper if present
Example:
scripts/md-exporter md_to_png /path/input.md /path/output.png scripts/md-exporter md_to_png /path/input.md /path/output.png --compress
md_to_md - Convert Markdown to MD File
Saves Markdown text to a .md file.
Usage:
scripts/md-exporter md_to_md
Arguments:
input - Input Markdown file path output - Output MD file path
Example:
scripts/md-exporter md_to_md /path/input.md /path/output.md
md_to_linked_image - Extract Image Links to Files
Extracts image links from Markdown and downloads them as files.
Usage:
scripts/md-exporter md_to_linked_image
Arguments:
input - Input Markdown file path output - Output file or directory path
Options:
--compress - Compress all images into a ZIP file
Example:
scripts/md-exporter md_to_linked_image /path/input.md /path/output_dir scripts/md-exporter md_to_linked_image /path/input.md /path/output.zip --compress
📝 Notes All scripts only support file paths as input For scripts that generate multiple files (e.g., multiple tables, multiple code blocks), the output filename will be automatically numbered Use the --strip-wrapper option to remove code block wrappers (```) from the input Markdown For PPTX conversion, ensure the md2pptx directory is available in the tools/md_to_pptx/ directory