Download
Documentation

Markdown

Notes are Markdown, edit and preview in the detail view, autosaves as you leave edit mode.

Notes render as Markdown in the detail view. ⌘ E switches between Edit and View; leaving edit mode saves automatically – there’s nothing separate to remember.

Supported syntax

  • Headings, paragraphs, line breaks
  • Bold, italic, inline code, strikethrough
  • Fenced code blocks with a language label
  • Lists: bulleted, numbered (the author’s start number and delimiter are kept), and task lists (- [ ] / - [x])
  • Tables, with column alignment
  • Links, autolinks (<https://...>), and nested blockquotes
  • Images: see below

Rendering is Gisti’s own lightweight renderer, tuned for note-sized documents – fast to open, native look in both themes.

Images

Drop an image into a note with plain Markdown syntax:

![alt text](https://example.com/diagram.png)
![screenshot](/Users/you/Desktop/screenshot.png)
  • Local files (a file:// URL or a bare path, as above) render immediately, scaled to fit the note width.
  • Remote images (http/https) load asynchronously – a placeholder shows the alt text until the image arrives, then swaps in place. Downloads are capped in size and time, so a broken or huge URL can’t hang a note.
  • There is no paste-to-embed or drag-and-drop button in the note editor – an image becomes part of a note by typing or pasting its Markdown syntax. (Contrast with Chat, where pasting an image attaches it directly, a different mechanism from Markdown images in note text.) Screenshots and copied images still get their own elements in the Stream either way.

Linking to other notes

Copy Link (⌘ L, from the Action Menu or an open element) copies a gisti://open?id=... URL for that element. Paste it as a plain URL, or wrap it in Markdown link syntax, and it becomes a working cross-reference:

See [the deploy checklist](gisti://open?id=note_3F2E1...) from last week.

Clicking the link jumps straight to that note, clip, chat, or screenshot. Gisti handles its own gisti:// scheme like any other link. There’s no [[wiki-link]] autocomplete for this today; it’s a link you paste, like any other URL. See URL scheme for everything else gisti:// can do.

Editing

  • ⌘ E: toggle edit / view for the text (autosaves on exit), ⇧ ⌘ E: edit the title.
  • Esc leaves the editor (and saves).
  • Checkboxes in task lists toggle by click in view mode – a note can be a living checklist.
  • Pin (⌘ U) floats the note in a small always-on-top window – useful for a checklist you’re working through. Text clipboard items can be pinned too, not just notes. Details: Pinned windows.