
Documentation
Mermaid Diagram for ConfluenceBrowse
Documentation
Mermaid Diagram for ConfluenceImport from a URL
Insert → From a URL loads a diagram from a public file on the web: a .mmd file, or a ```mermaid block in a Markdown file.
Importing
- In the editor, click Insert → From a URL.
- Paste the link to the file and click Load. Links to a file's page on GitHub, GitLab or Bitbucket work too; they are turned into the raw file's link.
- For a Markdown file, choose the diagram. Each block is listed by the heading above it.
- Check the preview and click Import.
The file must be public: the link has to open without signing in. For private repositories, use GitHub, GitLab and Bitbucket.
A diagram imported from a URL isn't linked to its file. To update it, import it again.
Allowed sites
The app can only load files from the sites a Confluence admin allowed. The dialog lists them under the link.
Admins manage them in Mermaid Diagram settings → Sources:
- Allow a common site: GitHub, GitLab or Bitbucket, in one click.
- Or another site: enter its address, for example
docs.example.com.
Atlassian asks the admin to confirm each site. Remove takes a site off the list.
When a file doesn't load
| Message | What to do |
|---|---|
| This site can't load files from … yet | Ask a Confluence admin to allow the site in Sources |
| The file wasn't found, or it isn't public | Check the link opens without signing in |
| That link opens a web page, not the file | Use the file's raw link, or a link to the file on GitHub, GitLab or Bitbucket |
No ```mermaid block was found in that file |
The Markdown file has no Mermaid diagrams |
| The file is larger than 1 MB | Split the file, or copy the diagram into the editor |
Stuck on something this page does not cover? Ask the developers.