All docs

Notes guide

Use Notes as a Markdown workspace for writing, backlinks, diagrams, boards, calendars, journals, and graph navigation.

Markdown vault

Open Notes to browse Markdown files as a vault. Notes supports Markdown editing, wikilinks, tags, backlinks, and graph navigation. Your vaults are in the sidebar's Notes section: use Add vault…, or Open as vault on a volume under Files, to open any storage volume as a vault.

  • Use source view for raw Markdown editing.
  • Use split view when you want editing and preview side by side.
  • Use reading view when you want the rendered page. Checklists show as checkboxes, and a quote that starts with [!note], [!tip], [!warning] or [!caution] (optionally followed by a title) shows as a callout.
  • The note's header shows where it lives (its vault and folders) and whether your changes are Saving… or Saved, or why they were not saved. Under the title, click a tag to show the vault's notes with that tag; the row also shows when the note was last edited and whether you have published it.
  • More actions in the header copies a link to the note (a wikilink you can paste into another note) and, if you can edit it, renames or deletes it. The header also has Share and Publish, and, in source or split view, Attach for adding a file from Explorer.
  • Notes save as you type; Ctrl+S (⌘S on a Mac) saves at once, and Ctrl+Shift+A opens Attach.
  • The side panel beside a note has three tabs: Outline lists the note's headings (choose one to jump to it), Backlinks lists the notes that link here, and Scratch pad keeps quick notes for the vault. Use the arrow keys to move between the tabs, and the Side panel button in the note's header to show or hide it.
  • Every note and vault view has its own address, so you can bookmark or share it, reload it, and move between notes with your browser's Back and Forward.
  • Right-click a note, folder or the editor for its menu, or press Shift+F10 from the keyboard.
  • A note deleted elsewhere, or whose access was removed, closes when you return to the window; one with unsaved changes stays open read-only so you can copy them.

Mermaid diagrams

Mermaid diagrams are stored directly inside Markdown notes and render in preview, split view, reading view, and published pages.

  • Create or open a Markdown note.
  • Switch to source or split view and insert a fenced mermaid block.
  • Switch back to split or reading view to check the rendered diagram.
# Project flow

```mermaid
graph TD
  Idea --> Draft
  Draft --> Review
  Review --> Publish
```

Boards

Boards are Markdown-backed Kanban pages. Filestor stores them under Boards/so they stay portable with the rest of your notes.

  • Use the new menu (+) beside Notes in the sidebar.
  • Choose New board…, enter a name, and create the board.
  • Add columns and cards, then drag cards between columns as work moves forward.
  • To edit a card, double-click its text, or focus it and press Enter or F2. You can also right-click the card, or press Shift+F10, and choose Edit card. Press Enter to save or Escape to cancel.
  • Choose New drawing… from the same menu for a freehand drawing, stored under Drawings/.
  • The board's header shows where it lives, how many columns and cards it has, and whether your changes are Saving… or Saved, or why they were not saved. Drawings and event calendars have the same header; a drawing's tools sit under its title.
  • If you can only view a board, drawing or calendar, its header says Read-only and it offers no editing tools. If you lose edit access while you have unsaved changes, it stays open read-only with Copy unsaved text (or Download unsaved drawing) so you can keep them.

Calendars

Event calendars are Markdown-backed pages. Filestor stores them under Calendar/and renders dated list items in a month grid.

  • Use the new menu (+) beside Notes in the sidebar.
  • Choose New calendar…, enter a name, and create the calendar.
  • Add, edit, or delete dated events from the calendar grid.
  • To edit an event, double-click it, or focus it and press Enter or F2; right-click it, or press Shift+F10, for Edit event. Saving an empty event deletes it.
  • Use Previous month, Today and Next month in the calendar's header to move between months.

Journals

Daily notes

Use the vault's Calendar and Journal views in the sidebar for daily notes and journals. This is separate from event calendars created with New calendar….

  • In Calendar, use Previous month, Today and Next month in the header to move between months, and choose a day to open its note, or create it if you can edit the vault. Days with a note show the start of the note, or a dot.
  • Journal settings, also in the Calendar header, sets the folder daily notes live in (shown under the view's title). Press Enter to save it or Escape to close it.
  • In Journal, use Previous day, Next day and Today in the header to move between days; the day's note opens below. If the day has no note yet, editors can create it; anyone else is told they can't create notes in the vault.
  • Graph shows how the vault's notes link to each other, with the number of notes and links in its header. Choose a note to open it.