Docs

Editor

Boki's article editor — formatting, collaboration, and AI assistance

Editor

Boki's editor is where you write. It supports rich text, markdown, MDX, real-time collaboration, and inline AI assistance.

Editor features

Rich text editing

  • Headings (H1-H6)
  • Bold, italic, underline
  • Bulleted and numbered lists
  • Blockquotes
  • Code blocks with syntax highlighting (supports JavaScript, Python, TypeScript, YAML, and more)
  • Tables
  • Images
  • Links

Heading outline sidebar

The editor includes a heading outline sidebar that shows your document structure at a glance:

  • See all headings in your article as a navigable outline
  • Click any heading to jump to that section
  • Toggle the outline sidebar on or off from the editor toolbar
  • Useful for navigating long articles and checking document structure

Markdown support

Write in markdown syntax. The editor renders it in real-time.

Common markdown:

  • # Heading for headings
  • **bold** for bold
  • *italic* for italic
  • - item for lists
  • `code` for inline code
  • ```language for code blocks

MDX support

MDX lets you include React components in your content. Use components from the Components library or write custom JSX.

Real-time collaboration

Multiple people can edit the same article simultaneously:

  • See cursors showing who's where
  • Changes sync in real-time
  • No conflicts — everyone sees the same document

Version history

Every change is saved with full history:

  1. Click History in the editor toolbar
  2. See a list of versions with timestamps
  3. Click a version to see what changed:
    • Diff view: Line-by-line additions and removals are highlighted
    • Preview toggle: Switch to see the full version content
  4. Click Restore to revert to that version

Restoring versions safely

When you restore an earlier version, Boki preserves any unsaved changes as a separate version. This means you can restore confidently — your current work is not lost, and you can return to it if needed.

If history fails to load

If version history fails to load (network error, etc.), you'll see a retry option. Click it to attempt loading again.

Comments

Leave comments for collaborators on articles, briefs, and plans.

Adding a comment

  1. Highlight text
  2. Click the comment icon
  3. Type your note
  4. Click Post

Comments appear in the sidebar. Resolve them when addressed.

Quoted-text anchoring

Comments can anchor to specific quoted text in the content. When you highlight text before commenting, the comment stays tied to those exact words. This keeps feedback precisely where it belongs, even as the document changes around it.

Comments across content types

Inline comments work on:

  • Articles: Comment on article body text
  • Briefs: Comment on brief descriptions and content
  • Plans: Comment on plan details

The same commenting workflow applies everywhere — highlight, comment, resolve.

Comments via MCP

Comments are also exposed through MCP tools, so external AI assistants and automation workflows can participate in your review process. See MCP tokens reference for the available comment tools.

Ask Boki inline

Access AI assistance while writing:

  1. Highlight text (50+ words for reviews)
  2. Click the sparkle that appears
  3. Choose an action:
    • Ask a question
    • Technical review
    • Marketer review
    • LLM visibility (beta)

See Ask Boki in editor for details.

Keyboard shortcuts

ActionWindows/LinuxMac
BoldCtrl+BCmd+B
ItalicCtrl+ICmd+I
Heading 1Ctrl+Alt+1Cmd+Opt+1
Heading 2Ctrl+Alt+2Cmd+Opt+2
Code blockCtrl+Shift+CCmd+Shift+C
SaveCtrl+SCmd+S
UndoCtrl+ZCmd+Z
RedoCtrl+Shift+ZCmd+Shift+Z

Word count

The editor displays:

  • Current word count
  • Target word count (from brief)
  • Progress toward target

Autosave

Changes save automatically. The editor shows your save status:

StatusMeaning
SavingChanges are being saved
PendingChanges are queued to save
Last saved [time]All changes are synced, with the timestamp of the last save

The autosave status helps you know when it's safe to close the editor or share your work.

Protection during editing

The editor protects your unsaved changes across autosave, page refresh, collaboration, and version restore. If you have unsaved changes when attempting an action that would discard them (like refreshing with newer edits pending), you'll be warned before proceeding.