Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/bowenliang123/md_exporter

A Dify tool plugin and Agent Skill to transform Markdown to DOCX, PPTX, XLSX, PNG, PDF, HTML, MD, CSV, JSON, XML files
https://github.com/bowenliang123/md_exporter

agent-skills dify dify-plugin markdown

Last synced: 26 days ago
JSON representation

A Dify tool plugin and Agent Skill to transform Markdown to DOCX, PPTX, XLSX, PNG, PDF, HTML, MD, CSV, JSON, XML files

Awesome Lists containing this project

README 

          
# Markdown Exporter

### An Agent Skill and Dify plugin to Transform Markdowns 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/md_exporter)](https://github.com/bowenliang123/md_exporter)



- Markdown Exporter can be used as:



| Use As                          | Installation                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

|---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|

| Dify Plugin                     | Platform: [Dify](https://github.com/langgenius/dify) 
 - Install from the [Dify Marketplace](https://marketplace.dify.ai/plugins/bowenliang123/md_exporter).
 - Guide: Docs for [Installing Dify Plugins](https://docs.dify.ai/en/use-dify/workspace/plugins#installing-plugins).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

| Agent Skills 
 (standalone) | Platform: [SKILL.md](https://github.com/bowenliang123/md_exporter/blob/main/SKILL.md) is availiable for Any Agent Skills supported platform.
 - 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.) 
 - 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.). 
 
- Local Import: 
 Import [the source code zip file](https://github.com/bowenliang123/md_exporter/archive/refs/heads/main.zip).

 - Remote install: 
Run `/plugin marketplace add bowenliang123/md_exporter` on CLIs, installing as a Clude Marketplace plugin. | 

| Python Package                  | Platform: Python 
 - [markdown-exporter](https://pypi.org/project/markdown-exporter/)  on PyPI. Install by `pip install markdown-exporter`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |



---



## ✨ What is Markdown Exporter?



**Markdown Exporter** is a powerful toolset as both Dify plugin and Claude 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.



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



  

    Tool

    Input

    Output

  

  

    md_to_docx

    📝 Markdown text

    📄 Word document (.docx)

  

  

    md_to_html

    🌐 HTML file (.html)

  

  

    md_to_html_text

    🌐 HTML text string

  

  

    md_to_pdf

    📑 PDF file (.pdf)

  

  

    md_to_png

    🖼️ PNG image(s) of PDF pages

  

  

    md_to_md

    📝 Markdown file (.md)

  

  

    md_to_pptx

    

      


        📝 Markdown slides

      


      


      in  md2pptx  style

      


    

    🎯 PowerPoint (.pptx)

  

  

    md_to_xlsx

    📋 Markdown tables  

    📊 Excel spreadsheet (.xlsx)

  

  

    md_to_csv

    📋 CSV file (.csv)

  

  

    md_to_json

    📦 JSON/JSONL file (.json)

  

  

    md_to_xml

    🏷️ XML file (.xml)

  

  

    md_to_latex

    📝 LaTeX file (.tex)

  

  

    md_to_mermaid

    📊 Mermaid diagrams in Markdown 

    🖼️ PNG image(s) of Mermaid diagrams

  

  

    md_to_codeblock

    💻  Code blocks in Markdown  

    📁 Code files by language (.py, .js, .sh, etc.)

  

  

    md_to_linked_image

    🖼️ Image links in Markdown 

    🖼️ Downloaded image files

  



---



## 📖 Usage Example



![Usage Demo](_assets/usage_md_to_docx.png)



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



---



## 🎨 Tool Showcase



### 📄 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/md_exporter/blob/main/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](_assets/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](_assets/md_to_xlsx_1.png)



---



### 🎯 Markdown → PPTX



Turn your Markdown into stunning PowerPoint presentations automatically.



> **✨ Syntax Requirements**

>

> Input slides must follow [md2pptx syntax](https://github.com/MartinPacker/md2pptx/blob/master/docs/user-guide.md#creating-slides).

>

> **Supported Features:**

> - ✅ Title slides

> - ✅ Bullet lists with nesting

> - ✅ 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/md_exporter/blob/main/assets/template/pptx_template.pptx).



**Input Example:**

```markdown

# Markdown Exporter



### Slide 1 Title

* One

    * One A

    * One B

* Two

    * Two X

    * Two Y



### Slide 2 Title

|Left Heading|Centre Heading|Right Heading|

|:---|:-:|--:|

|Alpha|Bravo|1|

|Charlie|Delta|2|

```



**Output:**

![PPTX Example](_assets/md_to_pptx_1.png)



---



### 🌐 Markdown → HTML



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



![HTML Example](_assets/md_to_html_1.png)



---



### 📑 Markdown → PDF



Generate professional PDF documents perfect for printing or sharing.



![PDF Example](_assets/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](_assets/md_to_png_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](_assets/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](_assets/usage_md_to_codeblock_3.png)

![Code Block Example 3](_assets/usage_md_to_codeblock_4.png)



---



### 🖼️ Markdown → Linked Images



Automatically download all images referenced in your Markdown.



![Linked Image Example](_assets/usage_md_to_linked_image_1.png)



---



### 🖼️ Markdown → Mermaid Diagrams



Convert Mermaid diagram code blocks in your Markdown to PNG images.



**Input Example:**





```mermaid

graph TD

    A[Start] --> B[Process]

    B --> C[Decision]

    C -->|Yes| D[Success]

    C -->|No| E[Failure]

    D --> F[End]

    E --> F

```




**Output:**



![Mermaid Usage](_assets/md_to_mermaid_1.png)



![Mermaid Output](_assets/md_to_mermaid_2.png)



---



### 📋 Markdown → CSV



Export your Markdown tables to universal CSV format.



![CSV Example](_assets/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](_assets/md_to_json_2.png)



**JSON Array Style**

- All objects in a single array

- Ideal for API responses



![JSON Example](_assets/md_to_json_1.png)



---



### 🏷️ Markdown → XML



Transform your data into XML format.



![XML Example](_assets/md_to_xml_1.png)



---



### 📝 Markdown → LaTeX



Generate LaTeX source code for academic and technical documents.



**LaTeX Output:**

![LaTeX Example 1](_assets/md_to_latex_1.png)



**Compiled PDF:**

![LaTeX Example 2](_assets/md_to_latex_2.png)



---



### 📝 Markdown → Markdown



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



---



## 📢 Changelog

Releases are available at

- [Github Repo Releases](https://github.com/bowenliang123/md_exporter/releases).

- [Dify Marketplace Releases](https://marketplace.dify.ai/plugins/bowenliang123/md_exporter).



Release changelogs:

- 3.1.0:

  - Introduce `md_to_mermaid` tool for converting Mermaid diagram code blocks in Markdown to PNG images

  

- 3.0.0:

  - `md_exporter` is now ready for Claude Agent Skills and runnable in standalone

    - Add `SKILL.md` for Claude Skills description

    - Add `/scripts` for code scripts of all tools as Claude Skills exectuion entry

    - Extract the core file transformation logic into `/scripts/lib` sharing by both Claude Skills scripts and Dify Plugin

    - Add `pyproject.toml` as Python project description and dependency management

  - Add automated tests covering all usage of entry of Claude Skills scripts

  - bump `md2pptx` from 6.1 to 6.1.1 for bug fix in table caption 



- 2.3.0:

  - resolve xlsx generation by skipping irrelevant chars 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



- 2.1.0:

  - fix missing table border in `md_to_docx` tool by updating default docx template file

  - intercept `run-python` marco 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 by using a template DOCX file, setting the fonts, font size, color style for headings, paragraphs, etc.

    - optimized file size in generated docx file

    - 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 string



- 1.12.0:

  - fix input pptx template file optional in `md_to_pptx` tool

  - fix error message with file path in cmd 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 output JSONL style in `md_to_json` tool, as JSON Lines format with one object per line

  - Change the default output style of `md_to_json` tool to JSONL

  - Minor doc updates in parameter description



- 1.9.0:

  - Support custom sheet name in `md_to_xlsx` tool by using headings in Markdown text

  - Force convert column type 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:

  - Solve issues with garbled characters when opening CSV files containing non-ASCII characters (eg. Chinese or Japanese characters, Emoji characters etc.) in Microsoft Excel



- 1.7.0:

  - Support custom PPTX template file in `md_to_pptx` tool

  - Support file generation from multiple tables in md_to_csv, md_to_latex, md_to_xlsx tools



- 1.6.0:

  - Introducing `md_to_html_text` tool, support converting Markdown text to HTML text

  - Standardize fonts for headings and body paragraphs DOCX file 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 the font setting for CJK characters

  - Introduce `md_to_epub` tool, support converting Markdown text to EPUB eBook files

  - Support compressing all png files in single zip file in `md_to_png` tool

  - Increase capacity limit for PDF file to 100MB in `md_to_pdf` tool

  - Remove explicit timeout config MAX_REQUEST_TIMEOUT



- 1.4.100:

  - Special version for celebrating [Dify](https://github.com/langgenius/dify)'s 100k GitHub stars milestone

  - add `md_to_png` tool, support converting Markdown text to PNG image files



- 1.3.0:

  - update SDK version



- 1.2.0:

  - Support compressing images to single zip file in `md_to_linked_image` tool



- 1.1.0:

  - Enable line breaks normalization in all tools by default, replacing all the occurrences of `\\n` to `\n`

  - Remove `` tags of reasoning content in the input Markdown text

  - Fix missing custom output filename support in md_to_csv, md_to_json, md_to_latex tool



- 1.0.1:

  - Remove redundant URL safe conversion in custom output filename



- 1.0.0:

  - Support customize the output file name



- 0.5.0:

  - Introducing `md_to_linked_image` tool, support extracting image files in links in Markdown text



- 0.4.3:

  - improve the display of Chinese characters in text paragraph in `md_to_docx` tool, by setting global font to Song if content contains Chinese     - improve the display of Chinese characters in text paragraph in `md_to_docx` tool, by setting global font to Song if content contains Chinese charactor



- 0.4.2:

  - support Java, PHP and Ruby file exporting in `md_to_codeblocks` tool



- 0.4.1:

  - support YAML file exporting in `md_to_codeblocks` tool



- 0.4.0:

  - support exporting Markdown codeblocks in to single zip file in `md_to_codeblocks` tool



- 0.3.0:

  - Fixed the error in importing libraries of `md_to_pptx` tool when running on self-hosted Dify plugin-daemon service



- 0.2.0:

  - Introducing `md_to_codeblock` tool, support extracting code blocks in Markdown to Python, JSON, JS, BASH, SVG, HTML, XML, MARKDOWN files.

  - Introducing `md_to_rst` tool, support reStructuredText `.rst` file format as destination file format



- 0.1.x:

  - Introducing `md_to_pptx` tool, support PowerPoint `.pptx` file format as destination file format



- 0.0.x:

  - Published to Dify Marketplace

  - support exporting Markdown to DOCX, PPTX, XLSX, PDF, HTML, MD, CSV, JSON, XML, LaTex files



---



## 🤝 Contributing



Contributions are welcome! Please feel free to submit issues or pull requests on our [GitHub repository](https://github.com/bowenliang123/md_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

uv run dev.reformat.sh

```



---



## 📜 License



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



---



## 🔒 Privacy



Your privacy matters. This plugin:

- **Collects NO data**

- Processes everything **locally**

- Sends **NO information** to third-party services



All file transformations happen entirely within your environment.



---



## 🙏 Acknowledgments



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



| Project | License |

|---------|---------|

| [md2pptx](https://github.com/MartinPacker/md2pptx) | MIT License |

| [pypandoc](https://github.com/JessicaTegner/pypandoc) | MIT License |

| [pandas](https://github.com/pandas-dev/pandas) | BSD 3-Clause License |

| [python-pptx](https://github.com/scanny/python-pptx) | MIT License |

| [xhtml2pdf](https://github.com/xhtml2pdf/xhtml2pdf) | Apache License 2.0 |