Markdown
Markdown is a lightweight way to format text using simple symbols — for example, wrapping a word in asterisks to make it bold or italic. It is widely used in blogs, note-taking apps, and documentation tools.
Kosshi supports a subset of Markdown. Markers are visible while editing and hidden 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 |
`code` | Inline code |
[link](URL) | Link |
 | Image from the web |
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.
