Markdown Exporter

✨ 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

<table> <tr> <th>Tool</​th> <th>Input</​th> <th>Output</​th> </​tr> <tr> <td><code>md_to_docx</​code></​td> <td rowspan="6">📝 Markdown</​td> <td>📄 Word document (.docx)</​td> </​tr> <tr> <td><code>md_to_html</​code></​td> <td>🌐 HTML file (.html)</​td> </​tr> <tr> <td><code>md_to_html_text</​code></​td> <td>🌐 HTML text string</​td> </​tr> <tr> <td><code>md_to_pdf</​code></​td> <td>📑 PDF file (.pdf)</​td> </​tr> <tr> <td><code>md_to_png</​code></​td> <td>🖼️ PNG image(s) of PDF pages</​td> </​tr> <tr> <td><code>md_to_md</​code></​td> <td>📝 Markdown file (.md)</​td> </​tr> <tr> <td><code>md_to_pptx</​code></​td> <td> <div> 📝 Markdown slides </​div> <div> in <a href="https://pandoc.org/MANUAL.html#slide-shows">Pandoc style </​a> </​div> </​td> <td>🎯 PowerPoint (.pptx)</​td> </​tr> <tr> <td><code>md_to_xlsx</​code></​td> <td rowspan="5">📋<a href="https://www.markdownguide.org/extended-syntax/#tables"> Markdown tables </​a> </​td> <td>📊 Excel spreadsheet (.xlsx)</​td> </​tr> <tr> <td><code>md_to_csv</​code></​td> <td>📋 CSV file (.csv)</​td> </​tr> <tr> <td><code>md_to_json</​code></​td> <td>📦 JSON/​JSONL file (.json)</​td> </​tr> <tr> <td><code>md_to_xml</​code></​td> <td>🏷️ XML file (.xml)</​td> </​tr> <tr> <td><code>md_to_latex</​code></​td> <td>📝 LaTeX file (.tex)</​td> </​tr> <tr> <td><code>md_to_codeblock</​code></​td> <td>💻 <a href="https://www.markdownguide.org/extended-syntax/#fenced-code-blocks"> Code blocks in Markdown </​a> </​td> <td>📁 Code files by language (.py, .js, .sh, etc.)</​td> </​tr> <tr> <td><code>md_to_linked_image</​code></​td> <td>🖼️ <a href="https://www.markdownguide.org/basic-syntax/#linking-images">Image links in Markdown</​a> </​td> <td>🖼️ Downloaded image files</​td> </​tr>

</​table>

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:

1. 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)

2. Execute scripts with bash:

   scripts/​md-exporter <script_name> <args> [options]
   

Alternative Execution Method - Direct Python Execution

You can also run the Python scripts directly, but you'll need to manage dependencies yourself:

1. Using uv (recommended if running directly):

   uv run python scripts/​parser/<script_name>.py <args> [options]
   

2. Using pip:

   # Install dependencies first
   pip install -r requirements.txt
   # Then run the script
   python scripts/​parser/<script_name>.py <args> [options]
   

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 <input> <output> [options]

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 <input> <output> [options]

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 <input> <output> [options]

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 <input> <output> [options]

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 pandoc.

Usage:

scripts/​md-exporter md_to_pptx <input> <output> [options]

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 <input> <output> [options]

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 <input> <output> [options]

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 <input> <output> [options]

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 <input> <output> [options]

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 <input> <output> [options]

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 <input>

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 <input> <output> [options]

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 <input> <output>

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 <input> <output> [options]

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