Every item in Kirbon’s menus, the sidebar menu and the toolbar’s More menu — what it does and where to read more.
Every command Kirbon has is in the menu bar. A command that can’t be used right now is dimmed, and its tooltip says why — “Open a documentation window first”, “Not for this row”, or “Not available yet” for the few that come in a later version. Toggle items name what they will do: Show Sidebar becomes Hide Sidebar while the sidebar is shown.
Kirbon#
| Item | What it does |
|---|
| Settings… ⌘, | Opens Settings — see Settings. |
| Hide Kirbon ⌘H, Quit Kirbon ⌘Q | As in every Mac app. Quitting saves pending edits first and asks about any that couldn’t be saved. |
File#
| Item | What it does |
|---|
| New Page in “section” ⌘N | A new page in the section of the selected page. |
| New Child Page ⇧⌘N | A new page inside the selected page or section. |
| New Section… | A new folder with its own README.md page. |
| New Documentation… | A new documentation folder with a Home page. |
| New Window ⌥⌘N, New Tab ⌘T | The current page again, in the same view. |
| Open Folder… ⌘O | Opens a folder of Markdown as documentation. |
| Open Recent ▸ | The last ten documentation folders; Clear Menu forgets those that aren’t open. |
| Close ⌘W | Closes the tab or window. Unsaved work is saved first. |
| Save ⌘S | Saves now. Enabled only when there is something to save or a save failed. |
| Rename… | Renames the page, its file and the links to it — see Pages and sections. |
| Move To… | Moves the page to another section, updating links. |
| Duplicate Page ⌘D | A copy next to the original. |
| Turn into Page / Turn into Folder… | Gives a folder its own page, or turns a page with child pages back into a folder. |
| Add Home Page / Remove Home Page… | Gives the documentation a Home page (README.md at the top of the folder), or moves Home to the Trash. |
| Move to Trash ⌘⌫ | Moves the selected page to the Trash (from the sidebar). |
| Show in Finder | Reveals the page’s file in Finder. |
| Export as PDF…, Page Setup… ⇧⌘P, Print… ⌘P | Print or save the page as PDF, as it looks in Preview. |
Edit#
| Item | What it does |
|---|
| Undo ⌘Z / Redo ⇧⌘Z | Named after the step: “Undo Typing”, “Undo Move “Deployment””. Page edits undo per page; page operations undo per window. |
| Cut, Copy, Paste, Select All | As usual. Pasting tab-separated cells makes a table — see Tables. |
| Paste and Match Style | Not available in this version. |
| Copy Link to Page | Copies a Markdown link to the selected page. Hold ⌥ for Copy File Path — the file’s full path. |
| Find ▸ | Find… ⌘F, Find and Replace… ⌥⌘F (Markdown), Find Next ⌘G, Find Previous ⇧⌘G, Use Selection for Find ⌘E. |
| Spelling and Grammar, Substitutions, Transformations, Speech | The standard macOS text submenus. |
View#
| Item | What it does |
|---|
| Visual ⌘1, Markdown ⌘2, Preview ⌘3 | The three views — see Visual, Markdown and Preview. |
| Preview Side by Side ⌥⌘P | Markdown and Preview next to each other (in Markdown, in a wide enough window). |
| Show / Hide Sidebar ⌃⌘S | The page tree. |
| Show Outline ⌥⌘O, Show / Hide Page Info ⌥⌘I | The inspector on its Outline or Info tab. |
| Show / Hide Formatting Controls | The formatting group in the toolbar, in every window. |
| Show / Hide Toolbar ⌥⌘T, Customize Toolbar… | The toolbar and its items. |
| Expand Table / Done ⌥⌘↩, Open Table in New Window | The table at the caret across the window, or in a window of its own. |
| Read Only | Locks the current page in this window. |
| Enter / Exit Focus Mode ⇧⌘↩, Enter / Exit Full Screen ⌃⌘F | Just the page; full screen. |
| Actual Size ⌘0, Zoom In ⌘+, Zoom Out ⌘− | The size of the page text in this window. |
Insert#
Available while you edit a page in Visual (Link also in Markdown). Typing / on the page offers the same items.
| Item | What it does |
|---|
| Link… ⌘K | Inserts or edits a link — see Links, images and callouts. |
| Table | A 3 × 3 table with a header row. |
| Callout ▸ | Note, Tip, Important, Warning or Caution. |
| Code Block, Quote, Divider | The block after the one at the caret. |
| Image…, File… | Adds files to the page’s attachments. |
| Item | What it does |
|---|
| Paragraph ⌥⌘0, Heading 1–4 ⌥⌘1–⌥⌘4 | The style of the paragraph at the caret. |
| Bold ⌘B, Italic ⌘I, Strikethrough ⇧⌘X, Code | Inline styles; in Markdown, Bold, Italic and Strikethrough wrap the selection in **, * and ~~. |
| Bulleted List, Numbered List, Task List | Turn paragraphs into a list, change its kind, or turn items back into paragraphs. |
| Toggle Task ⌘↩ | Ticks the task at the caret. |
| Move Block Up / Down ⌃⌘↑ ⌃⌘↓ | Moves the block at the caret, a list item, or a selected table row. |
| Move Section Up / Down | Swaps the section at the caret with its neighbour of the same level. |
| Table ▸ | Insert Row Above ⌥⌘↑ / Below ⌥⌘↓, Insert Column Left / Right ⌥⌘→, Duplicate Row, Clear Contents, Align Left / Center / Right, Delete Row, Delete Column, Delete Table, Select Row, Select Column, Sort A→Z, Copy as Spreadsheet Data, Move Column Left ⌃⌘← / Right ⌃⌘→. |
Navigate#
| Item | What it does |
|---|
| Back ⌘[, Forward ⌘] | Through this tab’s history, including jumps within a page. |
| Search Documentation… ⇧⌘F, Quick Open… ⇧⌘O | Find pages and text — see Search and Outline. |
| Filter Pages | Shows the sidebar if needed and puts the caret in its filter field. |
| Reveal in Sidebar ⇧⌘J | Selects the current page in the tree. |
| Go to Section ▸ | The page’s headings: choose one to jump there. |
| Filter Outline | Opens the Outline with the caret in its filter field. |
| Starred ▸ | Your starred pages. |
Window and Help#
Window has the standard items — Minimize ⌘M, Show Next Tab ⌃⇥, Show Previous Tab ⌃⇧⇥ and the list of windows. Help ▸ Keyboard Shortcuts ⌘/ lists every shortcut by menu; Kirbon Help is not available in this version — this documentation is the help.
Right-click a page in the sidebar, or click the ⋯ on its row:
| Item | What it does |
|---|
| Open in New Tab (⌘-click), Open in New Window (⌥-click) | Opens the page without leaving the current one. |
| New Child Page in “page”, New Page in “section” | New pages right where you are. |
| Rename… (Return), Duplicate (⌘D), Move To… | Organise the page. |
| Add to Starred / Remove from Starred | Star the page. |
| Copy Link to Page (⌥: Copy File Path), Show in Finder | Share or find the file. |
| Turn into Page / Turn into Folder… | For sections and pages with child pages. |
| Remove Home Page… | On the Home row. |
| Move to Trash (⌘⌫) | Moves the page to the Trash. |
The Pages header at the top of the tree has its own menu — the ⋯ that appears when you point at it, or a right-click: New Page in “documentation” and New Section… at the top level and, when the documentation has no Home page, Add Home Page. Its + makes a page at the top level.
The ⋯ button in the toolbar holds Read Only and Enter Focus Mode, and, in narrow windows, whatever no longer fits in the toolbar.