A canvas is an open space where you lay out cards, notes, images and shapes and connect them with arrows: use it to map the notes on a subject or to draw a flowchart, a network or a lab bench. The file is a .canvas in the open JSON Canvas format, the same as Obsidian: a canvas made here opens there, and one made there opens here. Shapes and style go in the fields of the Advanced Canvas plugin; without the plugin, Obsidian draws rectangles and the file loses nothing.
Create, edit and connect
File → New → New canvas creates an empty canvas in the selected folder. Double-click an empty spot to create a text card, or use the Text card tool on the toolbar. A card takes Markdown — headings, lists, links, LaTeX formulas, chemistry and even a Mermaid block — and is edited with a double-click: Ctrl+Enter finishes and Esc cancels. Drag to move and pull the edge to resize; guides appear when the card lines up with a neighbor by its edge or center, or sits at the same distance as the others.
To connect, hover over a card and drag one of the handles on its sides to another card. Drop it on an empty spot and a new card is born already connected. The arrow stays attached to both ends and follows them when they move. Alt while dragging takes a copy; Shift+1 fits everything and Shift+2 the selection; holding Space (or the middle button) and dragging moves the view, and Ctrl+mouse wheel zooms. The wheel alone scrolls the view vertically, and Shift+wheel horizontally. The Hand tool on the toolbar (H) drags the view with the left button; V or Esc goes back to Select. Dragging on an empty spot draws the selection rectangle; if it catches nothing, a tip reminds you how to move the view. Everything can be undone with Ctrl+Z; the full list is in Help → Keyboard Shortcuts.
Shapes, style and Sketch
The Shape tool creates a rectangle, pill, diamond, circle, database and the other flowchart shapes. With something selected, a style panel floats over the selection: the color (six that work in both themes, or any other), the shape, a solid, dashed or dotted border and the text alignment; on an arrow, the stroke, the arrowheads and the route — curved, straight or orthogonal. It also holds align and distribute for several cards, bring to front and send to back.
Groups. Ctrl+G puts the selection in a labeled group that moves together; the arrow next to the label collapses and expands the group, and Ctrl+Shift+G ungroups it.
Ungroup and the right-click menu. Ungroup (Ctrl+Shift+G) works with the group in the selection — even when the selection rectangle caught the group together with its cards — or with exactly the members of one group selected; the cards stay where they were. Without a group to undo, the shortcut keeps opening the version-control sidebar. The right button on a card or a selection offers Group, Ungroup, Bring to front, Send to back, Duplicate, Delete and Properties; on an arrow, Delete and Properties; on an empty spot, Paste, Select all, Fit all and the canvas Properties.
Clean or Sketch. Each canvas has a look: Clean, with straight lines, and Sketch (the Sketch style button on the toolbar), with an irregular hand-drawn stroke, hatched fill and the Excalifont font. The irregular stroke is always the same on the same canvas — it does not change when you reopen it — and the style is saved in the file itself.
Palettes. The six numbered colors follow the canvas palette, chosen with the button next to Sketch style: Theme (follows the window), Pastel, Vivid or Grayscale. With the Theme palette, the Markdown themes that bring their own canvas colors — Solarized, Dracula and Nord — use them; the others keep the default set. The palette is saved in the file, the screen, the thumbnail and the export use the same colors, and a color given as a code (#hex) never changes. Ctrl+Z undoes the change.
Canvas and object properties
The Properties button on the toolbar (or the item in the right-click menu) opens a panel on the right. With nothing selected, it shows the canvas: tags, aliases, description and any properties you add (text, number, yes or no, list), plus the style (Clean or Sketch), the palette and the counts of cards, arrows and groups. These properties live in the .canvas itself, where Obsidian's Advanced Canvas plugin writes them, so both apps read the same ones.
With something selected, the panel shows the object: exact position and size (X, Y, width, height), the layer (which one is in front), Lock aspect ratio — which also keeps the proportion when you resize with the mouse — and Automatic height, which on a text card fits the height to the text when you edit the card or change its width or shape (opening the canvas never changes it; on files, links and groups it is only saved for Obsidian); the color, shape, border and text alignment; on a note card, the section (#Heading or #^block); on an arrow, the start and end sides, the arrowheads, the stroke and the route. With several objects, a value that differs shows as Mixed. Each change is one step that Ctrl+Z undoes, and while an AI proposal is being previewed the panel is read-only. To fit once without turning the option on, use Fit height to text in the right-click menu of a text card, or the Fit button next to the height.
Group background. A group can have a background image, drawn behind the cards in one of three ways: Cover the group (the default), Whole, keeping proportions or Repeat. Choose… in the panel copies the image to Attachments, and the background of a group made in Obsidian shows up too. The thumbnail and the export draw the same background.
Tags and aliases in the index. The canvas tags and aliases enter the index like a note's: [[alias]] in a note opens the canvas, and the Tags panel lists the canvas under its tag. With the canvas turned off in Settings → Features, it leaves the Tags panel.
Library of shapes and icons
The Library button opens a panel with more than 350 vectors in categories — Basic, Flowchart, Network (servers, routers, cloud, security), Laboratory (glassware, equipment, cells, DNA), Health, People and Personal — and a search that finds items by their English or Portuguese name. Click or drag an icon onto the canvas: it is copied as an SVG to the Attachments folder next to the canvas, only once, and the canvas stays your own files, which open with the picture in Obsidian.
Images come in through the Image… button, by dragging from the file explorer or by pasting from the clipboard, and also go to Attachments. Cloud and brand icons (AWS, Azure, Google Cloud, Cisco) are not built in, because their licenses do not allow redistribution: download the official SVGs to a folder and point to it in the Personal category (Choose folder…) or in Settings → Features.
Notes on the canvas
Drag notes from the Explorer onto the canvas: each one becomes a card with the title and the beginning of the text, and a double-click opens the note. A PDF shows its first page; other files, their type and size. The notes cited on a canvas — by file cards and by wikilinks written in cards — appear in the note's incoming links and in the Connections graph, and renaming a note updates the canvases that point to it.
In a note, ![[Map.canvas]] draws a thumbnail of the canvas, which opens it with a click. A Mermaid flowchart pasted on the canvas becomes shapes and arrows, and the context menu of a Mermaid block in formatted editing has Copy as canvas.
Edit with AI
The Edit with AI button on the toolbar (or Ctrl+I) opens a bar below the canvas where you say what you want — “add the review steps”, “tidy this up”, “summarize these cards”. The shortcuts Complete the flowchart, Summarize in a card, Map from this note, Review the texts and Arrange write the request for you. With cards selected, the AI works on the selection, and the neighbours go along as context; with nothing selected, on the whole canvas — the bar says which. The AI does not write the file and gives no coordinates: it returns operations (create, change, delete and connect cards, group, arrange), and LightNote checks them and places each card next to its neighbour without covering anything. If an operation comes back invalid, the app asks for a correction once.
Nothing goes in until you accept. The proposal is drawn on the canvas itself: what is new or changed gets an accent outline, what goes away is faded and struck through, and the canvas is locked while the proposal is shown. Accept (Ctrl+Enter) applies everything as a single step, which Ctrl+Z undoes; Discard (Esc) leaves the canvas exactly as it was; Ask again goes back to the field so you can adjust the text. Stop ignores an answer that has not arrived yet.
What goes to the model. The text of the selected cards and of their neighbours, a short summary of the others (up to a limit, which the model is told about) and, for note cards, the path, the title and the beginning of the note. That text goes as data, never as instructions. See what will be sent, in the AI menu on the bar, shows the whole request before sending; that is also where you choose the AI, and the canvas remembers it. With no AI configured, the button opens the Set up AI wizard.
From the Assistant and the AI CLIs. In the Assistant, in Change with approval mode, ask “add a card Review after Draft in Flow.canvas”: the approval request shows the summary (+1 card: Review · 1 connection), and the open canvas tab reloads when you allow it — if you have an edit pending, the conflict bar appears instead. AI CLIs connected through the MCP server use the same tools, canvas_read and canvas_apply, which leave the rest of the Obsidian file as it was.
Export and the switch
The Export button saves the canvas (or the selection only) as a PNG image — normal, high resolution or with a transparent background — or as an SVG vector, with the same drawing as the screen. Copy as Mermaid and Export as a note with Mermaid turn the cards and arrows into a text flowchart that GitHub draws; the positions are not kept.
The canvas is a feature you can turn off in Settings → Features (Canvases): the item disappears from the New menu, and a .canvas opens as text (JSON). Notes and their links stay.
Limitations. Advanced Canvas portals and arrows between canvases are preserved in the file but not drawn; the A* route is drawn as orthogonal; when exporting a folder and in lnote/MCP, ![[x.canvas]] comes out as a card, without a thumbnail.
Vector credits
The Library vectors come from openly licensed projects: Tabler Icons (MIT, Paweł Kuna); Bioicons (only those under CC0 and CC BY 3.0/4.0 — the author and license of each file are in data/canvas/ATRIBUICOES.md, in the LightNote folder); Health Icons (CC0); Open Doodles (CC0, Pablo Stanley). The Sketch style font is Excalifont (SIL Open Font License 1.1). Anyone who publishes a canvas with a CC BY icon must credit the author listed in that file.
Index
Editing
- Overview
- Getting started
- Workspace and windows
- Activities panel: tasks and messages
- Code editor
- Markdown and wikilinks
- Diagrams (Mermaid)
- Mathematics and chemistry (LaTeX)
- Calendar in a note
- Numbering and cross-references
- Citations and references
- Academic paper standard
- Connections graph
- Canvases (.canvas)
- Tables (Parquet, CSV, JSON, Excel)
- Analysis area: pivot table and several charts
- PDF and images
- Images: marking up a screenshot
- HTML pages (.html)
- Printing
- Zip as a folder (.zip)
- Blocks (.lnb)
- Tasks (Kanban / Gantt)
- Custom table (.lnd)
- Bases (saved queries over your notes)
Tools
- Search in files and Pending items
- Versioning (easy Git)
- Snapshots and backup
- Review changes (checkpoints)
- Compare files (diff)
- Run code (F5)
- Terminal and AI CLIs
- AI in the editor (Ctrl+K / Ctrl+I)
- AI on your computer
- AI sessions
- Assistant
- The Assistant and what you have open
- Test HTTP APIs (.lnh)
- Databases (.lnc)
- SSH connection (.lns)
- Security: Passphrase, PIN and Secure Markdown
- Daily notes, quick capture and tray
- Resurface old notes
- Your notes on your phone
- Record audio (voice, meeting) with AI transcription
- Sticky notes
- Calendar
- Command palette
Automation (AI / scripts)
Reference