Skip to content
Yamuno
Browse

Import 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

  1. In the editor, click Insert → From a URL.
  2. 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.
  3. For a Markdown file, choose the diagram. Each block is listed by the heading above it.
  4. 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.