---
title: Editing in Notes
description: How Venom Notes stores a note as markdown that opens in Obsidian unchanged, and which syntax each kind of block and formatting becomes.
section: cloud
order: 120
audience: [user]
sources: [services/nodejs-cloud/lib/globe/markdown, docs/globe.md]
features: [reference.doc-globe]
---

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|h2]- Heading` (Obsidian reads `|h2` as the callout's metadata) |
| 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|shown text]]`, `[[Note#Heading]]`; embeds `![[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 and mentions

- **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](/docs/cloud/people.md) becomes a chip that opens their page and shows a hover card; see
  [Notes mentions](/docs/cloud/globe-mentions.md).
- **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](/docs/cloud/tasks.md) 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 {#on-a-phone}

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:

  ````md
  ```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 {#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.
