DOCUMENTATION
Documents & workspace
Tabs, a file tree, a collapsible outline, and an informative status bar keep your writing context organized without stealing your attention.
Multi-tab editing
- Each tab keeps its own cursor, selection, scroll position, undo/redo history, preview, outline, and cached derived Markdown state.
- Opening an already-open Markdown or plain-text file focuses its existing tab instead of creating a duplicate.
- Opening a file—from the file tree, drag-and-drop, Open Recent, or File → Open—targets the current tab when that is safe (an image tab, a clean untitled document, or another unmodified document) and otherwise opens a new tab. A dirty document is never silently replaced.
Closing tabs and quitting
In v0.2.8, unsaved changes trigger a Save / Don’t Save / Cancel choice. Save writes the affected documents first, using Save As for untitled drafts. Don’t Save discards the changes and their recovery snapshots. Cancel keeps everything open. One quit dialog covers all dirty tabs.
File tree
Open Folder changes the workspace root and populates the Files sidebar, nested by directory hierarchy; empty folders are listed too:
- Markdown files, visually distinguished in the tree
- A curated set of plain-text files—
.txt,.text,.log,.csv,.tsv,.org,.rst,.adoc/.asciidoc—opened as UTF-8 text - Supported image files—
.png,.jpg/.jpeg,.gif,.webp,.bmp,.tif/.tiff,.svg—opened as read-only image tabs that fit oversized images within the content area
- Expanding a folder reveals exactly one level of children, so deeply nested workspaces can be drilled into one level at a time.
- A Show hidden files/folders preference (default off) reveals dotfile entries plus the Windows hidden-attribute flag, while always-excluded build, dependency, and VCS noise (
target,node_modules,.git, …) stays hidden regardless. - Right-click menus provide open, open in new tab, create file/folder, rename, delete, Copy Path, Copy Relative Path, reveal in the system file manager, filter, and refresh actions where applicable.
- Files and folders can be named inline; deleting a non-empty folder requires an additional confirmation.
- Drag any file or folder row onto a folder, a file inside a folder, or the workspace root to move it on disk; affected open tabs are remapped to the new paths. Markdown files can also be dragged from the operating-system file manager into Markion.
- The Files and Outline panels are toggleable, and the sidebar and split-pane dividers are draggable. Files and Outline also provide draggable scrollbars. Markion remembers the window size and position, maximized state, sidebar width, and split ratio, restoring them safely on the next launch.
Outline panel
The Outline panel lists the document's heading hierarchy as a collapsible tree: each heading with descendants exposes a disclosure control, and outlines start fully expanded. Folding is per-document and session-only, and the section containing the cursor is highlighted. Clicking a heading jumps to its source position—or to the rendered heading in Read mode.
Status bar
The native window title shows the active filename with a * for unsaved changes. The status bar shows save state, transient feedback, and persistent context:
- The active document's character and word count
- The caret's one-based line and column when an editing surface is present
- The current Git branch when the document or workspace belongs to a repository
Data safety
- Atomic writes. Document writes are same-directory atomic replacements that preserve the existing path and dirty state when a write fails—your edits are never lost.
- External-change detection. Markion tracks the last known on-disk file identity, detects external changes before save and while a document is open, automatically reloads only clean documents, and gives dirty documents an explicit reload, overwrite, or save-copy conflict choice.
- Auto-save. Writes recovery snapshots after five seconds of inactivity by default. Set a 1–300 second delay in Preferences → General, or disable Silent Save to retain recovery without overwriting the original file. Untitled documents always use recovery copies; restored recovery snapshots stay durable until a successful save, explicit discard, or an atomically written successor supersedes them.
- Recovery manager. Inventories every recovery snapshot with its original path and disk relationship, and supports Restore, Discard, Restore All, and Discard All without deleting unreadable or unselected data.