// Extract Mermaid diagrams from Markdown documents or raw Mermaid files and render them to PNG or SVG. Use when a task involves fenced ```mermaid blocks, Mermaid architecture diagrams in docs, or reliable image export where browser and Mermaid CLI configuration can be fragile.
| name | mermaid-export |
| description | Extract Mermaid diagrams from Markdown documents or raw Mermaid files and render them to PNG or SVG. Use when a task involves fenced ```mermaid blocks, Mermaid architecture diagrams in docs, or reliable image export where browser and Mermaid CLI configuration can be fragile. |
Render Mermaid diagrams from Markdown or .mmd files to PNG or SVG.
Use the bundled script instead of rebuilding the workflow manually. It handles Mermaid block extraction, picks a real browser binary, writes a temporary Puppeteer config, and calls Mermaid CLI with stable defaults.
Render the first Mermaid block from a Markdown file to PNG:
scripts/render_mermaid.py path/to/doc.md path/to/output.png
Render the second Mermaid block:
scripts/render_mermaid.py path/to/doc.md path/to/output.png --diagram-index 2
Render all Mermaid blocks from a Markdown file into separate numbered PNGs:
scripts/render_mermaid.py path/to/doc.md path/to/output.png --all
This writes output-1.png, output-2.png, and so on.
If you want a custom naming pattern, include {index} in the output path:
scripts/render_mermaid.py path/to/doc.md path/to/output-{index}.png --all
Render a raw Mermaid file to SVG:
scripts/render_mermaid.py path/to/diagram.mmd path/to/output.svg
scripts/render_mermaid.py for export work.mermaid block.--diagram-index when you want one specific Mermaid block.--all when you want separate output files for every Mermaid block in the Markdown source..mmd file when the Mermaid source already exists on disk.--width, --height, or --scale if the exported PNG is too small..md, .markdown, and .mdx as Markdown sources.--diagram-index is 1-based.--all only works with Markdown input.{index} in the output path, --all writes numbered files next to the requested output path using the pattern name-1.png, name-2.png, and so on.npx --yes @mermaid-js/mermaid-cli, so network access or package approval may still be required the first time Mermaid CLI is used on a machine.Commit Jujutsu working-copy changes, push an existing Jujutsu bookmark, or commit and push when explicitly requested. Use when the user asks to "jj commit", "commit with jj", "jj push", "push with jj", "jj commit and push", or wants a fast Jujutsu commit/push workflow.
Add release-please automation to a repository that uses GitHub Actions for releases or package publishing. Use when Codex needs to inspect an existing repo, install a release-please workflow, add the required manifest/config files, preserve any existing publish workflow, add a Release flow section to CONTRIBUTING.md explaining how releases work, and then tell the user which GitHub secrets and settings to add manually after the code changes are complete.
Manages Jujutsu workspaces for isolated task execution, rebases, conflict resolution, and cleanup. Use when the user asks to create or switch workspaces, isolate dirty working copies, rebase onto main or another revision, resolve jj workspace conflicts, or clean up temporary workspaces.