Metadata-Version: 2.4
Name: md-exporter
Version: 3.6.8
Summary: An Agent Skill and Dify plugin to Convert markdown text into files in various formats such as DOCX, XLSX, PDF, PPTX and images.
Author: bowenliang123
Author-email: bowenliang123 <liang.bowen.123@qq.com>
License-Expression: Apache-2.0
Requires-Dist: markdown>=3.10.2
Requires-Dist: pandas[excel,html,xml]~=3.0.1
Requires-Dist: jinja2>=3.1.6
Requires-Dist: xhtml2pdf~=0.2.17
Requires-Dist: pymupdf~=1.27.1
Requires-Dist: pillow~=12.1.1
Requires-Dist: pypandoc-binary~=1.16.2
Requires-Python: >=3.11
Project-URL: Homepage, https://github.com/bowenliang123/markdown-exporter/
Project-URL: Repository, https://github.com/bowenliang123/markdown-exporter.git
Project-URL: Issues, https://github.com/bowenliang123/markdown-exporter/issues
Project-URL: Changelog, https://github.com/bowenliang123/markdown-exporter/?tab=readme-ov-file#-changelog
Description-Content-Type: text/markdown

<div align="center">
  <img src="https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/icon.png" alt="Markdown Exporter Logo" width="200">
</div>

# Markdown Exporter
### An Agent Skill and Dify plugin to Export Markdown Into Powerful Documents

- Author: [bowenliang123](https://github.com/bowenliang123)
- GitHub Repository: [![GitHub Repo](https://img.shields.io/badge/github-repo-blue?logo=github&label=bowenliang123/markdown-exporter)](https://github.com/bowenliang123/markdown-exporter)

- Markdown Exporter can be used as:

| Use As                       | Platforms & Installation                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Dify Plugin                  | **Platform**: [Dify](https://github.com/langgenius/dify) <br/> **Installation**: <br/> - Install from [Dify Marketplace](https://marketplace.dify.ai/plugins/bowenliang123/md_exporter)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Agent Skills                 | **Platforms**: Any platform supporting [Agent Skills](https://agentskills.io) <br/> - **IDEs/CLIs**: [Claude Code](https://code.claude.com/docs/en/skills), [Trae](https://docs.trae.ai/ide/skills), [Codebuddy](https://copilot.tencent.com/docs/cli/skills), etc. <br/> - **Agent Frameworks**: [LangChain DeepAgents](https://www.blog.langchain.com/using-skills-with-deep-agents/), [AgentScope](https://doc.agentscope.io/tutorial/task_agent_skill.html), etc. <br/><br/> **Installation**: <br/> - **Local Import**: Download and import [source code zip](https://github.com/bowenliang123/markdown-exporter/archive/refs/heads/main.zip) <br/> - **Remote Install**: `/plugin marketplace add bowenliang123/markdown-exporter` in agent CLIs |
| OpenClaw Skill               | **Platform**: 🦞 [OpenClaw](https://openclaw.ai) <br/> - Install from [ClawHub](https://clawhub.ai/bowenliang123/markdown-exporter): `npx clawhub@latest install markdown-exporter`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Command Line Interface (CLI) | **Platform**: Python<br/> - Install from [PyPI](https://pypi.org/project/md-exporter/): `pip install md-exporter`<br/> - Run: `markdown-exporter --help` for usage information                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

---

## ✨ What is Markdown Exporter?

**Markdown Exporter** is a powerful toolset as an Agent Skill or a Dify plugin 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.

With support for **15+ output formats**, Markdown Exporter bridges the gap between simple text editing and professional document creation, all while maintaining the simplicity and elegance of Markdown syntax.

### 🎯 Why You'll Love It

- **🚀 Lightning Fast** – Export your Markdown to multiple formats in milliseconds
- **🎨 Customizable** – Use custom templates for DOCX and PPTX to match your brand
- **🔒 100% Private** – All processing happens locally, no data ever leaves your environment
- **📊 Versatile** – From documents to spreadsheets, presentations to code files
- **🌐 Multi-Language Support** – Perfect for international teams and content

---

## 🛠️ Introduction and Use Guide

### 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="7">📝 Markdown text</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_ipynb</code></td>
    <td>📓 Jupyter Notebook (.ipynb)</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>
</table>

---

## 📖 Usage as Dify Plugin

![Usage Demo](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/usage_md_to_docx.png)

Simply input your Markdown text, select your desired output format, and click export. It's that easy!

---

## 🎨 Dify Tools Usages

### 📄 Markdown → DOCX

Create professional Word documents with beautiful formatting.

> **✨ Pro Tip: Custom Styling with Templates**
>
> The `md_to_docx` tool supports custom DOCX template files, giving you full control over your document's appearance.
>
> **What you can customize:**
> - Heading styles (fonts, sizes, colors)
> - Paragraph formatting (spacing, indentation)
> - Table styles and borders
> - List styles and bullets
> - And much more!
>
> Check out the [default docx template](https://github.com/bowenliang123/markdown-exporter/blob/main/md_exporter/assets/template/docx_template.docx) or create your own. Learn how at [Customize or create new styles](https://support.microsoft.com/en-us/office/customize-or-create-new-styles-d38d6e47-f6fc-48eb-a607-1eb120dec563).

![DOCX Example](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_docx_1.png)

---

### 📊 Markdown → XLSX

Convert your Markdown tables into polished Excel spreadsheets with auto-fitted columns and preserved data types.

**Input:**
```markdown
| Name    | Age | City        |
|---------|-----|-------------|
| Alice   | 30  | New York    |
| Bowen   | 25  | Guangzhou   |
| Charlie | 35  | Tokyo       |
| David   | 40  | Miami       |
```

**Output:**
![XLSX Example](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_xlsx_1.png)

---

### 🎯 Markdown → PPTX

Turn your Markdown into stunning PowerPoint presentations automatically.

> **✨ Syntax Requirements**
>

>
> **Supported Features:**
> - ✅ Title slides
> - ✅ Column Layout
> - ✅ Tables
> - ✅ Hyperlinks
> - ✅ And more!
>
> > **🎨 Custom Templates:**
> >
> > Use custom PPTX templates with slide masters to match your brand's visual identity. [Learn how](https://support.microsoft.com/en-us/office/customize-a-slide-master-036d317b-3251-4237-8ddc-22f4668e2b56). Get the [default pptx template](https://github.com/bowenliang123/markdown-exporter/blob/main/md_exporter/assets/template/pptx_template.pptx).

The input Markdown must follow the syntax and guidance in [Pandoc Slide Shows](https://pandoc.org/MANUAL.html#slide-shows).

**Input Example:**

````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://avatars.githubusercontent.com/u/127165244?s=48&v=4)
:::
::: 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://avatars.githubusercontent.com/u/127165244?s=48&v=4 "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://avatars.githubusercontent.com/u/127165244?s=48&v=4"}

::: 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.
:::
````

**Output:**
![PPTX Example](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_pptx_1.png)

---

### 🌐 Markdown → HTML

Transform your Markdown into clean, semantic HTML perfect for web pages.

![HTML Example](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_html_1.png)

---

### 📑 Markdown → PDF

Generate professional PDF documents perfect for printing or sharing.

![PDF Example](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_pdf_1.png)

---

### 🖼️ Markdown → PNG

Convert your Markdown into beautiful PNG images. Great for:
- Social media posts
- Documentation screenshots
- Quick sharing in chat apps

![PNG Example](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_png_1.png)

---

### 🏷️ Markdown → Jupyter Notebook

Transform your Markdown into Jupyter Notebook `.ipynb` format.

**Input Example:**
````markdown
# Example Jupyter Notebook

This is a simplified test markdown file that will be converted to an IPYNB notebook with multiple cells.

## Introduction

This notebook demonstrates the conversion of markdown to IPYNB format.

- It includes markdown formatting
- It has code cells in different languages
- It shows how tables are handled

```python
# Python Code Cell
print("Hello, world!")
x = 10
y = 20
print(f"Sum: {x + y}")
```

## Data Table

Here's a sample table:

| Name  | Score | Occupation |
|-------|-------|------------|
| Alice | 80    | Engineer   |
| Bowen | 90    | Designer   |

## Conclusion

This concludes the simplified test notebook.
````

**Output File:**
![IPYNB Example](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_ipynb_1.png)

---

### 💻 Markdown → Code Block Files

Effortlessly extract code blocks from your Markdown and save them as individual files, preserving syntax highlighting and formatting.

#### Supported Languages & File Extensions

| Language   | File Extension | Language   | File Extension |
|------------|----------------|------------|----------------|
| Python     | `.py`          | CSS        | `.css`         |
| JavaScript | `.js`          | YAML       | `.yaml`        |
| HTML       | `.html`        | Ruby       | `.rb`          |
| Bash       | `.sh`          | Java       | `.java`        |
| JSON       | `.json`        | PHP        | `.php`         |
| XML        | `.xml`         | Markdown   | `.md`          |
| SVG        | `.svg`         |            |                |

![Code Block Example 1](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/usage_md_to_codeblock_2.png)

**Pro Tip:** Enable compression to bundle all extracted files into a single ZIP archive for easy sharing and organization!

![Code Block Example 2](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/usage_md_to_codeblock_3.png)
![Code Block Example 3](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/usage_md_to_codeblock_4.png)




### 📋 Markdown → CSV

Export your Markdown tables to universal CSV format.

![CSV Example](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_csv_1.png)

---

### 📦 Markdown → JSON / JSONL

Convert your tables into structured data formats.

**JSONL Style (default)**
- One JSON object per line
- Perfect for streaming and logging

![JSONL Example](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_json_2.png)

**JSON Array Style**
- All objects in a single array
- Ideal for API responses

![JSON Example](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_json_1.png)

---

### 🏷️ Markdown → XML

Transform your data into XML format.

![XML Example](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_xml_1.png)

---

### 📝 Markdown → LaTeX

Generate LaTeX source code for academic and technical documents.

**LaTeX Output:**
![LaTeX Example 1](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_latex_1.png)

**Compiled PDF:**
![LaTeX Example 2](https://raw.githubusercontent.com/bowenliang123/markdown-exporter/main/_assets/screenshots/md_to_latex_2.png)

---

### 📝 Markdown → Markdown

Save your Markdown content as a `.md` file for future use.


---

## Command Line Interface (CLI) Usage

Markdown Exporter provides a powerful command-line interface that allows you to access all its functionality directly from your terminal.

### Installation

```bash
# with pip
pip install md-exporter

# with uv 
uv tool install md-exporter
```

### Basic Usage

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

```bash
markdown-exporter <subcommand> <args> [options]
```

### Tool Usage Guide

#### md_to_csv - Convert Markdown tables to CSV
```bash
markdown-exporter md_to_csv <input> <output> [options]
```
- **Arguments**: `input` (Markdown file path), `output` (CSV file path)
- **Options**: `--strip-wrapper` (Remove code block wrapper if present)

#### md_to_pdf - Convert Markdown to PDF
```bash
markdown-exporter md_to_pdf <input> <output> [options]
```
- **Arguments**: `input` (Markdown file path), `output` (PDF file path)
- **Options**: `--strip-wrapper` (Remove code block wrapper if present)

#### md_to_docx - Convert Markdown to DOCX
```bash
markdown-exporter md_to_docx <input> <output> [options]
```
- **Arguments**: `input` (Markdown file path), `output` (DOCX file path)
- **Options**: `--template` (Path to DOCX template file), `--strip-wrapper` (Remove code block wrapper if present)

#### md_to_xlsx - Convert Markdown tables to XLSX
```bash
markdown-exporter md_to_xlsx <input> <output> [options]
```
- **Arguments**: `input` (Markdown file path), `output` (XLSX file path)
- **Options**: `--force-text` (Convert cell values to text type), `--strip-wrapper` (Remove code block wrapper if present)

#### md_to_pptx - Convert Markdown to PPTX
```bash
markdown-exporter md_to_pptx <input> <output> [options]
```
- **Arguments**: `input` (Markdown file path), `output` (PPTX file path)
- **Options**: `--template` (Path to PPTX template file)

#### md_to_codeblock - Extract Codeblocks to Files
```bash
markdown-exporter md_to_codeblock <input> <output> [options]
```
- **Arguments**: `input` (Markdown file path), `output` (Output directory or ZIP file path)
- **Options**: `--compress` (Compress all code blocks into a ZIP file)

#### md_to_json - Convert Markdown Tables to JSON
```bash
markdown-exporter md_to_json <input> <output> [options]
```
- **Arguments**: `input` (Markdown file path), `output` (JSON file path)
- **Options**: `--style` (JSON output style: jsonl or json_array), `--strip-wrapper` (Remove code block wrapper if present)

#### md_to_xml - Convert Markdown to XML
```bash
markdown-exporter md_to_xml <input> <output> [options]
```
- **Arguments**: `input` (Markdown file path), `output` (XML file path)
- **Options**: `--strip-wrapper` (Remove code block wrapper if present)

#### md_to_latex - Convert Markdown Tables to LaTeX
```bash
markdown-exporter md_to_latex <input> <output> [options]
```
- **Arguments**: `input` (Markdown file path), `output` (LaTeX file path)
- **Options**: `--strip-wrapper` (Remove code block wrapper if present)

#### md_to_html - Convert Markdown to HTML
```bash
markdown-exporter md_to_html <input> <output> [options]
```
- **Arguments**: `input` (Markdown file path), `output` (HTML file path)
- **Options**: `--strip-wrapper` (Remove code block wrapper if present)

#### md_to_html_text - Convert Markdown to HTML Text
```bash
markdown-exporter md_to_html_text <input>
```
- **Arguments**: `input` (Markdown file path)

#### md_to_png - Convert Markdown to PNG Images
```bash
markdown-exporter md_to_png <input> <output> [options]
```
- **Arguments**: `input` (Markdown file path), `output` (PNG file or directory path)
- **Options**: `--compress` (Compress all PNG images into a ZIP file), `--strip-wrapper` (Remove code block wrapper if present)

#### md_to_md - Convert Markdown to MD File
```bash
markdown-exporter md_to_md <input> <output>
```
- **Arguments**: `input` (Markdown file path), `output` (MD file path)

#### md_to_ipynb - Convert Markdown to IPYNB
```bash
markdown-exporter md_to_ipynb <input> <output> [options]
```
- **Arguments**: `input` (Markdown file path), `output` (IPYNB file path)
- **Options**: `--strip-wrapper` (Remove code block wrapper if present)

### 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
- Use `markdown-exporter <subcommand> -h` for detailed help on each subcommand

---

## 📢 Releases
Releases are available at:
- [GitHub Repo Releases](https://github.com/bowenliang123/markdown-exporter/releases)
- [Dify Marketplace Releases](https://marketplace.dify.ai/plugins/bowenliang123/md_exporter)

### Changelog
- 3.6.7
  - Fixed path error issue for docx and pptx template files in Python distribution package

- 3.6.6
  - Refactor code structure to ensure Agent Skill, Dify plugin and CLI properly share the core file transformation logic 
  - Make project installable and usable on OpenClaw as Agent Skill 🦞
  - Refactor Python packaging to make `markdown-exporter` as standalone CLI tool with Python package `md-exporter` installed
  - Remove `md_to_linked_image` tool

- 3.6.0
  - Improve conversion success rate in `md_to_docx`, `md_to_pptx`, and `md_to_ipynb` tools by removing enforcement of spaces and blank lines in heading headers
  - Speed up first call on pandoc by running the warm-up method

- 3.5.1
  - Correctly handle code cells by pre-processing markdown input in `md_to_ipynb` tool

- 3.5.0
  - Introduce `md_to_ipynb` tool for converting Markdown text to Jupyter Notebook (.ipynb) format
  - The `md_to_ipynb` tool automatically splits markdown content into separate notebook cells
  - Update logo icon (for the very first time)

- 3.4.0
  - [BREAKING CHANGE] Migrate `md_to_pptx` tool to use `pandoc` for conversion for stable features and reduced dependency footprint
  - The Markdown input for `md_to_pptx` tool now must follow the markdown syntax and guidance in [Pandoc slides](https://pandoc.org/MANUAL.html#slide-shows)

- 3.3.0
  - Update `md_to_pptx` from 6.1.1 to 6.2.1
  - Remove `md_to_mermaid` tool to reduce installation time and footprint by eliminating Node.js runtime dependency

- 3.2.0
  - Introduce `md_to_mermaid` tool for converting Mermaid diagram code blocks in Markdown to PNG images
  - Refactor Agent Skill scripts and entry shell scripts

- 3.0.0
  - `md_exporter` is now ready for Agent Skills and runnable as standalone
    - Add `SKILL.md` for Agent Skills description
    - Add `/scripts` for code scripts of all tools as Agent Skills execution entry
    - Extract core file transformation logic into `/scripts/lib` shared by both Agent Skills scripts and Dify Plugin
    - Add `pyproject.toml` as Python project description and dependency management
  - Add automated tests covering all usage of Claude Skills scripts entry points
  - Bump `md2pptx` from 6.1 to 6.1.1 for table caption bug fix

- 2.3.0
  - Resolve XLSX generation issue by skipping irrelevant characters before first table in `md_to_xlsx` tool

- 2.2.0
  - Fix CI problems in GitHub Actions

- 2.1.0
  - Fix remote image fetching in `md_to_pptx` tool by updating `md2pptx` to 6.1
  - Fix missing table border in `md_to_docx` tool by updating default DOCX template file
  - Intercept `run-python` macro usage in `md_to_pptx` tool

- 2.0.0
  - [BREAKING CHANGE] Migrate `md_to_docx` tool to use `pandoc` for conversion
  - Major improvements in `md_to_docx` tool:
    - Support custom styling using a template DOCX file, allowing font, font size, and color style customization for headings, paragraphs, etc.
    - Optimize file size in generated DOCX files
    - Better support for multi-language content
  - Remove `md_to_rst` and `md_to_epub` tools
  - Add `force_text_value` option in `md_to_xlsx` tool to control whether to force convert all cell values to text strings

- 1.12.0
  - Fix optional PPTX template file handling in `md_to_pptx` tool
  - Fix error message with file path in command assembly in `md_to_pptx` tool
  - Bump `md2pptx` to 6.0

- 1.10.2
  - Bump `md2pptx` from 5.4.4 to 5.4.5
  - Bump `python-docx` from 1.1 to 1.2.0
  - Increase PDF generation capacity limit to 500MB

- 1.10.0
  - Support JSONL output style in `md_to_json` tool, using JSON Lines format with one object per line
  - Change default output style of `md_to_json` tool to JSONL
  - Minor documentation updates in parameter descriptions

- 1.9.0
  - Support custom sheet names in `md_to_xlsx` tool using headings in Markdown text
  - Force convert column types to string in `md_to_xlsx` tool to prevent data precision loss and display issues in Microsoft Excel
  - Autofit column width in `md_to_xlsx` tool

- 1.8.0
  - Resolve garbled character issues when opening CSV files containing non-ASCII characters (e.g., Chinese, Japanese, emoji characters) in Microsoft Excel

- 1.7.0
  - Support custom PPTX template files in `md_to_pptx` tool
  - Support file generation from multiple tables in `md_to_csv`, `md_to_latex`, and `md_to_xlsx` tools

- 1.6.0
  - Introduce `md_to_html_text` tool for converting Markdown text to HTML text
  - Standardize fonts for headings and body paragraphs in DOCX files generated by `md_to_docx` tool

- 1.5.0
  - Improve PDF display for pure English markdown text input in `md_to_pdf` tool by skipping font settings for CJK characters
  - Introduce `md_to_epub` tool for converting Markdown text to EPUB eBook files
  - Support compressing all PNG files into a single zip file in `md_to_png` tool
  - Increase capacity limit for PDF files to 100MB in `md_to_pdf` tool
  - Remove explicit timeout configuration MAX_REQUEST_TIMEOUT

- 1.4.100
  - Special version celebrating [Dify](https://github.com/langgenius/dify)'s 100k GitHub stars milestone
  - Add `md_to_png` tool for converting Markdown text to PNG image files

- 1.3.0
  - Update SDK version

- 1.2.0
  - Support compressing images into a single zip file in `md_to_linked_image` tool

- 1.1.0
  - Enable line breaks normalization in all tools by default, replacing all occurrences of `\n` with `\n`
  - Remove `<think>` tags of reasoning content in input Markdown text
  - Fix missing custom output filename support in `md_to_csv`, `md_to_json`, and `md_to_latex` tools

- 1.0.1
  - Remove redundant URL-safe conversion in custom output filenames

- 1.0.0
  - Support custom output filenames

- 0.5.0
  - Introduce `md_to_linked_image` tool for extracting image files from links in Markdown text

- 0.4.3
  - Improve Chinese character display in text paragraphs in `md_to_docx` tool by setting global font to Song if content contains Chinese characters

- 0.4.2
  - Support Java, PHP, and Ruby file exporting in `md_to_codeblock` tool

- 0.4.1
  - Support YAML file exporting in `md_to_codeblock` tool

- 0.4.0
  - Support exporting Markdown codeblocks into a single zip file in `md_to_codeblock` tool

- 0.3.0
  - Fix library import error in `md_to_pptx` tool when running on self-hosted Dify plugin-daemon service

- 0.2.0
  - Introduce `md_to_codeblock` tool for extracting code blocks in Markdown to Python, JSON, JS, BASH, SVG, HTML, XML, and MARKDOWN files
  - Introduce `md_to_rst` tool for converting Markdown to reStructuredText (.rst) format

- 0.1.x
  - Introduce `md_to_pptx` tool for converting Markdown to PowerPoint (.pptx) format

- 0.0.x
  - Publish to Dify Marketplace
  - Support exporting Markdown to DOCX, PPTX, XLSX, PDF, HTML, MD, CSV, JSON, XML, and LaTeX files

---


## 🤝 Contributing

Contributions are welcome! Please feel free to submit issues or pull requests on our [GitHub repository](https://github.com/bowenliang123/markdown-exporter).

### Code Style

We use `ruff` to ensure code consistency. Run the following command to automatically fix code style issues:

```bash
uv run ruff check --fix --select UP .
```

Or use the provided script:

```bash
dev/reformat.sh
```

---

## 📜 License

This project is licensed under the **Apache License 2.0**.

---

## 🔒 Privacy

Privacy matters. See the [Privacy Policy](./PRIVACY.md) for more details. This plugin:
- Collects **NO** data
- Processes everything **locally**
- Sends **NO information** to third-party services

All file transformations happen entirely within the local environment.

---

## 🙏 Acknowledgments

This project stands on the shoulders of giants. We're grateful to these amazing open-source projects:

| Project                                               | License              |
|-------------------------------------------------------|----------------------|
| [pypandoc](https://github.com/JessicaTegner/pypandoc) | MIT License          |
| [pandas](https://github.com/pandas-dev/pandas)        | BSD 3-Clause License |
| [xhtml2pdf](https://github.com/xhtml2pdf/xhtml2pdf)   | Apache License 2.0   |
