Skip to content
Docs menu

Editing in Notes

How Venom Notes stores a note as markdown that opens in Obsidian unchanged, and which syntax each kind of block and formatting becomes.

View .md

A note in Venom Notes is a markdown file. The editor in Notes works with blocks, the way Notion does, but what it saves is plain markdown in Obsidian's dialect, so an exported vault opens in Obsidian unchanged and a note written in Obsidian keeps everything when Notes opens it. The engineering reference is docs/globe.md → Editor.

What each block is saved as

In the editor In the markdown
Text, headings 1 to 3 a paragraph, #, ##, ###
Bulleted, numbered and to-do lists - item, 1. item, - [ ] task, - [x] done, nested by indenting
Quote > quote
Callout an Obsidian callout, > [!note] Title. The type (note, tip, warning, danger, …) sets the icon and colour
Toggle a folded callout, > [!toggle]- Summary, with the content under it
Toggle heading 1 to 3 the same callout marked with its level, `> [!toggle
Table of contents a ```toc block, as Obsidian's Dynamic Table of Contents plugin writes it
Breadcrumb a ```breadcrumb block
Columns :::columns, then each column from a :::column line (with its width, :::column 40%), to a line :::
Divider ---
Code a fenced block with its language, such as ```ts
Diagram a ```mermaid block; its view and caption follow the language, ```mermaid view=split caption="…"
Equation $$ on the lines around the TeX; $…$ inside a line
Table a GFM table; the first row is the header
Image ![alt](address "caption"); a width and alignment ride in the alt, as in Obsidian: ![alt|center|480](…)
Video, audio, PDF, file the same ![name](address); the address's extension says which
Embed the same ![](https://youtu.be/…) for YouTube, Loom, Figma, Google Maps and CodePen links
Bookmark a ```cardlink block with the address, title and description
QR code a ```qr block with the link or text it encodes; a size other than the default follows the language, ```qr size=large
Synced block a callout, > [!synced], with ^id on its own line after it; each copy elsewhere is ![[Note#^id]]
Inline database a ```base block (Obsidian Bases)
Properties the --- frontmatter at the top, kept as written

What formatting is saved as

Formatting Markdown
Bold, italic, strikethrough, inline code **bold**, *italic*, ~~strike~~, `code`
Highlight ==highlight==
Underline <u>underline</u>
Text and background colour <span data-color="red">…</span>, <span data-bg="yellow">…</span>
Link [text](address)
Link to a note [[Note]], `[[Note
Mention of a member, of a People contact <span data-mention="user" data-id="…">@Name</span>, <span data-mention="person" data-id="…">@Name</span>
Date <time datetime="2026-11-07">Nov 7, 2026</time>

Keyboard shortcuts

Notes uses Notion's shortcuts. On Windows and Linux, Ctrl takes the place of ⌘ and Alt the place of ⌥. Press ⌘? (Ctrl+? elsewhere) in a note to see this list. Redo also answers to ⌘Y (Ctrl+Y).

Action macOS Windows and Linux
Bold ⌘B Ctrl+B
Italic ⌘I Ctrl+I
Underline ⌘U Ctrl+U
Strikethrough ⌘⇧S Ctrl+Shift+S
Inline code ⌘E Ctrl+E
Add a link ⌘K Ctrl+K
Apply the last colour used ⌘⇧H Ctrl+Shift+H
Comment on the selection ⌘⇧M Ctrl+Shift+M
Turn into text ⌘⌥0 Ctrl+Alt+0
Turn into heading 1 ⌘⌥1 Ctrl+Alt+1
Turn into heading 2 ⌘⌥2 Ctrl+Alt+2
Turn into heading 3 ⌘⌥3 Ctrl+Alt+3
Turn into a to-do list ⌘⌥4 Ctrl+Alt+4
Turn into a bulleted list ⌘⌥5 Ctrl+Alt+5
Turn into a numbered list ⌘⌥6 Ctrl+Alt+6
Turn into a toggle ⌘⌥7 Ctrl+Alt+7
Turn into a code block ⌘⌥8 Ctrl+Alt+8
Checklist on or off ⌘⇧7 Ctrl+Shift+7
Bulleted list on or off ⌘⇧8 Ctrl+Shift+8
Numbered list on or off ⌘⇧9 Ctrl+Shift+9
Duplicate the block ⌘D Ctrl+D
Move the block up ⌘⇧↑ Ctrl+Shift+Up
Move the block down ⌘⇧↓ Ctrl+Shift+Down
Indent Tab Tab
Outdent ⇧Tab Shift+Tab
Check a to-do, or open or close a toggle ⌘↵ Ctrl+Enter
Check a to-do and the to-dos inside it ⌘⇧↵ Ctrl+Shift+Enter
Make a task in Venom Tasks from the line ⌘⇧↵ Ctrl+Shift+Enter
Select the block Esc Esc
With blocks selected, select the block above too ⇧↑ Shift+Up
With blocks selected, select the block below too ⇧↓ Shift+Down
Open the block menu ⌘/ Ctrl+/
Undo ⌘Z Ctrl+Z
Redo ⌘⇧Z Ctrl+Shift+Z
Keyboard shortcuts ⌘? Ctrl+?

Linear's keys work too where Venom had none of its own: ⌘⇧7, ⌘⇧8 and ⌘⇧9 make a checklist, a bulleted list or a numbered list (pressed again on such a line, the line goes back to text), and ⌘⇧↵ in a to-do checks it with every to-do inside it. On any other line ⌘⇧↵ still makes a task. In a comment box, ⌘↵ in a to-do checks it; anywhere else in the box it sends. Three of Linear's keys keep Venom's meaning here: > and a space makes a toggle (use >>> and a space, or " and a space for a quote), ⌘⇧\ shows or hides the app rail, and ⌘⇧U moves the note to another vault.

Enter in a toggle's summary adds a line inside the open toggle; Enter on an empty line at the end of a quote, callout or toggle leaves it. Backspace at the start of a toggle's summary or a heading turns it back into text.

⌘⇧↑ and ⌘⇧↓ move the block the cursor is in past the block above or below it, inside its list, quote, callout or toggle. With blocks selected, ⌘D, ⌘⇧↑, ⌘⇧↓, Delete, Backspace, ⌘C, ⌘X and the Turn into keys act on all of them. Esc again, an arrow key or Enter puts the cursor back in the text; typing does nothing until then, as in Notion.

Adding and changing blocks

  • The / menu. Type / anywhere in a line and keep typing to search the blocks: "h2" finds Heading 2, "math" finds Block equation, "tbl" finds Table. ↑ and ↓ move, Enter or Tab picks, Esc closes and leaves what you typed. A search also finds actions on the block you are in: Delete, Duplicate, Move up, Move down and the colours ("/red", "/blue background"). /turn lists Turn into, and the rest narrows it: /turnh2 turns the block into Heading 2. Image and Web bookmark ask for an address; Notes shows the image from that address as it is, and a bookmark is a card made from the address alone: Notes never fetches the page to fill it in. Database – inline puts a database view in the note; typing in its cells stays in the database.
  • Layout blocks. In the / menu:
    • Table of contents lists the note's headings (and toggle headings), indented by level, and follows them as you write. Click one to scroll to it.
    • Breadcrumb shows where the note lives: its folders, then its title.
    • Toggle heading 1, 2 and 3 are headings that fold what is under them, like a toggle list. Turn into switches between them, toggle lists and headings 1 to 6 (headings 4 to 6 are in Turn into only, as in Notion).
    • 2, 3, 4 or 5 columns put blocks side by side. Drag the border between two columns to change their widths, or focus it with Tab and press ← or →. Drag any block onto the right edge of another (or just inside its left edge) and a blue line down that edge shows they will sit side by side: two blocks become two columns, and a block dropped beside one already in columns adds a column (up to five). A column left empty goes away, and a row left with one column turns back into its blocks. On a narrow window the columns stack. Obsidian shows a table of contents and a breadcrumb as code blocks unless a plugin draws them, a toggle heading as a folded callout, and columns as their blocks between ::: lines, so nothing is lost either way.
  • The toolbar. Select some text to get Turn into, bold, italic, underline, strikethrough, inline code, link and colour. ← and → move between its buttons.
  • The block handles. Hover any block and two handles show right beside it, level with its first line (left of a bullet or a number), as in Notion. They hide while you type and come back when you move the pointer, and the block they belong to is tinted while the pointer is on them. Pausing on a handle shows what it does.
    • + adds an empty line under the block and opens the / menu in it; ⌥-click (Alt-click) adds the line above. In a list the new line is a list item; on an empty line the menu opens in that line.
    • ⋮⋮ drags the block somewhere else: every kind of block, from a line or a heading to a list item, a quote, a callout, a toggle, code, a diagram, an equation, a table, an image, a divider or an inline database. A blue line shows where it will land, and the page scrolls when you hold it near the top or bottom edge. Esc cancels. One ⌘Z puts it back.
    • Lists. A list item drags on its own, its nested items with it. Drop it a little to the right of an item to nest it under that item, or to the left of the last item of a nested list to take it out a level; the blue line moves in or out to show the level. An item dropped between other blocks stays an item of its kind (next to a list of the same kind it joins it); a line dropped into a list becomes an item; a heading, code or any other block dropped between two items splits the list there.
    • Click ⋮⋮, or press ⌘/ (Ctrl+/), for the block menu: Delete, Duplicate, Turn into, Copy link to block, Move up, Move down, Colour (the whole block's text or background) and Keyboard shortcuts. ⇧F10 opens it too.
  • Selecting blocks. Esc selects the block the cursor is in; ⇧↓ and ⇧↑ add the blocks below or above, and ⇧click (on a block or on its ⋮⋮) selects every block up to the one clicked. Drag the selected blocks by any of their handles, or use the block menu, the / actions or the keys above on all of them at once. Turning several lines into a list makes one list.
  • Copy link to block. For a heading the link is [[Note#Heading]]. For a line or a list item Notes adds an Obsidian block id at the end of the line, such as ^k3x9q2, if it has none, and copies [[Note#^k3x9q2]], so the link works in Obsidian too. Other blocks (a table, code, a quote) copy a link to the note. The id is plain text in the markdown, nothing else.
  • Colours. Ten text colours and ten backgrounds, Notion's palette: default, gray, brown, orange, yellow, green, blue, purple, pink and red. ⌘⇧H applies the last one you used again.
  • Callouts. Click a callout's icon to change its type (note, tip, warning, danger, …); the type sets the icon and colour and is what Obsidian reads.
  • Pasting. Markdown pasted as plain text becomes blocks, as if the note had been written that way. Pasted web pages, Notion and Google Docs content keep headings, lists, quotes, tables, links and formatting; scripts, styles and anything else the editor has no block for are dropped.

Icon and cover

  • Icon. Hover the title and click Add icon. The picker searches a bundled set of about 700 emoji by name ("rocket", "coffee", "flag united"); it also takes a pasted emoji or image link. Nothing is fetched from a CDN.
  • Cover. Add cover shows a banner across the whole width of the page. Pick a gradient, Upload an image from your computer (stored in the note's vault with the other uploads), or paste an image link. Reposition drags an image up or down.
  • The icon and cover are saved as the note's icon, cover and cover_y frontmatter.
  • Links to notes. Type [[ and the start of a note's name; Notes searches your notes as you type. Enter links the one you pick, or a note that doesn't exist yet when nothing matches, as Obsidian does. The link is saved as [[Note]]. Click it to open the note. Typing the closing ]] yourself does the same: [[Note]] becomes the link, [[Note|shown text]] keeps its text, and ![[Note]] embeds.
  • Issue links. Type [[ENG-1: if your org has that Venom Tasks issue, the list offers it with its state, key and title, labelled as an issue. Picking it, or typing [[ENG-1]] by hand, shows the live issue chip.
  • People. Type @ and a name to mention someone. Org members and your People contacts are listed under their own headings. A member is saved as a small HTML span with their id, so it survives renames, and reads as @Name in Obsidian. A contact from People becomes a chip that opens their page and shows a hover card; see Notes mentions.
  • Dates. Type @today, @tomorrow, @yesterday or a date like @2026-11-07. A date is saved as <time datetime="2026-11-07">Nov 7, 2026</time>.

Make a task

A line of a note can become a Venom Tasks issue without leaving the note. Put the cursor on the line, or select several lines, and press ⌘⇧↵ (Ctrl+Shift+Enter), pick Task in the toolbar over selected text, Make a task in the block menu (⋮⋮), or type /make a task.

  • Each line becomes one issue, assigned to you, in your Tasks team. With more than one team, a short menu asks which; Notes remembers the one you picked last in this browser.
  • The title is the line's text: a mentioned person reads as their name and a linked note as its title. A date on the line (@Friday, @2026-11-14) becomes the issue's due date instead.
  • The line keeps the issue's live chip ([[ENG-12]]) after its text, showing the issue's state as it moves. The issue lists the note under its linked notes, for the people who can read the note.
  • A line that already links an issue is not made twice. Empty lines and code are skipped; at most 25 lines at once.
  • It runs as you, under Venom Tasks' own rules: you need the Tasks add-on and write access there, and you can only make tasks from notes you can edit.

Images, files and embeds

  • Upload. Paste a screenshot, drop files onto the note, or type /image, /video, /audio, /file or /pdf and choose Upload. Each file goes to the note's vault: your personal files only you can open, the org vault's every member can. A file is at most 4 MB, and Notes takes images, video, audio, PDFs, text, CSV, JSON, zip and office documents.
  • By address. The same / items take a link instead, and pasting an image or video address works too.
  • Images and video. Drag the handles on either side to resize, use the bar at the top right to align left, centre or right, and type a caption under the block.
  • Files and PDFs. A file shows its name and size and downloads when clicked; an uploaded PDF opens in place.
  • Embeds. /embed, or paste a YouTube, Loom, Figma, Google Maps or CodePen link and pick Embed. An embed shows a card until you click Load: the other site hears nothing about your note until someone chooses to play it.
  • Pasting a link. A link pasted on its own asks what it should be: a Mention (a link titled from the address), a Bookmark card, an Embed (when it can be one), or the URL as it is (Esc).

On a phone or tablet

When you edit a note on a touch screen, a row of buttons sits right above the on-screen keyboard, as in Notion's app. The row scrolls sideways; Hide keyboard stays at its end. Tapping a button keeps the caret where it was and the keyboard up, and the line you are typing on stays in view above the row. The row is not shown for a note you can only read or a published page, and it goes away when you hide the keyboard or tap outside the note. While it shows, the workspace's app bar at the bottom of the screen steps aside.

Button What it does
Ask AI Opens Ask AI on the selected text, or below the line you are on. Only when your org has a model.
Insert a block (+) Every block the / menu offers, in a sheet: headings, lists, callouts, tables, columns, media, a QR code and the rest.
Text style (Aa) Bold, italic, underline, strikethrough and code for the selection, then Turn into (text, headings, lists, to-do, toggle, quote, callout, code) and Colour (text colours and highlights).
Add a photo or image Your phone's picker, which offers the camera or your photo library. The picture uploads to the note's vault like a pasted one.
Attach a file Any file, as a file block (the same 4 MB limit and file types as uploads on a computer).
To-do, Outdent, Indent Only in a list: the line becomes a to-do (or back), and moves out or in a level, as Shift+Tab and Tab do.
Link Adds a link at the caret, or edits the one there.
Mention a person or page Types @ and opens the mention list.
Comment Comments on the selected text, on notes that take comments.
Undo, Redo The editor's own history, including in a note several people are editing live.
Delete block Deletes the block the caret is in.
Hide keyboard Puts the keyboard away.

The row is in every Notes editor: a note's page and a database row opened beside its table. Venom Tasks' issue descriptions and comments use the same editor without it for now. On a phone the row reads where the keyboard is from the browser (Safari on iPhone and iPad, Chrome and Firefox on Android).

QR codes

A QR code block turns a link, or any short text, into a code a phone can scan. It is made on your device by Venom Notes itself: nothing is sent to a QR service or anywhere else, and it costs nothing.

  • Add one. Type /qr (or /QR code), paste a link or type some text, and press Make QR code (or ⌘ or Ctrl with Enter). The text can run over several lines. Under the box, a counter shows how many bytes the text takes out of what a code holds.

  • From what is already there. Select some text, or put the cursor in a link, and pick Turn into → QR code: the text or link stays where it is and its code goes right after the paragraph. With nothing selected, Turn into makes the whole block a code of its text. On a link, the link box (⌘K) has a QR code button too, and a link pasted on its own offers QR code next to Mention, Bookmark and Embed.

  • A link or text. A web address (https://…), mailto: or tel: address becomes a code that opens it, and the code and the address under it are links: they open in a new tab in a read-only note or a published page, and with ⌘ or Ctrl-click while you edit (a plain click selects the block). Anything else, a javascript: address included, is encoded as written and shown as text under the code, never as a link; a long text is shortened with Show all.

  • The ⋯ menu. Edit the text, Open link, Copy image, Download PNG or Download SVG (named after the site, such as qr-example.com.png, and drawn from the same code), choose the size (Small, Medium, Large) and Delete. Read-only notes and published pages offer copy and the downloads.

  • Always scannable. The code is black on white with a clear margin in light and dark themes, at error-correction level M. A code holds at most 2,331 bytes at that level; bytes are counted as UTF-8, so a character outside Latin takes two to four. Longer text shows a message in place of the code rather than a broken one.

  • In the markdown it is a fenced block, so the note reads as plain text anywhere and an agent can add one through globe_note_write or globe_note_edit by writing the same lines:

    ```qr
    https://example.com/menu
    ```
    
    ```qr size=large
    Wi-Fi: Guest
    Password: correct horse
    ```
  • Where it shows. The editor, live editing with others, read-only notes, published pages and the HTML and PDF export draw the code. Obsidian, GitHub and anything else that reads the markdown shows the text in a code block.

Synced blocks

  • Make one. Type /synced in a block, or select several blocks first. They get a red outline when you point at them.
  • Use it elsewhere. Press Copy and sync on the block's bar, then paste into another note. The copy is the same block: edit either one and the other follows (a copy refreshes while the note is open, and when you come back to the tab).
  • See where it is used. The original's bar says Synced to N pages; click it to list those pages and open one.
  • Change your mind. Unsync this copy keeps its content as ordinary blocks. Unsync on the original turns it, and every copy in every page, into ordinary blocks (a copy in a locked or read-only page is left as it is, and its own bar can unsync it). Go to original opens the note it lives in.
  • In Obsidian the original reads as a callout with a block id, and a copy as an embed of that block.
  • Any ![[Note#^id]] on its own line shows that block in place, read only, when it isn't a synced block.

Comments

  • On some text. Select it and press Comment in the toolbar (or ⌘⇧M), write, and press Enter. The text is highlighted and the thread opens in the comments panel on the right. Click highlighted text to jump to its thread, or a thread to jump to its text. The highlight moves with the text as anyone edits it, live or not.
  • On the page. Under the title, Add a comment starts a discussion about the whole note.
  • In a thread. Reply, type @ to mention someone, react with an emoji, edit or delete your own comments, and Resolve (✓) when it's done. Resolved threads move to the panel's Resolved tab, where Reopen brings them back.
  • Notifications. When someone mentions you, or replies in a thread you wrote in, it shows in the bell. Opening the note marks it read.
  • Anyone who can open a note can comment on it. Comments on text need edit access, because the highlight is saved in the note as <span data-comment="…">; Obsidian shows that as plain text.

Code, tables and equations

  • Code. Pick the language above a code block (it is the fence's language in the markdown, so ```python), and the code is coloured as you type. Copy puts the code on the clipboard. Tab indents by two spaces. A language Notes doesn't list is kept as written.
  • Tables. With the cursor in a table, a bar above it adds a row above or below or a column left or right, and deletes the row, the column or the table. Tab and ⇧Tab move between cells, and Tab in the last cell adds a row. Drag across cells to select several. The first row is always the header, as in every markdown table.
  • Equations. $$ and a space, or Block equation in the / menu, adds a display equation; $x$ typed in a line makes an inline one. Click an equation to edit its TeX, with a live preview; Enter closes the editor and ⇧Enter adds a line. Equations are drawn with KaTeX, which Notes serves itself, fonts included.

Diagrams

A code block in the mermaid language is drawn as a diagram, the way Obsidian and GitHub draw it. Type / and a diagram type to start from a small example: Flowchart, Sequence diagram, Class diagram, State diagram, Entity relationship, Gantt chart, Pie chart, User journey, Timeline, Git graph, Mindmap, Quadrant chart or C4 diagram. / → Mermaid adds a plain graph, and an empty diagram block offers the same gallery.

  • Code, Preview and Split. The bar above a diagram switches between the code alone, the drawing alone and both, side by side when the page is wide enough. The view you pick is saved with the block. In Preview, click the drawing (or press Enter on it) to edit: the code opens beside the drawing while the cursor is in it.
  • Live drawing. The drawing follows a quarter of a second after you stop typing. A mistake shows Mermaid's message under the drawing with the line it names, that line is marked in the line numbers, and the last good drawing stays in view until the code draws again. Mermaid's words, arrows, strings and %% comments are coloured in the code.
  • Zoom and full screen. Hover the drawing for − / + and the zoom level (click it to fit the width again), full screen, and Export. ⌘ or Ctrl with the scroll wheel (or a trackpad pinch) zooms, and dragging pans a zoomed drawing. With the drawing focused, +, -, 0, the arrow keys and F do the same. Full screen fits the whole drawing; Esc closes it.
  • Export. Download SVG, Download PNG (at twice the size) or Copy as image. The file is made in your browser on the page's colour and named after the caption.
  • Caption. Hover under a diagram to add a caption. It is saved in the block's fence, as ```mermaid caption="Sign-in flow", so the note still opens in Obsidian and GitHub.
  • Readable in light and dark. Diagrams use the colours of Notes with real contrast, and labels on a line sit on the page colour, so a label never reads over the line it names.
  • Mermaid runs in its strict mode: a diagram can't run scripts, open links or show HTML, and the drawing is cleaned before it is shown. Mermaid is part of Notes, not fetched from elsewhere, and loads only for notes with a diagram.

Markdown shortcuts

Type these at the start of an empty line (the first group) or around some text (the second), as in Notion:

Type To get
/ the block menu; keep typing to search it
[[ a link to a note; keep typing to search your notes
@ a mention of a person or a date
#, ## or ### and a space Heading 1, 2 or 3
#### and a space Heading 4
-, * or + and a space Bulleted list
1. and a space Numbered list
[] and a space To-do
> and a space Toggle
>>> and a space Toggle, open, the cursor in its summary (Linear's collapsible section)
" and a space Quote
``` Code block
---, or ___ or *** and a space Divider
|-- on an empty line A table with three columns and a header row (not inside a list, a table or code)
$$ and a space Equation block
**text** Bold
*text* or _text_ Italic
~text~ or ~~text~~ Strikethrough
`text` Inline code
==text== Highlight
$x$ Inline equation
: and a name An emoji; keep typing to search (:tada: typed in full becomes 🎉)
an emoticon and a space Its emoji, see below

Emoticons

A typed emoticon becomes an emoji when you type a space or punctuation after it: :) and :-) 🙂, :( 🙁, :D 😄, ;) 😉, :P 😛, <3 ❤️, :o 😮, :| 😐. It turns only on its own (at the start of a line or after a space), never in code, in a link or right after a mention, so http://a:) stays as typed. Backspace or ⌘Z right after puts the emoticon back. To stop it, turn off Turn typed emoticons into emoji in Venom Tasks → Settings → Preferences; the switch is yours and applies in Notes and in Tasks.

What is kept even without a block for it

Anything the editor has no block for is kept exactly as written and shown as source: HTML, footnotes and their definitions, reference-style links, %%comments%%, tags and block ids. Saving never drops a character of it.

A few things are tidied on the first save without changing what the note says: one blank line between blocks (extra blank lines become empty lines in the editor and are saved back), # headings instead of underlined ones, fenced code instead of indented code, --- for every divider, and table columns padded to line up. After that, saving the same note gives the same bytes.