Document editor

Write in Miton's rich-text editor — slash menu, tracked changes, outline panel, and word count.

Product stage
Development build
Last reviewed
2026-08-27
Successful result
The change is visible in the active project.

What this accomplishes

Write in Miton’s rich-text editor — slash menu, tracked changes, outline panel, and word count.

The Writer editor is built on TipTap (ProseMirror) with formatting, lists, tables, images, code blocks, tracked suggestions, citations, and footnotes.

Tracked changes are covered below. Citations are in citation system; export in export to PDF and DOCX.

Current availability

This page documents behaviour verified in Miton development builds. Miton is still pre-release and is not publicly downloadable; invited beta users will receive a signed desktop build with automatic updates.

Before you start

  • A Miton development build, an active project and Writer open.
  • A connected model; keep the source material or existing document in the same project.

The editor surface

The editor surface is a TipTap instance with the Miton extensions loaded. The editor supports:

  • Block types — heading (1-6), paragraph, list (bullet, ordered, checklist), blockquote, code block, image, table, horizontal rule.
  • Inline marks — bold, italic, underline, strikethrough, code, link.
  • Improve suggestions — inline diff decorations for agent-proposed changes, reviewed against the original text before they are applied.
  • Citations — footnotes, endnotes, bibliography.
  • Footnotes and endnotes — numbered or symbol-prefixed.
  • Tables — with row and column headers, configurable alignment, configurable borders.
  • Images — inline or block, with caption, with alt text.
  • Code blocks — with syntax highlighting for every supported language.

The editor supports the standard keyboard shortcuts (Cmd+B for bold, Cmd+I for italic, Cmd+K for link, etc.). The full keyboard shortcut list is in the reference keybindings.

The slash menu

Type / at the start of a line to open the slash menu: Heading 1, Heading 2, Heading 3, Blockquote, Code Block, Table, Callout, Citation (opens the citation picker), and Divider. Keep typing to filter the list, navigate with the keyboard, and press Enter to insert.

The tracked-changes model

Agent-proposed improvements appear as inline diff decorations from ImproveDiffExtension. Review the original and proposed text together before applying the edit. Use the editor’s normal undo history immediately if an accepted edit is not right for the document.

The editorial principle is explained in Writing without surrendering your voice.

The outline panel

The outline panel shows the document’s structure as a heading tree, generated from the document’s headings and updated as you type. Click a heading to jump to it, and drag to reorder sections.

The word-count bar

The toolbar shows a live word count plus a Flesch-Kincaid grade-level readability score once the document has content.

The keyboard shortcuts

The editor supports the standard keyboard shortcuts:

  • Cmd+B — toggle bold.
  • Cmd+I — toggle italic.
  • Cmd+U — toggle underline.
  • Cmd+Shift+S — toggle strikethrough.
  • Cmd+` — toggle inline code.
  • Cmd+K — insert link.
  • Cmd+Z — undo.
  • Cmd+Shift+Z — redo.
  • Cmd+A — select all.
  • Cmd+X — cut.
  • Cmd+C — copy.
  • Cmd+V — paste.
  • Cmd+1 through Cmd+6 — set the current block’s heading level.
  • Cmd+0 — set the current block to a paragraph.
  • Cmd+Shift+7 — toggle ordered list.
  • Cmd+Shift+8 — toggle bullet list.
  • Cmd+Shift+9 — toggle blockquote.
  • Cmd+Alt+F — insert footnote.
  • Cmd+Shift+C — open the citation picker.

The full keyboard shortcut list is in the reference keybindings.

What the editor does not cover

The editor does not cover:

  • Real-time collaboration — the editor does not have built-in real-time collaboration. The user can use a third-party tool for real-time collaboration; the agent can sync the third-party tool’s state into the document.
  • Version control — the editor does not have built-in version control beyond the per-turn rewind. The user can use git for version control; the git integration is in the cross-cutting per-turn rewind page.
  • Comments — the editor does not have built-in comments. The user can use the tracked-changes model for inline notes; the user can also use a third-party tool for comments.

The editor focuses on the rich-text features the user can implement with the existing primitives (TipTap, ProseMirror). The features that require additional runtime are documented above; the user can extend the editor with plugins.

What success looks like

The editor is a TipTap (ProseMirror) instance with the Miton extensions. The user gets the standard rich-text features (formatting, lists, tables, images, code blocks) plus Writer-specific tools primitives (improve suggestions, citations, footnotes).

The improve-suggestions model is the right shape for AI-assisted writing. The model proposes; the user disposes. The user’s voice stays intact.

The slash menu is the entry point for inserting blocks. The user types /; the user picks a block; the block is inserted.

The outline panel and the word-count bar give a quick-glance view of the document’s structure and length as you write.

Common failures and recovery

  • Confirm the intended document and project are active.
  • Keep the original text when reviewing a model-proposed change.
  • Check the model connection and retry only the failed action, not the complete document.

Return to the Writer overview to choose the next document task.