Diagrams

Knowledge → Learn → Diagrams.

Diagrams uses the exact same file-tree layout as Learning Paths: a folder tree on the left (with Regenerate, New file, New folder, and per-item Rename / Delete, all working exactly as described there), and an open document on the right with Edit / View and Fix with AI. What sets this screen apart is what the documents hold: each one embeds diagram source code that ACE renders as a real picture (flowchart, sequence diagram, and so on) instead of showing you the raw code.

Viewing and editing a diagram

• While viewing a document, hover over a rendered diagram and an Edit button (pencil icon, titled "Edit mermaid source") appears in its top-right corner.
• Click it to open a side-by-side editor: the diagram's source on the left, a live Preview on the right that redraws automatically a moment after you stop typing. Cancel discards your changes; Save rewrites that diagram inside the document and saves it. You do not need to switch the whole page into Edit mode first to fix a single diagram.
• If a diagram's source has a mistake, instead of a picture you will see a Mermaid parse error box with the error message and the raw source underneath, so you can see exactly what needs fixing.
• Everything else (Regenerate, Fix with AI, creating, renaming, and deleting diagram files, the empty state (No diagrams yet → Generate diagrams)) behaves exactly as described under Learning Paths.

There is no separate search or filter box among your diagrams on this page; you browse them via the folder tree on the left, same as any other document screen.

Who can do this?

knowledge:read to browse and view; knowledge:manage (plus a mutable project) to edit a diagram or its document, regenerate, or use Fix with AI.