https://github.com/bowenliang123/markdown-exporter
An Agent Skill and Dify plugin to transform Markdown to files of DOCX, PPTX, XLSX, PNG, PDF, Mermaid, HTML, MD, CSV, JSON, XML.
https://github.com/bowenliang123/markdown-exporter
agent-skills dify dify-plugin markdown
Last synced: 15 days ago
JSON representation
An Agent Skill and Dify plugin to transform Markdown to files of DOCX, PPTX, XLSX, PNG, PDF, Mermaid, HTML, MD, CSV, JSON, XML.
- Host: GitHub
- URL: https://github.com/bowenliang123/markdown-exporter
- Owner: bowenliang123
- License: apache-2.0
- Created: 2025-01-17T08:32:39.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-22T15:53:08.000Z (28 days ago)
- Last Synced: 2026-02-22T20:43:47.862Z (28 days ago)
- Topics: agent-skills, dify, dify-plugin, markdown
- Language: Python
- Homepage: https://marketplace.dify.ai/plugins/bowenliang123/md_exporter
- Size: 21.9 MB
- Stars: 183
- Watchers: 6
- Forks: 47
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome - bowenliang123/markdown-exporter - An Agent Skill and Dify plugin to transform Markdown to files of DOCX, PPTX, XLSX, PNG, PDF, Mermaid, HTML, MD, CSV, JSON, XML. (Python)
README
# Markdown Exporter
### An Agent Skill and Dify plugin to Export Markdown Into Powerful Documents
- Author: [bowenliang123](https://github.com/bowenliang123)
- GitHub Repo: [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)
**Installation**:
- Install from [Dify Marketplace](https://marketplace.dify.ai/plugins/bowenliang123/md_exporter) |
| Agent Skills | **Platforms**: Any platform supporting [Agent Skills](https://agentskills.io)
- **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.
**Installation**:
- **Local Import**: Download and import [source code zip](https://github.com/bowenliang123/markdown-exporter/archive/refs/heads/main.zip)
- **Remote Install**: `/plugin marketplace add bowenliang123/markdown-exporter` in agent CLIs |
| OpenClaw Skills 🦞 | **Platform**: [OpenClaw](https://docs.openclaw.ai/tools/skills#clawhub-install-%2B-sync)
- Install from [ClawHub](https://clawhub.ai/bowenliang123/markdown-exporter): `npx clawhub@latest install markdown-exporter` |
| Command Line Interface (CLI) | **Platform**: Python
- Install from [PyPI](https://pypi.org/project/md-exporter/): `pip install md-exporter`
- Run: `markdown-exporter -h` 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
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_ipynb
📓 Jupyter Notebook (.ipynb)
md_to_pptx
📝 Markdown slides
🎯 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_codeblock
💻 Code blocks in Markdown
📁 Code files by language (.py, .js, .sh, etc.)
---
## 📖 Usage as Dify Plugin
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).
---
### 📊 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:**
---
### 🎯 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:
:::
::: column
- This triggers the "Comparison" layout
- Useful for side-by-side comparisons
:::
:::::
## Content with Caption
Here's some explanatory text about the image below.
---
# 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:**
---
### 🌐 Markdown → HTML
Transform your Markdown into clean, semantic HTML perfect for web pages.
---
### 📑 Markdown → PDF
Generate professional PDF documents perfect for printing or sharing.
---
### 🖼️ Markdown → PNG
Convert your Markdown into beautiful PNG images. Great for:
- Social media posts
- Documentation screenshots
- Quick sharing in chat apps
---
### 🏷️ 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:**
---
### 💻 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` | | |
**Pro Tip:** Enable compression to bundle all extracted files into a single ZIP archive for easy sharing and organization!
### 📋 Markdown → CSV
Export your Markdown tables to universal CSV format.
---
### 📦 Markdown → JSON / JSONL
Convert your tables into structured data formats.
**JSONL Style (default)**
- One JSON object per line
- Perfect for streaming and logging
**JSON Array Style**
- All objects in a single array
- Ideal for API responses
---
### 🏷️ Markdown → XML
Transform your data into XML format.
---
### 📝 Markdown → LaTeX
Generate LaTeX source code for academic and technical documents.
**LaTeX Output:**
**Compiled PDF:**
---
### 📝 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 [options]
```
### Tool Usage Guide
#### md_to_csv - Convert Markdown tables to CSV
```bash
markdown-exporter md_to_csv [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 [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 [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 [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 [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 [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 [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 [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 [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 [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
```
- **Arguments**: `input` (Markdown file path)
#### md_to_png - Convert Markdown to PNG Images
```bash
markdown-exporter md_to_png [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
```
- **Arguments**: `input` (Markdown file path), `output` (MD file path)
#### md_to_ipynb - Convert Markdown to IPYNB
```bash
markdown-exporter md_to_ipynb [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 -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.9
- Reduced the packaged Dify plugin file size by 95% by removing the screenshot images for README docs.
- 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 `` 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 |