Markdown Exporter

✨ What is Markdown Exporter?

Markdown Exporter is a powerful 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:

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

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

md_to_mermaid - Convert Mermaid Diagrams to PNG

Converts Mermaid diagram code blocks in Markdown to PNG images.

Usage:

scripts/md-exporter md_to_mermaid <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_mermaid /path/input.md /path/output.png
scripts/md-exporter md_to_mermaid /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