Back to Blog

Link Notes Inside a Mermaid Diagram, and See Them in Backlinks

November 9, 2026by TypeFire
mermaid internal linkmermaid wikilinkmermaid diagram link to noteobsidian mermaid internal linkmermaid backlinksflowchart of notesproject map markdown

A diagram in your notes usually ends at the picture. You draw the five phases of a project, and then you go hunting for the note about phase three anyway.

It doesn't have to work that way. If a box can be a link to a note, the diagram becomes a map you click through, and the notes it points to know they're on the map.

The short version

  • In TypeFire for Mac, label a box with a note link like [[Welcome email]]. Clicking it opens the note.
  • The link counts in that note’s backlinks and on the graph, like any link you type.
  • In Obsidian, list the boxes in class Biology,Chemistry internal-link; to make them clickable.
  • Best use: a project map, one box per part, each opening its note.

A list of links tells you what exists. A diagram tells you how it fits together: what comes first, what depends on what, where a decision splits the work. Linking the boxes gives you both at once, and you stop keeping a separate index note that slowly goes out of date.

A flowchart whose boxes are note links in TypeFire, and the linked note's backlinks showing it was linked from a diagram
Each box opens its note, and the note’s backlinks show the diagram.

How it works in TypeFire

Write the note's name as a link in the box's label. Everything else is ordinary Mermaid.

flowchart LR
  A[Sign up] --> B["[[Welcome email]]"]
  B --> C["[[First project]]"]
  C --> D[Active user]

In the note, Welcome email and First project draw as linked boxes. Click one and that note opens. Open the Welcome email note and its backlinks list Onboarding, the note the diagram lives in, so you can always find your way back.

The links also show on the graph with the rest of your notes, so a project map pulls its notes together there too.

How it works in Obsidian

Obsidian makes a box clickable when you give it the internal-link class, and the box's text is the note it opens. Its help gives this example:

graph TD
  Biology --> Chemistry
  class Biology,Chemistry internal-link;

A project map you can click through

Here's the pattern worth stealing: one note per phase, and one diagram that links them.

A product onboarding map. In a note, each box can open the note for that step.
Box Opens the note about
Welcome email What the first email says and when it goes out
Reminder email Who gets it and the wording
Setup guide The steps a new user follows
First project The template they start from

When something changes, you edit one note and the map still points at it. When someone new joins, the map is the first thing you send them.

Tips

  • Keep labels short. The box shows the note's name, so short names make a clean diagram.
  • Link the parts, not every box. Decisions and endpoints read better as plain boxes.
  • One map per project. A map of everything is a graph, and you already have one of those.

Try the syntax in the free Mermaid flowchart editor, and see diagrams in TypeFire for linking, zooming and resizing on the Mac. If your notes are in an Obsidian vault, TypeFire opens the same files.

In their words

Loved by people who type all day.

Unprompted reactions from users, in their own words.

Exactly what macOS has been needing: blazing fast, beautifully designed, and it respects your privacy without forcing a subscription.
Physician
I use TypeFire every single day, all day long. I love it.
Works at Apple
The way you've handled the AI integrations is very elegant. A great implementation.
Mac user
TypeFire is the absolute replacement for TextExpander.
Works at Apple
I love your app. Love it. The only one that does what I want it to do.
Mac user
I'm loving the date math. Amazing, love it.
ICU doctor
It instantly imported my 502 snippets. Flawless import.
Moved over from TextExpander
Incredibly lightweight. It has quickly become a go-to tool in my daily workflow.
Physician
Love the app, and your development pace rocks.
Longtime user
This app is AWESOME! And I definitely want to buy the Pro version.
Free user
Fantastic. Thank you for the very fast fix.
EU keyboard user
This app has so much potential. I'm really grateful that I found it.
Mac user

Used by people at

AppleRed HatPalo Alto NetworksHubSpotIndeedSentryFreshworksTrustpilotBumbleFarfetchSaint-GobainfoodpandaMcKinseyAccentureIntuitInstacartRakutenDow JonesHearstRokuxAINuroGitGuardianMeltwaterDevRevWoltAirwallex

Company names are places where our users work. They do not imply endorsement or affiliation.