Skip to content

Learn

Mindmap syntax

Learn roots, shapes, indentation, and markdown labels used in the Workspace map template.

On this page9 sections
  1. Syntax cheatsheet
  2. 1.Start a mindmap
  3. 2.Branches by indentation
  4. 3.Node shapes
  5. 4.Deeper nesting
  6. 5.Markdown in labels
  7. 6.Keep labels scannable
  8. 7.Put it together: Workspace map
  9. Check your level

Syntax cheatsheet

Quick reference for this diagram type

ConceptSyntax
Declaremindmap
Circle rootroot((Title))
Square / roundedid[Title] · id(Title)
Cloud / hexagonid))Title(( · id{{Title}}
Hierarchyindent children under parents
Markdownid["`**bold**`"]
  1. 1

    Start a mindmap

    Begin with mindmap. Unlike flowcharts, hierarchy is expressed with indentation under a root — not with arrows.

    Pick one clear root idea; everything else branches from it.

    mindmap
      root((SayDiagram))
    Expand
  2. 2

    Branches by indentation

    Each deeper indent level becomes a child topic. Sibling topics must share the same indent.

    Two spaces (or a consistent tab) per level is enough — mixed indentation will nest unexpectedly.

    • Tip: Mindmaps ignore edge syntax — don’t use --> here.
    mindmap
      root((SayDiagram))
        Create
        Organize
        Share
    Expand
  3. 3

    Node shapes

    Shape wrappers change how a topic looks. Double parentheses ((text)) draw a circle — great for roots.

    Squares [], rounded (), clouds )) ((, and hexagons {{ }} help distinguish kinds of topics when the map grows.

    mindmap
      root((Idea))
        Square[Topic]
        Round(Topic)
        Cloud))Topic((
        Hex{{Topic}}
    Expand
  4. 4

    Deeper nesting

    Add another indent level for sub-features. Keep depth shallow (three or four levels) so the map stays glanceable.

    Group by user goal (Create / Organize / Share) rather than by implementation detail.

    mindmap
      root((SayDiagram))
        Create
          Editor
          Import
        Share
          Links
          Export
    Expand
  5. 5

    Markdown in labels

    Wrap markdown in quotes and backticks when you need emphasis inside a node.

    Use this sparingly — bold roots work; bold everywhere becomes noise.

    • Tip: Markdown labels use quotes and backticks, e.g. Editor["`**Live** preview`"].
    mindmap
      root((SayDiagram))
        Create
          Live preview
          Import
    Expand
  6. 6

    Keep labels scannable

    Short nouns work better than long sentences. Prefer Editor over “The visual diagram editor surface.”

    When a branch grows past five children, split it into a second map or promote a child to its own root for a dedicated page.

    • Tip: If icon syntax fails in your renderer, remove it — text hierarchy still carries the meaning.
    mindmap
      root((Workspace))
        Create
          Editor
          Templates
        Organize
          Folders
          Favorites
        Share
          Public link
          Embed
    Expand
  7. 7

    Put it together: Workspace map

    Nest concrete features under Create, Organize, and Share to match the examples template.

    mindmap
      root((SayDiagram))
        Create
          Editor
          Import mmd
        Organize
          Folders
          Favorites
        Share
          Links
          Export
    Expand

Check your level

80% or higher certifies this lesson. You'll get 35 random questions from a larger bank.