Markdown in FUTO Notes (syntax, tables, code, and images)

FUTO Notes saves every note as a plain .md file and supports CommonMark plus the GitHub extensions: tables, task lists, strikethrough, and bare URLs as links. You type markdown directly, and the editor formats it straight away. The symbols stay hidden, even on the line you’re editing.

How the editor shows markdown

The editor shows formatting instead of symbols. Headings show large, **bold** shows bold, and [[wikilinks]] show as links, with the #, **, and brackets hidden.

Moving the cursor never brings the symbols back. Tables, dividers, and images always show as the thing itself.

Opening a note never changes it. The first time you edit a note, FUTO Notes rewrites its markdown in one standard style, so every device saves the same bytes. Front matter is kept exactly as written.

Supported markdown syntax

Element	Syntax
Headings	`#` through `######` at the start of a line
Bold	`bold` or `__bold__`
Italic	`italic` or `_italic_`
Strikethrough	`~~struck~~`
Inline code	`code`
Code block	``` or `~~~` on its own line, optionally followed by a language
Blockquote	`>` at the start of a line. Quotes can nest (`> >` )
Bullet list	`-` , `*` , or `+`
Numbered list	`1.`
Task list	`- [ ]` or `- [x]`
Divider	`---`, `***`, or `___` on its own line
Link	`[text](https://example.com)`, `<https://example.com>`, or a bare `https://` or `www.` address
Image	`![](image.png)`
Wikilink	`[[Note title]]` (see wikilinks)
Tag	`#tag` (see folders and tags)
Table	GitHub-style pipe table (see tables)

Click or tap a task’s checkbox to toggle it between [ ] and [x]. The note saves on its own.

Formatting without typing the syntax

Desktop: select text to open a toolbar with Text, Heading 1, 2, and 3, Quote, Bold, Italic, Strikethrough, Code, and Link, plus Indent and Outdent inside a list or quote. The keyboard shortcuts are in keyboard shortcuts.
iOS and Android: while you type, a toolbar above the keyboard has Undo, Redo, Bold, Italic, Strikethrough, Link, Text, Heading 1, 2, and 3, Block quote, Code block, Bullet list, Ordered list, Task list, Indent and Outdent (inside a list or quote), and two image buttons.
Moving a block: on desktop, drag the ⠿ handle to the left of a paragraph, heading, list item, or other block. On iOS and Android, long-press the block and drag it.

On desktop, type / at the start of a line to open the Insert block menu. Keep typing to filter it, use the arrow keys to move, and press Enter or Tab to pick. Escape closes it. On iOS and Android, use the toolbar instead.

Item	Inserts	Also matches
Text	Plain text (removes a heading or list)	`paragraph`, `body`, `p`
Heading 1, 2, 3	A heading	`h1`, `h2`, `h3`, `title`
Bullet list	A bullet list	`ul`, `unordered`, `list`
Numbered list	A numbered list	`ol`, `ordered`, `number`
Task list	A task list	`todo`, `checklist`, `checkbox`
Quote	A block quote	`blockquote`, `citation`
Code block	A fenced code block	`pre`, `fence`, `snippet`
Divider	A horizontal rule	`hr`, `horizontal`, `rule`, `separator`, `line`
Table	A three-column table with a header row and two empty rows	`grid`, `cells`, `rows`
Link	Opens a field for the address	`url`, `hyperlink`
Image	Opens a file picker	`picture`, `photo`, `img`, `file`

Links

Type or paste a bare https:// or www. address and it becomes a link when you finish the word with Space or Enter. Link syntax you type by hand, such as [text](url), stays as text; only the address inside it becomes a link. To give a link its own text, select the text and use Link.

Clicking or tapping a link opens it in your system browser. Only the link text itself is clickable, so clicking the empty space after a link puts the cursor there instead.

Link, in the toolbar or the slash menu, opens a field for the address. With text selected, it links that text or changes its address, and clearing the field removes the link. With nothing selected, it inserts the address as its own text.

Tables

FUTO Notes reads and writes GitHub-style pipe tables:

| Item   | Qty |
|--------|----:|
| Apples |   3 |

On desktop, type /table to insert one. A table shows as a grid you can type into directly:

Key	What it does
Tab	Next cell. Past the last cell, adds a row
Shift+Tab	Previous cell
Enter	Cell below in the same column. On the last row, adds a row
Down at the end of a cell / Up at the start	Cell below / cell above
Escape	Leave the table

Hovering over a column shows a small grip above it, and hovering over a row shows one at its left edge. Click the grip to open a menu with Insert before, Insert after, and Delete.

Code blocks and syntax highlighting

Start a fenced code block with ``` or ~~~ and a language name, such as ```python, or use /code on desktop. Inside a code block, Enter always adds a new line and Tab indents. To move keyboard focus out, press Escape and then Tab.

These languages are highlighted. The names in parentheses also work as the fence tag, and case doesn’t matter:

JavaScript (js, node, mjs, cjs), TypeScript (ts), JSX, TSX
Python (py), Rust (rs), Go (golang), C (h), C++ (cpp, cc, hpp), C# (csharp, cs), Objective-C (objc)
Java, Kotlin (kt), Scala, Dart, Swift, PHP, Ruby (rb), Perl (pl), Lua, R, Haskell (hs)
HTML (htm), CSS, JSON (json5, jsonc), XML (svg), YAML (yml), TOML, Markdown (md), SQL, Vue
Shell (bash, sh, zsh), PowerShell (ps1), Dockerfile (docker), diff (patch)

A code block in any other language still displays as a code block, without color. Wikilinks and tags inside code are plain text.

Front matter

YAML front matter (a --- block at the top of a file) shows as a read-only panel above the note. You can’t edit it in FUTO Notes, and it stays in the file exactly as written.

Images

How you add an image depends on the platform:

Desktop: paste an image, such as a screenshot or a browser’s Copy Image, drag image files onto the note, or type /image to choose a file.
iOS and Android: use the camera or photo button in the keyboard toolbar (Take photo or Choose from library), or paste an image.

Each way copies the image into the top level of your notes folder under a generated name, such as image-1755176705123-3fa9c1d2e4b7.png on desktop or image-20260814-130425.png on iOS and Android, and inserts a link such as ![](image-20260814-130425.png) at the cursor. The image is its own file next to your notes, not embedded in the .md file. See where FUTO Notes stores your notes to find that folder.

Supported formats are JPG, PNG, GIF, WebP, SVG, BMP, ICO, AVIF, and HEIC. The image shows in place of its ![](…) text.

With sync turned on, image files sync along with your notes, so an image you add on one device shows up on the others.

Deleting the ![](…) text removes the image from the note but leaves the file in your notes folder. On desktop, the sidebar’s Images view lists every image in your vault and can delete one.

An image with a web address, such as ![](https://example.com/cat.png), is loaded from that server when the note is shown, so opening the note contacts it.

Next steps

Wikilinks: link one note to another with [[ ]].
Keyboard shortcuts: every formatting and editing key on desktop.
File format: how notes and images are saved on disk.
Download FUTO Notes to try the editor.