Markdown
Markdown uses symbols to format text. For example, type **bold** or *italic*.
Kosshi supports a subset of Markdown. Formatting symbols appear while editing and hide when the cursor leaves the row.
Formatting Bar
The Formatting Bar appears below the outline. On Mac, choose Show Formatting Bar from the … menu at the upper right of the editor, or turn it on in Settings > Appearance > Controls. To hide it, choose Hide Formatting Bar from the bar’s own … menu. Select text or place the cursor in a row, then choose a button to apply formatting or insert an item.
The bar includes:
- Bold, Italic, and Highlight
- Checkboxes, Blockquote, Insert Table, and Insert Link
- … for Prose, Strikethrough, Code, Code Block, Math, Math Block, and Image
- # and % for headings and document comments when Headings (Beta) is enabled
The link and image buttons open a small form for the URL and optional display text. The bar scrolls horizontally when the window is narrow and is hidden while Preview is open. On iPhone and iPad, the same editing actions are available in the keyboard toolbar while editing.
Supported Formatting
| Syntax | Result |
|---|---|
**text** | Bold |
*text* | Italic |
~~text~~ | |
==text== | Highlight |
==🟢text== | Highlight in a color |
`code` | Inline code |
[link](URL) | Link |
 | Image from the web |
Highlights
Wrap text in == to highlight it. When you type the opening ==, color choices appear next to the text. Choose one, or keep typing to use the default color. On Mac, you can also choose with the arrow keys and Return.
To highlight text you have already written, select it and choose a color from Highlight. Highlight is available in:
- The Formatting Bar on Mac, and the keyboard toolbar on iPhone and iPad
- Format > Highlight in the menu bar on Mac
- Highlight in the Mac context menu
On iPhone and iPad, you can also touch and hold Highlight in the controls panel, then slide to a color.
To change a highlight's color, select the highlighted text and choose another color. Choose None to remove the highlight.
In the Markdown source, a color is written as an emoji after the opening ==, such as ==🟢text==.
Tables
Type a header such as | a | b | and press Return to start a Markdown table. You can also choose Insert Table from Find Action (Cmd+Shift+A), then edit cells and manage rows or columns with table commands, or switch to Edit as Markdown to change the source directly.
Tables export with Markdown and other formats that support them.
Checkboxes
Type [ ] or [x] at the start of a row to create a checkbox. Click a checkbox or press Cmd+Enter to toggle it.
You can hide checked rows to show only remaining tasks.
Blockquotes
Prefix a row with > to create a blockquote.
Code Blocks
Wrap code with ``` to create a code block. Add a language name like ```python for syntax highlighting.
Inside code blocks, Tab inserts 4 spaces for indentation.
On macOS, move the pointer over a blockquote or code block to show a button that copies only the block contents.
Math
Kosshi renders LaTeX math inline with the rest of the text.
| Syntax | Result |
|---|---|
$E = mc^2$ | Inline math |
$$\int_0^1 x^2 \, dx$$ | Block math |
Shortcuts
| Shortcut | Description |
|---|---|
| Cmd+B | Toggle bold |
| Cmd+I | Toggle italic |
Highlight has no default shortcut. You can assign one under Settings > Keyboard.
Markdown Symbol Visibility
Turn on Always Show Markdown Symbols under Settings > Appearance > Content to keep markers visible even when the cursor leaves the row.
Formulas
For totals, writing length, and checkbox progress using expressions such as {{ sum }}, see the Formulas guide.
