markdown-exporter

Category: Development & Coding | Uploader: bowenliang123 | Downloads: 0 | Version: v1.0（Latest）

Convert Markdown text to DOCX, PPTX, XLSX, PDF, PNG, HTML, IPYNB, MD, CSV, JSON, JSONL, XML files, and extract code blocks in Markdown to Python, Bash,JS and etc files.

Changelog: Source: GitHub https://github.com/bowenliang123/markdown-exporter

Directory Structure

Current level: Root

📁 .claude-plugin/
- 📄 marketplace.json 527 B
- 📄 plugin.json 648 B
📁 .github/
- 📁 workflows/
  - 📄 auto-pr.yml 5.7 KB
  - 📄 python-publish.yml 2.5 KB
📁 _assets/
- 📁 screenshots/
  - 📄 img13.png 16.8 KB
  - 📄 md_to_csv_1.png 21.6 KB
  - 📄 md_to_docx_1.png 247.3 KB
  - 📄 md_to_html_1.png 229.5 KB
  - 📄 md_to_ipynb_1.png 42.5 KB
  - 📄 md_to_json_1.png 48.1 KB
  - 📄 md_to_json_2.png 31.8 KB
  - 📄 md_to_latex_1.png 190.5 KB
  - 📄 md_to_latex_2.png 57.7 KB
  - 📄 md_to_pdf_1.png 108.0 KB
  - 📄 md_to_png_1.png 184.1 KB
  - 📄 md_to_pptx_1.png 119.4 KB
  - 📄 md_to_rst_1.png 355.6 KB
  - 📄 md_to_xlsx_1.png 181.4 KB
  - 📄 md_to_xml_1.png 155.5 KB
  - 📄 usage_md_to_codeblock_1.png 152.6 KB
  - 📄 usage_md_to_codeblock_2.png 493.6 KB
  - 📄 usage_md_to_codeblock_3.png 36.3 KB
  - 📄 usage_md_to_codeblock_4.png 6.4 KB
  - 📄 usage_md_to_docx.png 63.5 KB
  - 📄 usage_md_to_linked_image_1.png 35.4 KB
  - 📄 usage_md_to_xlsx.png 22.6 KB
- 📄 icon.png 10.8 KB
📁 dev/
- 📄 bump-version.sh 682 B
- 📄 pack-clawhub.sh 1.5 KB
- 📄 pack-dify-plugin.sh 117 B
- 📄 reformat.sh 66 B
- 📄 test.sh 39 B
- 📄 uv-sync-with-dify.sh 75 B
- 📄 uv-sync.sh 62 B
📁 md_exporter/
- 📁 assets/
  - 📁 template/
    
    📄 docx_template.docx 15.3 KB
    
    📄 pptx_template.pptx 33.0 KB
- 📁 parser/
  - 📄 cli_md_to_codeblock.py 1.4 KB
  - 📄 cli_md_to_csv.py 1.3 KB
  - 📄 cli_md_to_docx.py 1.8 KB
  - 📄 cli_md_to_html.py 1.4 KB
  - 📄 cli_md_to_html_text.py 1.0 KB
  - 📄 cli_md_to_ipynb.py 1.4 KB
  - 📄 cli_md_to_json.py 1.5 KB
  - 📄 cli_md_to_latex.py 1.3 KB
  - 📄 cli_md_to_md.py 1.1 KB
  - 📄 cli_md_to_pdf.py 1.3 KB
  - 📄 cli_md_to_png.py 1.4 KB
  - 📄 cli_md_to_pptx.py 1.3 KB
  - 📄 cli_md_to_xlsx.py 1.5 KB
  - 📄 cli_md_to_xml.py 1.3 KB
- 📁 services/
  - 📄 __init__.py 0 B
  - 📄 svc_md_to_codeblock.py 5.1 KB
  - 📄 svc_md_to_csv.py 2.1 KB
  - 📄 svc_md_to_docx.py 2.7 KB
  - 📄 svc_md_to_html.py 971 B
  - 📄 svc_md_to_html_text.py 872 B
  - 📄 svc_md_to_ipynb.py 2.2 KB
  - 📄 svc_md_to_json.py 2.0 KB
  - 📄 svc_md_to_latex.py 1.6 KB
  - 📄 svc_md_to_md.py 909 B
  - 📄 svc_md_to_pdf.py 2.0 KB
  - 📄 svc_md_to_png.py 4.9 KB
  - 📄 svc_md_to_pptx.py 2.6 KB
  - 📄 svc_md_to_xlsx.py 1.9 KB
  - 📄 svc_md_to_xml.py 1.2 KB
- 📁 utils/
  - 📄 __init__.py 981 B
  - 📄 file_utils.py 726 B
  - 📄 logger_utils.py 697 B
  - 📄 markdown_utils.py 1.5 KB
  - 📄 mimetype_utils.py 1.9 KB
  - 📄 pandoc_utils.py 2.5 KB
  - 📄 param_utils.py 1.1 KB
  - 📄 table_utils.py 2.4 KB
  - 📄 text_utils.py 919 B
- 📄 __init__.py 0 B
- 📄 cli.py 2.5 KB
📁 provider/
- 📄 md_exporter.py 1.9 KB
- 📄 md_exporter.yaml 1.3 KB
📁 test/
- 📁 cli/
  - 📄 common_test_runner_pypi.sh 4.3 KB
  - 📄 run_all_tests_pypi.sh 4.3 KB
  - 📄 test_cli_md_to_codeblock.sh 259 B
  - 📄 test_cli_md_to_csv.sh 253 B
  - 📄 test_cli_md_to_docx.sh 250 B
  - 📄 test_cli_md_to_html.sh 250 B
  - 📄 test_cli_md_to_html_text.sh 255 B
  - 📄 test_cli_md_to_ipynb.sh 259 B
  - 📄 test_cli_md_to_json.sh 256 B
  - 📄 test_cli_md_to_latex.sh 257 B
  - 📄 test_cli_md_to_md.sh 244 B
  - 📄 test_cli_md_to_pdf.sh 247 B
  - 📄 test_cli_md_to_png.sh 247 B
  - 📄 test_cli_md_to_pptx.sh 255 B
  - 📄 test_cli_md_to_xlsx.sh 256 B
  - 📄 test_cli_md_to_xml.sh 247 B
- 📁 resources/
  - 📄 example_md.md 570 B
  - 📄 example_md_ipynb.md 652 B
  - 📄 example_md_pptx.md 1.7 KB
  - 📄 example_md_table.md 152 B
- 📁 skills/
  - 📄 test_base.py 3.5 KB
  - 📄 test_md_to_codeblock.py 470 B
  - 📄 test_md_to_csv.py 455 B
  - 📄 test_md_to_docx.py 859 B
  - 📄 test_md_to_html.py 453 B
  - 📄 test_md_to_html_text.py 460 B
  - 📄 test_md_to_ipynb.py 463 B
  - 📄 test_md_to_json.py 459 B
  - 📄 test_md_to_latex.py 461 B
  - 📄 test_md_to_md.py 445 B
  - 📄 test_md_to_pdf.py 449 B
  - 📄 test_md_to_png.py 449 B
  - 📄 test_md_to_pptx.py 458 B
  - 📄 test_md_to_xlsx.py 459 B
  - 📄 test_md_to_xml.py 449 B
📁 tools/
- 📁 md_to_codeblock/
  - 📄 __init__.py 0 B
  - 📄 codeblock.py 219 B
  - 📄 md_to_codeblock.py 4.2 KB
  - 📄 md_to_codeblock.yaml 1.5 KB
- 📁 md_to_csv/
  - 📄 __init__.py 0 B
  - 📄 md_to_csv.py 2.5 KB
  - 📄 md_to_csv.yaml 976 B
- 📁 md_to_docx/
  - 📁 template/
    
    📄 docx_template.docx 15.3 KB
  - 📄 __init__.py 0 B
  - 📄 font_enum.py 119 B
  - 📄 md_to_docx.py 3.2 KB
  - 📄 md_to_docx.yaml 2.0 KB
- 📁 md_to_html/
  - 📄 __init__.py 0 B
  - 📄 md_to_html.py 1.9 KB
  - 📄 md_to_html.yaml 922 B
  - 📄 md_to_html_v1.py 1.3 KB
- 📁 md_to_html_text/
  - 📄 __init__.py 0 B
  - 📄 md_to_html_text.py 1023 B
  - 📄 md_to_html_text.yaml 614 B
  - 📄 md_to_html_text_v1.py 982 B
- 📁 md_to_ipynb/
  - 📄 __init__.py 31 B
  - 📄 md_to_ipynb.py 2.2 KB
  - 📄 md_to_ipynb.yaml 1003 B
- 📁 md_to_json/
  - 📄 __init__.py 0 B
  - 📄 md_to_json.py 2.7 KB
  - 📄 md_to_json.yaml 1.8 KB
- 📁 md_to_latex/
  - 📄 __init__.py 0 B
  - 📄 md_to_latex.py 2.5 KB
  - 📄 md_to_latex.yaml 992 B
- 📁 md_to_md/
  - 📄 __init__.py 0 B
  - 📄 md_to_md.py 1.9 KB
  - 📄 md_to_md.yaml 913 B
- 📁 md_to_pdf/
  - 📄 __init__.py 0 B
  - 📄 md_to_pdf.py 1.9 KB
  - 📄 md_to_pdf.yaml 918 B
- 📁 md_to_png/
  - 📄 __init__.py 0 B
  - 📄 md_to_png.py 2.9 KB
  - 📄 md_to_png.yaml 1.4 KB
- 📁 md_to_pptx/
  - 📄 __init__.py 0 B
  - 📄 md_to_pptx.py 2.6 KB
  - 📄 md_to_pptx.yaml 1.4 KB
- 📁 md_to_xlsx/
  - 📄 __init__.py 0 B
  - 📄 md_to_xlsx.py 2.1 KB
  - 📄 md_to_xlsx.yaml 1.8 KB
- 📁 md_to_xml/
  - 📄 __init__.py 0 B
  - 📄 md_to_xml.py 1.9 KB
  - 📄 md_to_xml.yaml 956 B
- 📁 utils/
  - 📄 __init__.py 0 B
- 📄 __init__.py 0 B
📄 .difyignore 3.7 KB
📄 .env.example 145 B
📄 .gitignore 3.7 KB
📄 .ruff.toml 102 B
📄 AGENTS.md 5.1 KB
📄 LICENSE.txt 11.1 KB
📄 main.py 241 B
📄 MANIFEST.in 37 B
📄 manifest.yaml 1.1 KB
📄 PRIVACY.md 1.2 KB
📄 pyproject.toml 1.2 KB
📄 README.md 29.8 KB
📄 requirements.txt 255 B
📄 SKILL.md 19.0 KB
📄 uv.lock 489.8 KB

SKILL.md

---
name: markdown-exporter
description: Convert Markdown text to DOCX, PPTX, XLSX, PDF, PNG, HTML, IPYNB, MD, CSV, JSON, JSONL, XML files, and extract code blocks in Markdown to Python, Bash,JS and etc files.
license: Apache-2.0
metadata:
   author: bowenliang123
   openclaw:
      homepage: https://github.com/bowenliang123/markdown-exporter
      emoji: 🖨
      requires:
         bins: [ markdown-exporter ]
      install:
         - kind: uv
           package: md-exporter
           bins: [ 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](https://github.com/bowenliang123/markdown-exporter/blob/main/SKILL.md) for Agent Skills, the cli tool and [Python package `markdown-exporter`](https://pypi.org/project/md-exporter/) are maintained in the GitHub repository [bowenliang123/markdown-exporter](https://github.com/bowenliang123/markdown-exporter) by [bowenliang123](https://github.com/bowenliang123).

### Tools and Supported Formats

| Tool | Input (File path of Markdown text or styles) | Output (File path of exported file) |
|------|-------|--------|
| `md_to_docx` | 📝 Markdown text | 📄 Word document (.docx) |
| `md_to_html` | 📝 Markdown text | 🌐 HTML file (.html) |
| `md_to_html_text` | 📝 Markdown text | 🌐 HTML text string |
| `md_to_pdf` | 📝 Markdown text | 📑 PDF file (.pdf) |
| `md_to_png` | 📝 Markdown text | 🖼️ PNG image(s) of PDF pages |
| `md_to_md` | 📝 Markdown text | 📝 Markdown file (.md) |
| `md_to_ipynb` | 📝 Markdown text | 📓 Jupyter Notebook (.ipynb) |
| `md_to_pptx` | 📝 Markdown slides in [Pandoc style](https://pandoc.org/MANUAL.html#slide-shows) | 🎯 PowerPoint (.pptx) |
| `md_to_xlsx` | 📋 [Markdown tables](https://www.markdownguide.org/extended-syntax/#tables) | 📊 Excel spreadsheet (.xlsx) |
| `md_to_csv` | 📋 [Markdown tables](https://www.markdownguide.org/extended-syntax/#tables) | 📋 CSV file (.csv) |
| `md_to_json` | 📋 [Markdown tables](https://www.markdownguide.org/extended-syntax/#tables) | 📦 JSON/JSONL file (.json) |
| `md_to_xml` | 📋 [Markdown tables](https://www.markdownguide.org/extended-syntax/#tables) | 🏷️ XML file (.xml) |
| `md_to_latex` | 📋 [Markdown tables](https://www.markdownguide.org/extended-syntax/#tables) | 📝 LaTeX file (.tex) |
| `md_to_codeblock` | 💻 [Code blocks in Markdown](https://www.markdownguide.org/extended-syntax/#fenced-code-blocks) | 📁 Code files by language (.py, .js, .sh, etc.) |


## 📦 Usage

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

### Installation

```bash
# 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:
```
markdown-exporter -h

markdown-exporter <subcommand> -h
```

### Basic Usage
Use the `markdown-exporter` command to access all the tools:

```bash
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:**
```bash
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**:
   ```bash
   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**:
   ```bash
   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](#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:**
```bash
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**:
   ```bash
   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**:
   ```bash
   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](#basic-text-and-tables) section below.

---

### md_to_docx - Convert Markdown to DOCX

Converts Markdown text to DOCX format file.

**Usage:**
```bash
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**:
   ```bash
   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**:
   ```bash
   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**:
   ```bash
   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](#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:**
```bash
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**:
   ```bash
   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**:
   ```bash
   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**:
   ```bash
   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](#basic-text-and-tables) section below.

---

### md_to_pptx - Convert Markdown to PPTX

Converts Markdown text to PPTX format file.

**Usage:**
```bash
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**:
   ```bash
   markdown-exporter md_to_pptx /path/input.md /path/output.pptx
   ```
   This converts the Markdown file to a PowerPoint presentation.

2. **With custom template**:
   ```bash
   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)](#slides-for-pptx) section below.

---

### md_to_codeblock - Extract Codeblocks to Files

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

**Usage:**
```bash
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**:
   ```bash
   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**:
   ```bash
   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](#code-blocks) section below.

---

### md_to_json - Convert Markdown Tables to JSON

Converts Markdown tables to JSON or JSONL format file.

**Usage:**
```bash
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)**:
   ```bash
   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**:
   ```bash
   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**:
   ```bash
   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](#basic-text-and-tables) section below.

---

### md_to_xml - Convert Markdown to XML

Converts Markdown text to XML format file.

**Usage:**
```bash
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**:
   ```bash
   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**:
   ```bash
   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](#basic-text-and-tables) section below.

---

### md_to_latex - Convert Markdown Tables to LaTeX

Converts Markdown tables to LaTeX format file.

**Usage:**
```bash
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**:
   ```bash
   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**:
   ```bash
   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](#basic-text-and-tables) section below.

---

### md_to_html - Convert Markdown to HTML

Converts Markdown text to HTML format file.

**Usage:**
```bash
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**:
   ```bash
   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**:
   ```bash
   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](#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:**
```bash
markdown-exporter md_to_html_text <input>
```

**Arguments:**
- `input` - Input Markdown file path

**Example:**
```bash
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](#basic-text-and-tables) section below.

---

### md_to_png - Convert Markdown to PNG Images

Converts Markdown text to PNG images (one per page).

**Usage:**
```bash
markdown-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

**Examples:**

1. **Basic conversion**:
   ```bash
   markdown-exporter md_to_png /path/input.md /path/output.png
   ```
   This converts the Markdown file to PNG images (one per page).

2. **With compression**:
   ```bash
   markdown-exporter md_to_png /path/input.md /path/output.png --compress
   ```
   This converts the Markdown file to PNG images and compresses them into a ZIP file.

3. **With code block wrapper removal**:
   ```bash
   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](#basic-text-and-tables) section below.

---

### md_to_md - Convert Markdown to MD File

Saves Markdown text to a .md file.

**Usage:**
```bash
markdown-exporter md_to_md <input> <output>
```

**Arguments:**
- `input` - Input Markdown file path
- `output` - Output MD file path

**Example:**
```bash
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](#basic-text-and-tables) section below.

---

### md_to_ipynb - Convert Markdown to IPYNB

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

**Usage:**
```bash
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**:
   ```bash
   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**:
   ```bash
   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](#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
```markdown
# 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
````markdown
# 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)
````markdown
---
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

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

markdown-exporter

Directory Structure

SKILL.md

Report

Notice