Markdown Exporter

Markdown Exporter

Markdown Exporter is an Agent Skill that transforms your Markdown text into a wide variety of professional format files.

This SKILL.md for Agent Skills, the cli tool and Python package markdown-exporter are maintained in the GitHub repository bowenliang123/markdown-exporter by bowenliang123.

Tools and Supported Formats

📦 Usage

Overview

Markdown Exporter is available as a PyPI package, which provides a seamless command-line interface for all its functionality.

Installation

bashCopy code
# with pip
pip install md-exporter

# with uv 
uv tool install md-exporter

# on OpenClaw
npx clawhub install markdown-exporter

Check markdown-exporter command and usages:

Copy code
markdown-exporter -h

markdown-exporter <subcommand> -h

Basic Usage

Use the markdown-exporter command to access all the tools:

bashCopy code
markdown-exporter <subcommand> <args> [options]

Important Notes

• All commands only support file paths as input
• The package handles all dependency management automatically
• You can run the command from anywhere in your system, no need to navigate to the project directory

🔧 Scripts

md_to_csv - Convert Markdown tables to CSV

Converts Markdown tables to CSV format file.

Usage:

bashCopy code
markdown-exporter md_to_csv <input> <output> [options]

Arguments:

• input - Input Markdown file path containing tables
• output - Output CSV file path

Options:

• --strip-wrapper - Remove code block wrapper if present

Examples:

1. Basic conversion:

   bashCopy code
   markdown-exporter md_to_csv /path/input.md /path/output.csv
   

   This converts all tables in the input Markdown file to CSV format.

2. With code block wrapper removal:

   bashCopy code
   markdown-exporter md_to_csv /path/input.md /path/output.csv --strip-wrapper
   

   This removes any code block wrappers (```) before processing the Markdown.

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_pdf - Convert Markdown to PDF

Converts Markdown text to PDF format with support for Chinese, Japanese, and other languages.

Usage:

bashCopy code
markdown-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

Examples:

1. Basic conversion:

   bashCopy code
   markdown-exporter md_to_pdf /path/input.md /path/output.pdf
   

   This converts the entire Markdown file to a PDF document.

2. With code block wrapper removal:

   bashCopy code
   markdown-exporter md_to_pdf /path/input.md /path/output.pdf --strip-wrapper
   

   This removes any code block wrappers (```) before processing the Markdown.

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_png - Convert Markdown to PNG

Converts Markdown text to PNG image(s), with support for Chinese, Japanese, and other languages.

Usage:

bashCopy code
markdown-exporter md_to_png <input> <output> [options]

Arguments:

• input - Input Markdown file path
• output - Output PNG file path

Options:

• --multi-page - Export one PNG per A4 page (numbered files) instead of a single long-page PNG
• --strip-wrapper - Remove code block wrapper if present

Examples:

1. Basic conversion (single long-page image):

   bashCopy code
   markdown-exporter md_to_png /path/input.md /path/output.png
   

   This renders the entire Markdown document as a single long-page PNG image.

2. Multi-page output:

   bashCopy code
   markdown-exporter md_to_png /path/input.md /path/output.png --multi-page
   

   This exports one PNG per A4 page, saved as output_1.png, output_2.png, etc. when the document has multiple pages.

3. With code block wrapper removal:

   bashCopy code
   markdown-exporter md_to_png /path/input.md /path/output.png --strip-wrapper
   

   This removes any code block wrappers (```) before processing the Markdown.

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_svg - Convert Markdown to SVG

Converts Markdown text to SVG image(s), one SVG per page, with support for Chinese, Japanese, and other languages.

Usage:

bashCopy code
markdown-exporter md_to_svg <input> <output> [options]

Arguments:

• input - Input Markdown file path
• output - Output SVG file path

Options:

• --strip-wrapper - Remove code block wrapper if present

Examples:

1. Basic conversion:

   bashCopy code
   markdown-exporter md_to_svg /path/input.md /path/output.svg
   

   This converts the Markdown file to SVG image(s), saved as output_1.svg, output_2.svg, etc. when the document has multiple pages.

2. With code block wrapper removal:

   bashCopy code
   markdown-exporter md_to_svg /path/input.md /path/output.svg --strip-wrapper
   

   This removes any code block wrappers (```) before processing the Markdown.

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_docx - Convert Markdown to DOCX

Converts Markdown text to DOCX format file.

Usage:

bashCopy code
markdown-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

Examples:

1. Basic conversion:

   bashCopy code
   markdown-exporter md_to_docx /path/input.md /path/output.docx
   

   This converts the entire Markdown file to a DOCX document.

2. With custom template:

   bashCopy code
   markdown-exporter md_to_docx /path/input.md /path/output.docx --template /path/template.docx
   

   This uses a custom DOCX template for styling.

3. With code block wrapper removal:

   bashCopy code
   markdown-exporter md_to_docx /path/input.md /path/output.docx --strip-wrapper
   

   This removes any code block wrappers (```) before processing the Markdown.

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_xlsx - Convert Markdown tables to XLSX

Converts Markdown tables to XLSX format with multiple sheets support.

Usage:

bashCopy code
markdown-exporter md_to_xlsx <input> <output> [options]

Arguments:

• input - Input Markdown file path containing tables
• output - Output XLSX file path

Options:

• --force-text - Convert cell values to text type (default: True)
• --strip-wrapper - Remove code block wrapper if present

Examples:

1. Basic conversion:

   bashCopy code
   markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx
   

   This converts all tables in the input Markdown file to an XLSX workbook, with each table on a separate sheet.

2. With code block wrapper removal:

   bashCopy code
   markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx --strip-wrapper
   

   This removes any code block wrappers (```) before processing the Markdown.

3. With force-text disabled:

   bashCopy code
   markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx --force-text False
   

   This allows Excel to automatically determine cell types.

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_pptx - Convert Markdown to PPTX

Converts Markdown text to PPTX format file.

Usage:

bashCopy code
markdown-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)

Examples:

1. Basic conversion:

   bashCopy code
   markdown-exporter md_to_pptx /path/input.md /path/output.pptx
   

   This converts the Markdown file to a PowerPoint presentation.

2. With custom template:

   bashCopy code
   markdown-exporter md_to_pptx /path/input.md /path/output.pptx --template /path/template.pptx
   

   This uses a custom PowerPoint template for styling.

Sample Markdown Input: Use the "Slides (for PPTX)" example from the Sample Markdown Inputs - Slides (for PPTX) section below.

md_to_codeblock - Extract Codeblocks to Files

Extracts code blocks from Markdown and saves them as individual files.

Usage:

bashCopy code
markdown-exporter md_to_codeblock <input> <output> [options]

Arguments:

• input - Input Markdown file path containing code blocks
• output - Output directory path or ZIP file path

Options:

• --compress - Compress all code blocks into a ZIP file

Examples:

1. Extract to directory:

   bashCopy code
   markdown-exporter md_to_codeblock /path/input.md /path/output_dir
   

   This extracts all code blocks to individual files in the specified directory.

2. Extract to ZIP file:

   bashCopy code
   markdown-exporter md_to_codeblock /path/input.md /path/output.zip --compress
   

   This extracts all code blocks and compresses them into a ZIP file.

Sample Markdown Input: Use the "Code Blocks" example from the Sample Markdown Inputs - Code Blocks section below.

md_to_json - Convert Markdown Tables to JSON

Converts Markdown tables to JSON or JSONL format file.

Usage:

bashCopy code
markdown-exporter md_to_json <input> <output> [options]

Arguments:

• input - Input Markdown file path containing tables
• output - Output JSON file path

Options:

• --style - JSON output style: jsonl (default) or json_array
• --strip-wrapper - Remove code block wrapper if present

Examples:

1. Basic conversion (JSONL format):

   bashCopy code
   markdown-exporter md_to_json /path/input.md /path/output.json
   

   This converts tables to JSON Lines format (one JSON object per line).

2. Convert to JSON array:

   bashCopy code
   markdown-exporter md_to_json /path/input.md /path/output.json --style json_array
   

   This converts tables to a single JSON array of objects.

3. With code block wrapper removal:

   bashCopy code
   markdown-exporter md_to_json /path/input.md /path/output.json --strip-wrapper
   

   This removes any code block wrappers (```) before processing the Markdown.

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_xml - Convert Markdown to XML

Converts Markdown text to XML format file.

Usage:

bashCopy code
markdown-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

Examples:

1. Basic conversion:

   bashCopy code
   markdown-exporter md_to_xml /path/input.md /path/output.xml
   

   This converts the entire Markdown file to an XML document.

2. With code block wrapper removal:

   bashCopy code
   markdown-exporter md_to_xml /path/input.md /path/output.xml --strip-wrapper
   

   This removes any code block wrappers (```) before processing the Markdown.

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_latex - Convert Markdown Tables to LaTeX

Converts Markdown tables to LaTeX format file.

Usage:

bashCopy code
markdown-exporter md_to_latex <input> <output> [options]

Arguments:

• input - Input Markdown file path containing tables
• output - Output LaTeX file path

Options:

• --strip-wrapper - Remove code block wrapper if present

Examples:

1. Basic conversion:

   bashCopy code
   markdown-exporter md_to_latex /path/input.md /path/output.tex
   

   This converts all tables in the input Markdown file to LaTeX format.

2. With code block wrapper removal:

   bashCopy code
   markdown-exporter md_to_latex /path/input.md /path/output.tex --strip-wrapper
   

   This removes any code block wrappers (```) before processing the Markdown.

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_html - Convert Markdown to HTML

Converts Markdown text to HTML format file.

Usage:

bashCopy code
markdown-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

Examples:

1. Basic conversion:

   bashCopy code
   markdown-exporter md_to_html /path/input.md /path/output.html
   

   This converts the entire Markdown file to an HTML document.

2. With code block wrapper removal:

   bashCopy code
   markdown-exporter md_to_html /path/input.md /path/output.html --strip-wrapper
   

   This removes any code block wrappers (```) before processing the Markdown.

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_html_text - Convert Markdown to HTML Text

Converts Markdown text to HTML and outputs to stdout.

Usage:

bashCopy code
markdown-exporter md_to_html_text <input>

Arguments:

• input - Input Markdown file path

Example:

bashCopy code
markdown-exporter md_to_html_text /path/input.md

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_jira - Convert Markdown to Jira Wiki Markup

Converts Markdown text to Jira wiki markup and outputs to stdout.

Usage:

bashCopy code
markdown-exporter md_to_jira <input>

Arguments:

• input - Input Markdown file path

Example:

bashCopy code
markdown-exporter md_to_jira /path/input.md

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_md - Convert Markdown to MD File

Saves Markdown text to a .md file.

Usage:

bashCopy code
markdown-exporter md_to_md <input> <output>

Arguments:

• input - Input Markdown file path
• output - Output MD file path

Example:

bashCopy code
markdown-exporter md_to_md /path/input.md /path/output.md

Sample Markdown Input: Use the "Basic Text and Tables" example from the Sample Markdown Inputs - Basic Text and Tables section below.

md_to_ipynb - Convert Markdown to IPYNB

Converts Markdown text to Jupyter Notebook (.ipynb) format file.

Usage:

bashCopy code
markdown-exporter md_to_ipynb <input> <output> [options]

Arguments:

• input - Input Markdown file path
• output - Output IPYNB file path

Options:

• --strip-wrapper - Remove code block wrapper if present

Examples:

1. Basic conversion:

   bashCopy code
   markdown-exporter md_to_ipynb /path/input.md /path/output.ipynb
   

   This converts the Markdown file to a Jupyter Notebook format.

2. With code block wrapper removal:

   bashCopy code
   markdown-exporter md_to_ipynb /path/input.md /path/output.ipynb --strip-wrapper
   

   This removes any code block wrappers (```) before processing the Markdown.

Sample Markdown Input: Use the "Code Blocks" example from the Sample Markdown Inputs - Code Blocks section below.

Sample Markdown Inputs

To help you test the various tools, below are common Markdown input examples that represent the content of input files:

Basic Text and Tables

markdownCopy code
# Test Markdown File

This is a test markdown file for testing various export tools.

## Table Test

| Name | Description | Price |
|------|-------------|-------|
| Item 1 | First item | $10 |
| Item 2 | Second item | $20 |
| Item 3 | Third item | $30 |

## Text Test

This is a paragraph with **bold** and *italic* text.

- List item 1
- List item 2
- List item 3

> This is a blockquote.

Code Blocks

markdownCopy code
# Test Markdown File

## Code Block Test

```python
print("Hello, World!")
def add(a, b):
    return a + b

# Test the function
result = add(5, 3)
print(f"Result: {result}")
```

```bash
# Bash script example
echo "Hello from Bash"
ls -la
```

```javascript
// JavaScript example
console.log("Hello from JavaScript");
function multiply(a, b) {
    return a * b;
}
```

Slides (for PPTX)

markdownCopy code
---
title: Markdown Exporter
author: Bowen Liang
---

# Introduction

## Welcome Slide

Welcome to our Markdown Exporter!

::: notes
Remember to greet the audience warmly.
:::

---

# Section 1: Basic Layouts

## Title and Content

- This is a basic slide with bullet points
- It uses the "Title and Content" layout
- Perfect for simple content presentation

## Two Column Layout

::::: columns
::: column
Left column content:
- Point 1
- Point 2
:::
::: column
Right column content:
- Point A
- Point B
:::
:::::

## Comparison Layout

::::: columns
::: column
Text followed by an image:

![Test Image](https://example.com/image.jpg)
:::
::: column
- This triggers the "Comparison" layout
- Useful for side-by-side comparisons
:::
:::::

## Content with Caption

Here's some explanatory text about the image below.

![Test Image](https://example.com/image.jpg "fig:Test Image")

---

# Section 2: Advanced Features

## Code Block

Here's a Python code block:

```python
def greet(name):
    return f"Hello, {name}!"

print(greet("World"))
```

## Table Example

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Row 1    | Data     | More     |
| Row 2    | Info     | Stuff    |

## Incremental List

::: incremental
- This point appears first
- Then this one
- And finally this one
:::

## {background-image="https://example.com/image.jpg"}

::: notes
This is a slide with a background image and speaker notes only.
The "Blank" layout will be used.
:::

# Conclusion

## Thank You

Thank you for viewing this kitchen sink presentation!

::: notes
Remember to thank the audience and invite questions.
:::

📝 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