
Documentation
Mermaid Diagram for ConfluenceBrowse
Documentation
Mermaid Diagram for ConfluenceKnown Issues & Limitations
Page trees don't update themselves
Issue: A page tree is built once, into the editor. Pages added, moved or renamed later don't appear. Workaround: Open the editor and insert the page tree again.
Page trees include up to 100 pages
Issue: Larger sections are cut off at 100 pages, and pages with more than 8 children show a "+ N more pages" box instead of the rest. Workaround: Start from a page lower down, or choose a smaller depth.
Links in hand-edited mind maps
Issue: Mermaid can't link mind map nodes, so page tree mind maps keep their links as %% click comment lines. A box you add by hand has no link.
Workaround: Add a line such as %% click myNode href "/wiki/pages/viewpage.action?pageId=123" for it, or use a flowchart, where right-click linking works.
Right-click linking is for flowcharts
Issue: Link to a page… appears only on flowchart boxes. Workaround: Use a flowchart for diagrams whose boxes should open pages.
Very large diagrams
Issue: A diagram can hold up to 200,000 characters of code. Diagrams over about 20 KB are loaded from storage when the page opens, so they appear a moment later. Workaround: Split very large diagrams into several smaller ones.
Diagrams from GitHub, GitLab or Bitbucket don't update by themselves
Issue: The page shows the diagram as it was saved. A change to the file isn't shown until an editor refreshes it. Workaround: Open the editor, choose Refresh from … in the file's menu, then save.
Diagrams imported from a URL aren't linked
Issue: Unlike repository imports, a URL import has no Refresh or Commit. Workaround: Import the file again, or connect the repository in Settings → Repositories and import from there.
One connection per service
Issue: Each Confluence site has one GitHub App, one GitLab token and one Bitbucket token. A GitLab token reaches one group, project or person's projects; a Bitbucket token one workspace or repository. Workaround: Use a GitLab token from a parent group, or a Bitbucket workspace token, to cover more repositories.
Bitbucket Data Center isn't supported
Issue: Bitbucket connects to Bitbucket Cloud only. Workaround: Use Import from a URL for public files, or copy the diagram into the editor.
Stuck on something this page does not cover? Ask the developers.