diagram-pptx 0.1.0b1

Compile Mermaid into editable native PowerPoint diagrams with python-pptx

English · 日本語

diagram-pptx

Mermaid in. Editable PowerPoint shapes out.

diagram-pptx parses Mermaid into typed Python models and renders editable PowerPoint AutoShapes, connectors, text, and groups. The same diagram can also be exported to SVG, PNG, or JPEG.

Install

pip install diagram-pptx

For PNG and JPEG export:

pip install "diagram-pptx[image]"

Quick start

from pptx import Presentation
from diagram_pptx import render_mermaid

source = """
flowchart LR
    request[Request] --> review{Approved?}
    review -->|yes| publish[Publish]
    review -->|no| request
"""

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])

render_mermaid(source, slide=slide, position="full")
prs.save("diagram.pptx")

Native rendering is the default and needs no Node.js, PowerPoint, Docker, or LibreOffice. The resulting diagram is movable, resizable, ungroupable, and addressable by semantic ID.

from diagram_pptx import parse_mermaid

diagram = parse_mermaid(source)
diagram.model.nodes["publish"].label = "Release"
diagram.save("diagram.svg")
diagram.save("diagram.png", dpi=300)

Highlights

• All Mermaid 11.16 syntax families through Official geometry
• Typed models and Pure Python Native layout for flowchart, sequence, class, ER, and state
• Mutable typed models with parse/edit/compile workflows
• Editable native PowerPoint output through python-pptx
• Pure Python Native layout and optional Mermaid CLI Official geometry
• Themes, class/ID overrides, automatic text contrast, and color maps
• Inch bounds, named slide regions, and normalized 0..1 placement
• SVG plus optional high-resolution PNG/JPEG export

Documentation

• User guide · 日本語
• Mermaid compatibility · 日本語
• Architecture and extension contracts
• MCP and Codex integration
• Examples · 日本語
• Contributing
• Changelog

0.1.0b1 is a beta release. Unsupported Mermaid syntax is reported rather than silently discarded. See the user guide for the support matrix and backend behavior.

License

MIT