Reference
Editor feels slow
Editor lag is a delay between an editing action and the visible response. Isolate the document, rendering mode, and surrounding activity before treating it as a general performance problem.
Updated
By Kition Docs
Verified against Kition 0.1.41 (d3e1b931) on 2026-08-29
Isolate the slow interaction
Use the same short editing action for each comparison, such as typing a sentence or scrolling a section. Change one condition at a time so the result tells you which part of the experience needs investigation. The checks below are diagnostic comparisons, not a claim that a particular file size is guaranteed to perform well.
- Save the current work and note the document and action that feel slow.
- Repeat that action in Source and Rich display to separate text editing from rendered content.
- Compare with a small plain document in the same workspace.
- Pause unrelated active work and repeat the same action.
- Report the reproducible case with the installed version and a redacted description of the document.
| Comparison | Possible area to investigate |
|---|---|
| Source versus Rich | Rendered content and decorations |
| Small document versus affected document | Document-specific complexity |
| Idle workspace versus active work | Competing runtime or interface activity |
Isolate the editor surface
Rich editing performs live-preview scans and rendering that Source view does not. If Source view remains responsive, simplify the document or close side tools before treating the embedded runtime as the cause.
- Open one small Markdown document and close search, graph, tags, tasks, backlinks, and broken-link tools
- Switch to Source view to compare the raw Markdown editor with Rich live preview
- Close other busy workspace tabs and restart Kition
- Install the current stable release and retry the same document
Reduce expensive document content
Test large Mermaid diagrams, math blocks, long tables, and many local or remote media items separately. Split an unusually large document and reintroduce complex blocks one at a time to identify the expensive section.
Workspace scans are bounded but still do work
These implementation limits are not performance promises. File size, storage latency, document content, and concurrent dialogs still affect responsiveness.
- Backlinks — scans at most 500 Markdown files
- Local graph — scans at most 400 Markdown files
- Global search — scans at most 400 files and returns at most 200 hits
- Broken links — scans at most 600 Markdown files
- Tasks — scans at most 600 Markdown files
- Vault statistics — scans at most 500 Markdown files
Report a reproducible case
Record whether the issue occurs in Rich view, Source view, or both and whether it follows one document or the complete workspace. Copy Support diagnostics from Settings → About. Share raw logs only after inspection and redaction.
Implementation sources
- v0.1.41: src/features/document/components/DocumentMarkdownEditorPane.tsx
- v0.1.41: src/features/document/editor/editor/DocumentGlobalSearch.tsx
- v0.1.41: src/features/document/editor/editor/DocumentLocalGraphDialog.tsx
- v0.1.41: src/features/document/editor/editor/DocumentBrokenLinksDialog.tsx
- v0.1.41: src/features/document/editor/editor/DocumentVaultStatsDialog.tsx
- v0.1.41: src/features/document/editor/editor/DocumentTasksDialog.tsx
Related pages
Markdown editing basics
Write GitHub-flavored Markdown in Kition’s CodeMirror editor and use the verified formatting shortcuts and live preview.
Math and Mermaid diagrams
Render inline and block KaTeX expressions plus Mermaid code fences in the live Markdown editor.
Log and configuration locations
Find the active data, cache, log, export, workspace, and configuration locations from the running Desktop app.
