# 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
- [md-exporter](https://pypi.org/project/md-exporter/) on PyPI. Install by `pip install md-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/screenshots/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/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](assets/screenshots/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/screenshots/md_to_pptx_1.png) --- ### 🌐 Markdown → HTML Transform your Markdown into clean, semantic HTML perfect for web pages. ![HTML Example](assets/screenshots/md_to_html_1.png) --- ### 📑 Markdown → PDF Generate professional PDF documents perfect for printing or sharing. ![PDF Example](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](assets/screenshots/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/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](assets/screenshots/usage_md_to_codeblock_3.png) ![Code Block Example 3](assets/screenshots/usage_md_to_codeblock_4.png) --- ### 🖼️ Markdown → Linked Images Automatically download all images referenced in your Markdown. ![Linked Image Example](assets/screenshots/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/screenshots/md_to_mermaid_1.png) ![Mermaid Output](assets/screenshots/md_to_mermaid_2.png) --- ### 📋 Markdown → CSV Export your Markdown tables to universal CSV format. ![CSV Example](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](assets/screenshots/md_to_json_2.png) **JSON Array Style** - All objects in a single array - Ideal for API responses ![JSON Example](assets/screenshots/md_to_json_1.png) --- ### 🏷️ Markdown → XML Transform your data into XML format. ![XML Example](assets/screenshots/md_to_xml_1.png) --- ### 📝 Markdown → LaTeX Generate LaTeX source code for academic and technical documents. **LaTeX Output:** ![LaTeX Example 1](assets/screenshots/md_to_latex_1.png) **Compiled PDF:** ![LaTeX Example 2](assets/screenshots/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.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 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 |