Progress Update: TinaCMS + Mermaid

October 9, 2024

By Jack Pettit

The ability to integrate and manage Mermaid diagrams within TinaCMS is nearly here, offering more flexibility for content creators working with visual representations like flowcharts, sequence diagrams, and more. Here’s a look at where things stand with this feature and what’s coming next.

Part 1: Plate.js Integration (Completed)

Mermaid diagrams are now fully integrated into the Plate editor. Using the mermaid package, diagrams can be edited and rendered directly within the editor.

Figure: Mermaid Diagram editing/Rendering inside the Rich Text Editor

Part 2: Parsing and Saving Mermaid Diagrams (In Progress)

The next phase focuses on parsing and saving these diagrams. Since TinaCMS uses customized mdast, the challenge lies in ensuring the Mermaid syntax is correctly parsed, saved, and reloaded without issues.

What’s Next?

Next steps include polishing the parsing and saving process and rolling out the final deployment. This will be coming in the 2.3.0 release of tinacms. Once that’s done, you will be able to fully integrate, edit, and save Mermaid diagrams within TinaCMS 🦙

In the meantime, feel free to explore the development progress over at https://github.com/tinacms/tinacms/issues/4734

Thank you for your continued support and feedback!

Best,

The TinaCMS Team 🦙

Last Edited: October 9, 2024