General, Editor, Files & Attachments and Advanced — what each setting does.
Open Kirbon ▸ Settings… (⌘,). Changes apply at once to every open window — except the interface language, which applies the next time Kirbon starts.
General#
| Setting | What it does |
|---|
| Language | System, English or Русский. Changes at the next launch; Relaunch Now restarts Kirbon for you, keeping your windows. |
| Appearance | System, Light or Dark. |
| When Kirbon opens | Reopen the last documentation (default), or show the Welcome window. |
| Show the Welcome window when nothing can be reopened | On by default. |
| Keyboard shortcuts | Show All… opens the Keyboard Shortcuts window (⌘/). |
Editor#
| Setting | What it does |
|---|
| Open pages in | The view a window starts in: Visual (default), Markdown or Preview. |
| Show formatting controls | The formatting group in the toolbar. When it’s off, selecting text shows a small toolbar above the selection. |
| Check spelling while typing | In Visual. Markdown never shows spelling marks. |
| Page font, Page width | The size of page text and how wide the text column is. View ▸ Zoom multiplies them. |
| Markdown font | SF Mono 13 pt by default. |
| Show line numbers, Wrap long lines, Auto-close brackets and emphasis markers, Scroll Markdown and Preview together | Markdown view options, all on by default. |
Files & Attachments#
These settings belong to one documentation folder — pick it at the top. They are stored on your Mac, not in the folder, and only affect new pages and attachments: existing files are never renamed.
| Setting | Default |
|---|
| File names | lowercase-with-dashes — “Integration Events” → integration-events.md |
| Offer to rename the file after a title change | On |
| Update links when pages are renamed or moved | On, as part of the same Undo step |
| Page with child pages is stored as | A folder with README.md |
| Store images and files in | assets/ › page name |
| Name pasted screenshots | page-name-01.png |
| When an image is removed from a page | Keep the file |
| Allow manual page order | On — saved in a small .pages file per folder |
Advanced#
| Setting | What it does |
|---|
| Show file extensions | Show .md after page names in the sidebar. |
| Show hidden files and folders | Include names that start with a dot. |
| Section page file | Which file is a section’s page: README.md, then index.md. |
| Warnings you chose not to see again | Reset brings them back. |
| Copies kept before replacing a file | Moved to the Trash. |
| Show Git status | Not available in this version. |