OctarineOctarine Docs
iOS / Editing and Formatting /

Editor

Write and format your notes with a rich Markdown editor and toolbar

The editor is where you write. It's a rich Markdown editor that renders formatting as you type, auto-saves your changes, and gives you quick access to every block type from a single toolbar.

Opening a Note

Tap any note from the Notes page, Home, Daily Desk, Search results, or any other list. The editor opens full-screen — the bottom navigation bar hides to give you the full screen for writing. Swipe from the left edge to go back.

The Editor Header

A thin header sits above the note. It has a back button on the left and a row of circular buttons on the right:

ButtonWhat it does
Tasks pillShows the incomplete/complete task count for the note. Tap to see a detailed breakdown.
Lock (closed lock)Only appears when the note is locked. Tap to unlock and make it editable again.
Info (i)Opens the Note Info panel (Stats, Outline, Backlinks).
Options (slider icon)Opens the actions sheet — pin, lock, rename, duplicate, move, delete, copy, and more.

Daily and weekly notes only show Info and Options after the file has been created.

The Toolbar

When the keyboard is active, a toolbar appears directly above it. It scrolls horizontally. From left to right:

ButtonWhat it does
Undo / RedoStep backward or forward through your edits
Clear FormattingRemove all marks and block styling from the selection
DictationStart voice-to-text input (only shown if dictation is enabled and the model is downloaded)
+ (Block Picker)Open the block picker panel to insert any block type
[[Insert a wikilink and open the suggestion popover
BBold
IItalic
`Inline code
HighlightApply a colored background to text
Text colorApply a color to text
Bullet listStart or toggle a bullet list
To-do listStart or toggle a checkbox list
ImageInsert an image

When your cursor is inside a list, indent and outdent buttons also appear. A Hide Keyboard button sits at the far right, pinned outside the scrollable row.

Active formatting (e.g., bold is on at the cursor) is shown with a highlighted button state. Long-press any toolbar button to see its name as a toast.

Block Picker

Tap the + button in the toolbar to open the block picker panel, which slides up from the bottom. It's organized into sections:

Blocks — Text, Heading 1 through Heading 6, Bullet List, Numbered List, To-do List, Code Block, Blockquote, Inline Code, Divider, Table, Mermaid, Math Block.

Insert — Wiki Link, Image, File attachment, Today's Daily, Tomorrow's Daily, Yesterday's Daily.

Templates — if your workspace has templates, each one appears as a button. Tapping inserts the template's content at the cursor and merges its frontmatter into the current note.

Highlight — Remove highlight, plus Red, Orange, Yellow, Green, Blue, Purple color options.

Colored Text — the same seven color options applied to text instead of background.

Callouts — Info, Tip, Warning, Error, Success.

Date & Time — Today's Date, Tomorrow, Yesterday, Current Time, Date & Time.

Tap any item to insert it at your cursor position.

Options Sheet

Tap the slider icon in the editor header to open the options sheet:

ActionWhat it does
Properties / Add PropertyOpen the properties sheet for this note
Pin / UnpinToggle the note's pinned state (not shown for templates)
Make note read-only / Make note editableToggle the locked frontmatter
Copy ContentCopy just the note's markdown body
Copy with PropertiesCopy the markdown body together with its YAML frontmatter
RenameRename the note via an inline field
DuplicateCreate a copy of the note
Move to FolderMove the note to the workspace root or another folder (not shown for daily/weekly notes or templates)
DeleteDelete the note after confirmation

Text Formatting

Standard Markdown formatting is available through the toolbar or by typing the syntax directly:

FormatToolbarMarkdown syntax
BoldB button**text**
ItalicI button*text*
StrikethroughBlock picker~~text~~
UnderlineBlock picker~text~
Inline code` button`text`

Headings

Six heading levels are available. Use the block picker or type # through ###### followed by a space at the start of a line.

Lists

  • Bullet list — tap the bullet list button or type - at the start of a line.
  • Numbered list — use the block picker or type 1. at the start of a line.
  • To-do list — tap the checkbox button or type - [ ] at the start of a line. Tap a checkbox to toggle it between complete and incomplete.

When inside a list, use the indent/outdent buttons to nest items.

Callouts

Callouts are highlighted blocks for drawing attention to specific information. Five types are available from the block picker:

TypeUse for
InfoGeneral information
TipHelpful suggestions
WarningCaution or important caveats
ErrorProblems or critical issues
SuccessConfirmations or positive outcomes

In Markdown, callouts use the blockquote syntax with a type marker:

> [!TIP]
> Your callout text here.

Code Blocks

Insert a code block from the block picker or type triple backticks (```) on a new line. Syntax highlighting is applied automatically based on the language. Many languages are supported including JavaScript, TypeScript, Python, Rust, Go, Swift, HTML, CSS, SQL, and more.

Tables

Insert a table from the block picker. Tables use standard Markdown pipe syntax:

| Header 1 | Header 2 |
|----------|----------|
| Cell 1   | Cell 2   |

Math

Octarine supports LaTeX math rendering via KaTeX.

  • Inline math — wrap an expression in single dollar signs: $E = mc^2$
  • Block math — insert a Math Block from the block picker, or use double dollar signs on their own lines:
$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$

Mermaid Diagrams

Insert a Mermaid block from the block picker to create diagrams using the Mermaid syntax. Supported diagram types include flowcharts, sequence diagrams, Gantt charts, and more.

Images and Files

Tap the image button in the toolbar — or the Image / File item in the block picker — to attach media. Images go into .attachments/; other files (PDF, plain text, Word, Excel, HTML, JSON, CSV) go into .files/. Reference them with wikilinks:

[[photo.png]]
[[photo.png|500]]
[[report.pdf]]

The number after the pipe sets the width in pixels for images.

Dictation

If dictation is enabled, the microphone button appears in the toolbar. Tap it to start recording; tap the red Stop button to finish. If the model hasn't been downloaded yet, a sheet appears prompting you to download it from Settings → Dictation.

Frontmatter

Notes can include YAML frontmatter at the very top of the file, between --- delimiters:

---
title: My Note
status: draft
pinned: true
tags:
  - project
  - planning
---

Frontmatter properties are displayed as a strip below the editor header when present. Tap the strip to open the properties sheet, where you can view, add, edit, and delete properties.

Supported property types: Text, Number, Date, Date & Time, Checkbox, List, Tags, and Files.

Note Info Panel

Tap the info (i) button in the editor header to open the Note Info panel. It has three tabs:

  • Stats — created date, updated date, word count, character count, line count, reading time, and a list of linked notes (notes this one links to).
  • Outline — a clickable table of contents generated from your headings. Tap a heading to scroll to it.
  • Backlinks — notes that reference the current note via wikilinks, with a short preview of the surrounding context.

Auto-Save

Changes are saved automatically as you type. There's no save button — just write and navigate away when you're done.