Document editor

Markdown editing basics

Write Markdown notes in the Note kit with live preview, the menus, the slash menu, and the keyboard shortcuts it supports today.

Updated

By Kition Docs

Verified against Kition 0.2.0 (7d49036f) on 2026-11-06

Markdown is the saved source

Kition opens .md and .markdown files in the Note kit. The file stays plain Markdown text: opening and saving a note without changes gives back the same bytes, and an edit changes only the lines it touches. New notes are created as Untitled note.md.

The editor is live preview only. Markdown syntax is shown on the lines you are editing and drawn as headings, links, task boxes, tables, callouts, math, and diagrams everywhere else. There is no separate source mode or reading view.

Plain .md# Meeting notesSee [[Roadmap]]- [ ] follow up`kition sync`Live previewMeeting notesSee Roadmap☐ follow upkition sync
The editor renders Markdown while the workspace keeps the text source.

Core syntax

  • # through ###### — heading levels 1 through 6
  • - item or * item — unordered list
  • 1. item — ordered list
  • - [ ] item and - [x] item — task list items; click the box to toggle it
  • bold, *italic*, ~~strike~~, ==highlight==, and ` inline code `
  • [label](https://example.com) — external or Markdown link
  • ![alt](image.png) or ![[image.png]] — image from the workspace, drawn when it is alone on its line
  • > quote — blockquote
  • Triple-backtick fences — code blocks, colored by language
  • Pipe-delimited rows — Markdown tables, edited as a grid
  • %%comment%%, footnotes, #tags, and ^block-id markers
  • Front matter between --- lines — shown as an editable properties block

Editor shortcuts

  • Cmd/Ctrl + B — bold
  • Cmd/Ctrl + I — italic
  • Cmd/Ctrl + E — inline code
  • Cmd/Ctrl + Shift + K — strikethrough
  • Cmd/Ctrl + Shift + H — highlight
  • Cmd/Ctrl + K — link
  • Cmd/Ctrl + 1 through 6 — heading level of the current line
  • Cmd/Ctrl + Shift + [ and ] — promote or demote a heading
  • Cmd/Ctrl + Shift + 7, 8, 9 — numbered, bulleted, or task list
  • Cmd/Ctrl + L — toggle the task checkbox
  • Cmd/Ctrl + ] and [ — indent or outdent
  • Cmd/Ctrl + Shift + . — quote
  • Cmd/Ctrl + Shift + C — code block
  • Cmd/Ctrl + / — wrap the selection in a %%comment%%
  • Cmd/Ctrl + D — delete the paragraph
  • Cmd/Ctrl + ; — add a front-matter property
  • Cmd/Ctrl + F — find; Cmd/Ctrl + Alt + F — find and replace; Cmd/Ctrl + Alt + L — go to line
  • Tab and Shift + Tab — move between table cells or change list indentation

Note

The menus show each command’s shortcut next to its name, so check them there if a key does not do what you expect.

Menus, slash menu, and right-click

The note’s menus are File, Edit, Format, Insert, View, and AI. Right-click the text for Format, Paragraph, and Insert submenus plus Cut, Copy, Paste, Paste as plain text, and Select all.

Type / at the start of a line or after a space to open the slash menu: headings 1 to 3, bulleted, numbered, and task lists, quote, code block, table, callout, math block, divider, image, link, wikilink, and date. Type # after a space to complete a tag already used in the note.

Pasting and portability

HTML pasted from a web page goes in as Markdown. A pasted or dropped image is saved as a new file in the workspace’s attachments/ folder and linked from the note.

Obsidian syntax such as wikilinks, callouts, highlights, and block ids stays readable as plain text in another editor, but how it is drawn there depends on that application.

Implementation sources

Related pages

Ready when you are.

Kition is a desktop AI workspace for connected documents, structured tables, editable designs, whiteboards, visual workflows, and reviewable AI agents.