Editora 0.22.0 docs. You are reading an archived version, kept so links from that release keep working. Read the 0.23.0 docs →

Editing

The text surface is a RichTextFX CodeArea with line numbers, a fold gutter, a minimap, and a current-line highlight. Most of the editing help is automatic; the rest is a command away. See the full list on the Commands page.

Multiple cursors

Edit many places at once, VS Code style.

• Add a caret at the next occurrence of the selection (edit.addCaretNextOccurrence: Ctrl+D in the VS Code and Sublime keymaps, Alt+J in IntelliJ), or above / below the current line (edit.addCaretAbove / Below: Ctrl+Alt+Up / Down in the VS Code and Sublime keymaps). The Emacs and CUA keymaps leave these to the palette.
• Select all occurrences (edit.selectAllOccurrences: Ctrl+Shift+L in the VS Code keymap, Alt+F3 in Sublime, Ctrl+Cmd+G on macOS Sublime) turns every occurrence of the selection, or of the word under the caret, into a cursor at once. Matching is literal and case-sensitive.
• Skip an occurrence (edit.skipOccurrence: Ctrl+K Ctrl+D in the VS Code and Sublime keymaps) moves the newest selection on to the next occurrence instead of adding one, so you can step past a match you don’t want. It wraps round to the start and passes over occurrences other cursors already hold.
• Remove the last added caret (edit.undoLastCaret: Ctrl+U in the VS Code and Sublime keymaps, Alt+Shift+J in IntelliJ) takes back the cursor you added most recently, then the one before it. The main cursor is never removed.
• Split a selection into lines (edit.splitSelectionIntoLines: Ctrl+Shift+L in the Sublime keymap, and in the Edit menu) turns a selection into one selection per line it covers, each holding that line’s selected part. A selection that ends at the very start of a line leaves that line out.
• Add carets to line ends (edit.addCaretsToLineEnds: Shift+Alt+I in the VS Code and CUA keymaps, Alt+Shift+G in IntelliJ) puts a bare cursor at the end of every selected line, ready to append to all of them.
• From the Find bar, Alt+Enter (find.selectAllMatches) does the same for every match of the current query and closes the bar, so the query’s case, regex and whole-word toggles decide what gets a cursor.
• Alt-drag to make a column or box selection.
• Type, and the edit fans out to every caret. Esc collapses back to one.

On macOS the VS Code and Sublime keymaps use Cmd where these list Ctrl (Cmd+D, Cmd+K Cmd+D, Cmd+U, Cmd+Shift+L). The Emacs keymap leaves all of these to the palette.

Movement chords fan out too: C-f, C-b, C-n, C-p, C-a, C-e, M-f and M-b move every caret, like the arrow keys. Document, paragraph, sentence and page motions stay on the primary caret. Multiple cursors can be turned off in Settings, and they’re disabled in Simple UI mode.

Auto-indent

Enter does the right thing per language: it keeps the current line’s indent, adds a level after a block opener (braces, a trailing : in Python or YAML, do / then in shell, an open tag in XML or HTML), and splits a matching pair into an indented stanza with the closer dropped below. Typing a closer such as ), ], }, or a keyword like end / fi / done re-aligns the line to its opener.

Smart backspace removes a whole indent level in one press. On a blank, auto-indented line, a single Backspace jumps back to the end of the previous line. The indent unit (tabs or spaces) is inferred from the file, including its width: a 2-space file gets 2-space Tab, Enter, and Shift-Tab whatever the tab size setting says. A tab character is drawn at the configured tab size (the setting or .editorconfig), 4 columns by default.

Shell scripts

In a shell script (which files count as one is on Languages) the indent comes from the script’s structure, not from the shape of one line. Editora reads quotes and $( … ) that span lines, comments, here-documents, and the keyword blocks (if … fi, for / while / until / select … done, case … esac, { … } and ( … )). A keyword counts only where the shell treats it as one, at the start of a command, so echo what to do opens nothing.

• A body indents one level past the line its statement starts on: after then, do, else, case … in, a { or (, and a case pattern such as start|run).
• In a case item, ;; (or ;&, ;;&) stays at the level of the item’s body, the layout shfmt and the Google shell style guide use. The next line goes back to the pattern’s level.
• fi, else, elif, done and esac line up with the line that opened their block. The opener is found by matching, so a wrapped condition or a $( … ) in between does not throw it off. done=false is an assignment, not a closer.
• Inside a here-document nothing is re-indented, because the body is data. When Enter finishes the delimiter line (EOF), its indent is removed, since bash only ends <<EOF at an unindented delimiter (<<-EOF keeps tabs). The next line goes back to the level of the cat <<EOF line.
• Tab in a line’s leading whitespace follows the same rules.

Shell blocks also fold: functions (from the line with their name), { } groups, if … fi, loops, case … esac and each case item, multi-line ( ) and $( ), and here-documents. Sticky scroll pins the same blocks. A double-click takes a hyphenated shell word whole, such as --long-flag, my-func or a-b in a-b.sh.

A script with Windows (CRLF) line endings or a byte-order mark gets a notice above the editor that converts it. See EditorConfig.

Brackets and quotes

Typing (, [, {, ", ', or ` inserts the matching closer and keeps the caret between them. Type the closer when it’s already next to the caret and Editora types over it. Type an opener with a selection and it wraps the selection. Backspace inside an empty pair deletes both halves. Quotes aren’t auto-paired next to a word character, so the apostrophe in don't is left alone. Whenever the caret sits next to a bracket, it and its match are highlighted.

Go: Matching Bracket (nav.matchingBracket, Ctrl+Shift+\ in the VS Code keymap) jumps the caret to the bracket paired with the one beside it, and press it again to jump back. Edit: Select to Bracket selects everything between a pair, both brackets included. Matching is text-based, like the highlight, so a bracket inside a string or comment can pair with the wrong one.

Bracket-pair colorization

Separately from that highlight, every (), [] and {} is tinted by its nesting depth, so you can see how deep you are without counting. The highlight shows where this bracket closes and the colour shows how deep it is, and the two combine on the same character.

Brackets inside strings and comments are skipped, because a stray { in a string would otherwise shift the colour of every bracket below it. Six depth colours cycle, and an unmatched closer is red.

On by default. Turn it off in Settings → Editor or with view.toggleBracketColors.

Expand and shrink selection

Edit: Expand Selection grows the selection outward through syntactic levels: word, then the enclosing brackets or string, the line, the enclosing definition, the paragraph, the whole document. Edit: Shrink Selection retraces the same steps back. Shift+Alt+Right / Left in the VS Code, CUA and Sublime keymaps (Ctrl+Cmd+Shift+Right / Left on macOS); Ctrl+W / Ctrl+Shift+W in the IntelliJ keymap (Option+Up / Down on macOS); palette-discoverable everywhere, and unbound in the Emacs keymap.

Where a language server is running, the ladder comes from the server’s own parse, so it respects strings and comments. Without one it falls back to text-based bracket and string matching, which is the always-available baseline.

Comments

M-; (Emacs comment-dwim) comments or uncomments using the language’s own syntax. A single line toggles a line comment; a multi-line selection toggles a block or region comment. It covers // and /* */, #, <!-- -->, --, and the rest, preserving indentation, and toggles back off when the text is already commented.

Edit: Toggle Comment (edit.toggleComment, also in the Edit menu and as Comment / Uncomment in the editor’s right-click menu) is the same action. Two kinds of line in a script are left alone, and the status bar says why:

• A #! line at the top of a file in a #-comment language (shell, Python, Ruby…) is not a comment, so it is never toggled. A selection that includes it toggles only the lines after it.
• The body and delimiter of a here-document are data. A selection that reaches into one without its cat <<EOF line toggles nothing, because a # there would end up in the script’s output. Selecting the whole statement comments it as one block, and uncommenting restores it.

Small operations

Fill re-wraps a paragraph to the fill column (70 by default), repeating any comment or quote prefix on each wrapped line. Auto Fill mode (view.toggleAutoFill, off by default) does it as you type, breaking the line when it passes the fill column. It is prose-only, so it never wraps code, and each wrapped line keeps the paragraph’s indent. In code languages, Fill Paragraph and Fill Region fill comments only (line comments, and block comments that start a line); they never join code statements.

Move Line Up/Down and Duplicate Line act on every line of a selection, not only the caret’s line.

The line commands work wherever the caret is on the line, and run at every cursor as one undo step. They open a collapsed fold before changing it, renumber an ordered Markdown list they change, and work with multiple cursors turned off too.

• Insert Line Below opens a new line under the current one, indented as Enter at the end of the line would be (a level deeper after {). It doesn’t continue a Markdown or Typst list. Insert Line Above opens one above, with the current line’s indentation.
• Delete Line deletes the line, or every line a selection touches, and the caret keeps its column on the line that moves up. It doesn’t touch the clipboard or the kill ring; Emacs’ Kill Whole Line (C-S-backspace) still kills. Delete Line is also in the Edit menu.
• Select Line selects the whole line with its line break; run it again to add the next line.
• Indent Lines / Outdent Lines shift the line, or every line of a selection, by the file’s own indent unit, and the caret stays with its text.

On macOS, Cmd takes the place of Ctrl in the VS Code, Sublime and CUA keymaps, except Sublime’s Delete Line, which stays Ctrl+Shift+K. The macOS IntelliJ keymap uses Shift+Enter, Option+Cmd+Enter and Cmd+Backspace. CUA leaves Select Line unbound because Cmd+L is Go to Line on macOS. The Emacs keymap leaves the line commands to the palette.

A right-click outside the selection moves the caret to the click and drops extra carets, so Paste, Run/Debug, the language-server items, spelling suggestions, and Add Bookmark act on the place you clicked. A right-click inside a selection leaves it alone.

Subword navigation moves and deletes by camelCase and snake_case parts: stepping through getUserName lands on get, User, Name, and acronyms split correctly (HTMLParser gives HTML and Parser). These have no default key, so bind them from Settings → Keymaps if you want VS Code’s Ctrl+Alt+←/→.

Convert indentation rewrites the whole file’s leading whitespace between tabs and spaces. Alignment inside a line and string contents are left alone, and each direction reverses the other. Tabify / untabify work the other way round, converting whitespace runs anywhere in the selection (or the buffer) using the tab width. Align regexp pads a selection’s lines with spaces so a regular expression lines up in a column, which is how you align a block of = assignments; it only adds spaces, so re-running it is a no-op.

Copy with syntax highlighting puts a colored HTML flavor on the clipboard alongside the plain text, so code pasted into Slack, an email or a document keeps its highlighting. It is on by default for ordinary copies (Settings → Editor, or view.toggleCopyWithHighlighting) and uses a light GitHub-style palette, since pasted code usually lands on a light background. The explicit command ignores both the setting and the size cap. Plain text is always on the clipboard too, so pasting into a plain-text field is unchanged.

Abbreviations

A text-replacement dictionary: define a short abbreviation that expands to longer text. Expand the word before the caret on demand with C-x a e, or turn on Abbrev Mode (view.toggleAbbrevMode) to expand automatically when you type a space or punctuation. Define a new one with C-x a g, and manage the whole dictionary in Settings → Abbreviations (abbrev.manage).

An abbreviation can contain punctuation as well as letters and digits: ;sig, e.g, adl-fn. When more than one abbreviation ends at the caret, the longest one wins, so adl-fn expands as itself even when fn is also defined.

Your typed case is carried onto the expansion, so btw gives by the way, Btw gives By the way, and BTW gives BY THE WAY; a lowercase abbreviation keeps any capitals inside its expansion.

With Abbrev Mode on, an abbreviation typed out in full at the end of a line shows what it will become as muted text after the caret (btw → by the way), the way a snippet trigger does. Tab expands it at once, Esc hides the hint, and typing a space or punctuation expands it as usual. The hint is part of autocomplete, so it doesn’t appear while autocomplete is turned off, and a snippet trigger typed at the same spot keeps Tab for itself.

The Emacs editing model

Beyond the keymap, Editora implements the concepts an Emacs user reaches for. See Emacs heritage for the full tour.

The kill ring holds the last 120 kills, and consecutive kills accumulate into one entry, so C-k C-k C-k then C-y restores all three lines. Kills are still written to the system clipboard, and text copied in another application wins over a stale ring entry. Edit: Yank from Kill Ring… picks an older entry directly. The ring is per window and lives for the session.

The mark ring is per buffer. C-SPC records the spot, C-x C-SPC pops back through older marks and around to where you started, and marks follow their text as you edit above them.

Narrowing restricts the buffer itself and is more than a display filter: search, replace, macros and Select All see only the region. An amber Narrowed badge in the status bar shows the state and widens on click. Saving always writes the whole file. Language-server support is suspended while narrowed, bookmarks, notes and breakpoints stop persisting until you widen, and undo history is dropped at the narrowing boundary (edits made while narrowed undo normally).

Rectangles act on the columns between point and mark, and each command is one undo step. They are character columns, so a tab counts as one, and the rectangle is remembered separately from the kill ring, as in Emacs.

Registers hold a piece of text or a place to come back to, each under a one-key name:

Each command reads the register’s name from the next key you type, with a prompt in the status line; Escape, moving the caret or leaving the editor cancels. Jumping opens the position’s file if it is closed, and a saved position follows edits to its file while that file is open. An unsaved buffer has no position to save. Edit: List Registers shows them all in a picker, and choosing one inserts its text or jumps to its position. Registers last for the session, one set per window. Only the Emacs keymap binds them, but every register command is in the palette.

Query-replace stops on each match and waits: y or Space replaces, n or Backspace skips, ! replaces all the rest, . replaces this one and stops, and q, Enter or Escape quits. Regexp mode expands $1 group references. In the Emacs keymap M-% runs query-replace rather than opening the find bar’s replace mode; the other keymaps are unchanged.

The C-u prefix argument gives the next command a count: C-u 5 C-n moves down five lines, C-u 3 C-k kills three, C-u 40 - inserts forty dashes. A bare C-u is 4 and repeating it multiplies by four, digits after it are that number, and C-g cancels a half-typed argument. C-u C-SPC is special-cased to pop-mark. Only the Emacs keymap binds C-u.

String manipulation

Convert the case style of the selection or the identifier at the caret (camelCase, PascalCase, snake_case, SCREAMING_SNAKE_CASE, kebab-case, dot.case), with a Cycle Case Style that steps a token through the styles on repeated presses (edit.case.cycle) and a Swap Case (edit.case.swap). Whole-line transforms work on the selection or the whole file: sort ascending/descending (numeric-aware, case-insensitive), sort by length, reverse, shuffle, remove duplicate or empty lines, and trim trailing whitespace. Each is a palette command, or reach them all from one filterable picker, Edit: String Manipulation… (C-c x).

Two other sorts sit beside those: Sort Lines (Case-Sensitive) (edit.sortLinesCaseSensitive) uses plain character order, so uppercase comes before lowercase and digits compare one by one, and Sort Lines, Unique (edit.sortLinesUnique) sorts in natural order and keeps one of each line.

Keep Lines Matching… (edit.keepLines) and Remove Lines Matching… (edit.removeLines) ask for a regular expression and keep, or remove, the lines that match it, in the selection’s lines or the whole file, like Emacs’ keep-lines and flush-lines.

Increment Number (edit.incrementNumber, C-c =) and Decrement Number (edit.decrementNumber, C-c -) change the number at each cursor, or the next one on its line; with a selection, the first number in it. They understand negatives (x = -1, while a-1 is a subtraction), keep zero padding (007 becomes 008), keep a hexadecimal number’s case and width (0x0f becomes 0x10), and handle numbers of any size. C-u 10 C-c = steps by ten. The GUI keymaps leave them to the palette.

The encode and decode commands rewrite the selected text, at every selection at once, as one undo step. They need a selection. If a decode cannot read any one of the selections, nothing changes anywhere and the status line says so.

Hex viewer

Opening a binary file (an executable, archive, .class, and so on) shows a read-only offset | hex | ASCII dump instead of garbage text. PDFs and images are the exception: they open in their own page and image viewers. Binaries are detected by content, and large files show their first slice with a truncation note. View: Open as Hex (view.openAsHex) force-opens any file’s bytes as hex, and View: Open as Text switches back.

Read-only and View mode

Toggle a buffer read-only with C-x C-q so it can’t be edited by accident. Typing and edit commands are blocked, while highlighting, folding, search, and copy keep working. A file that isn’t writable on disk opens read-only automatically, and is never replaced silently: Save asks first (once per file), and auto-save reports that it cannot write. A Word-style View Mode banner docks above the editor with an Enable Editing button when the file is writable, and while read-only, Space pages down and Backspace pages up like a pager.

For existing local files, Save writes a staged replacement and only swaps it into place after the complete new content is ready. If Editora cannot create a safe staging file, Save fails without touching the existing bytes. A hard-linked file, or one owned by another user, is written in place instead, so every name of the file gets the new content and its ownership is kept.

A file whose encoding Editora cannot detect (one that isn’t valid UTF-8 and has no byte-order mark or .editorconfig charset rule, such as a Shift_JIS or GBK file) opens through a stand-in encoding, Windows-1252 or ISO-8859-1, that keeps every byte. The status bar shows that encoding in the warning colour, and clicking it lets you reopen the file in its real encoding (buffer.reopenWithEncoding), which Editora then remembers for that file (see File encodings). Until then, the file refuses a save that would re-encode it. If you type a character outside the stand-in charset, the status bar names the character and its line, and the file can be saved again once it is removed.

Whitespace and the column ruler

View options in Settings toggle whitespace markers, the rulers, indent guides, the minimap, and line numbers. These render as lightweight overlays drawn only for the visible lines, so they stay cheap on large files.

Rulers are vertical lines at chosen columns, 80 by default. Settings → Editor takes a list (80, 120; blank for none) and, under Rulers by language, lists that replace it for a language (java: 100; python: 79, 88; a language with nothing after its colon has no rulers). From the palette, Editor: Set Rulers… (editor.setRulers) sets the global list and Editor: Set Rulers for This Language… (editor.setLanguageRulers) sets the current file’s language, where a blank answer goes back to the global rulers. An .editorconfig max_line_length replaces the first ruler, and off hides them all. View: Toggle Rulers (view.toggleColumnRuler) shows or hides them.

Indent guides are faint vertical lines at each indentation level, carried through blank lines and skipped over folded lines, in a colour that follows the theme. Each guide stands on the column where its level’s text starts, measured from the text as it is laid out: it follows the text when the line numbers get wider or are turned off and when the font changes, and it falls on the tab stops of a tab-indented file and on the spaces of a proportional font. When you scroll sideways, a guide whose column has passed under the line numbers is hidden. They are on by default; turn them off in Settings → Editor or with View: Toggle Indent Guides (view.toggleIndentGuides). They are hidden in Zen mode, Simple UI and large-file mode.

Word wrap

Word wrap is set per kind of file. Markdown and plain text wrap long lines to the editor width by default, because their lines are paragraphs; code does not, and scrolls sideways instead. Each has its own row under Settings → Editor → Display:

View: Toggle Word Wrap (view.toggleWordWrap, no default key) flips the row that governs the file in front, and the status bar says which one it changed.

A buffer that receives a line of 10,000 characters or more, or a run of 2,000 characters with no space in it (a minified file, a pasted data: URI), stays unwrapped, because wrapping such text is very slow. View: Toggle Word Wrap wraps that buffer anyway.