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