# Keyboard shortcuts & glossary

On a Mac the tables show Command and Option shortcuts. On Linux and Windows the app shows the same shortcuts with Ctrl and Alt. Some native desktop commands are unavailable in a browser window.

## Workspace shortcuts

| Shortcut | Action |
| --- | --- |
| `⌘K` | Search tools, views, actions and files in the command palette. |
| `⌘P` | Find a file. |
| `⌘Enter` | Compile the selected document root. |
| `⌘S` | Save immediately; source also autosaves. |
| `⌘F` | Search the active source editor. |
| `⌘ShiftF` | Search the project. |
| `⌘ShiftM` | Comment on the source selection. |
| `⌘ShiftR` | Review tracked changes (the Changes tab). |
| `⌘ShiftA` | Open or close the agent's column. |
| `⌘ShiftE` | Track changes on or off for your edits. |
| `⌘Option]` / `⌘Option[` | In the LaTeX editor: next / previous tracked change, with its card. |
| `⌘ShiftH` | Open versions/history. |
| `⌘ShiftT` | Deadlines, tasks and reviews. |
| `⌘ShiftI` | Snippets and wrappers. |
| `ControlSpace` | Expand a template shortcut in the editor. |
| `⌘J` | Build log/problems. |
| `⌘ShiftJ` | Show the cursor position in the PDF (Show in PDF). |
| `⌘B` | Toggle file-tree visibility. |
| `⌘Option O` | Open the view you are working in in its own window; in a view's own window, return it to the main window. |
| `⌘W` | Close the active tab where the editor handles it. |
| `⌘,` | Settings. |
| Double-click PDF text | Jump to source when SyncTeX is available. |
| Double-click source | Show the corresponding PDF location when the PDF is on screen. |
| Enter / `⌘Enter`, `←` `→`, Esc | In a reference review: confirm, move to the previous or next record, close the review. |

Use ordinary Undo/Redo for source edits. Conversation Undo/Redo changes the active conversation boundary and does not undo manuscript files.

## In the Response view

While you write an answer to a reviewer, the formatting bar's shortcuts belong to the answer (so **⌘B** makes text bold there instead of toggling the sidebar).

| Shortcut | Action |
| --- | --- |
| `⌘B` / `⌘I` | Bold / italic. |
| `⌘E` | Inline code. |
| `⌘ShiftK` | Link (`⌘K` stays the command palette). |
| `⌘Shift8` / `⌘Shift7` | Bulleted / numbered list. |
| `⌘Shift.` | Quote. |
| `Control-M` | Inline equation, `$…$` (Ctrl+M on Linux and Windows; ⌘M stays the Mac's Minimize). |
| `Control-Shift-M` | Display equation, `$$…$$` on lines of their own. |
| Enter | In a list item or quote, start the next one; in an empty item, end the list. |

## Documentation and accessibility

Desktop **Help → VersoFold Documentation** also uses F1. In the handbook, **⌘K** focuses search, Tab moves among controls, Enter activates the focused item, and Escape closes the handbook. Closing returns you to the underlying workspace.

The handbook provides category colors as an additional cue; headings and labels also identify every category. A contents rail appears in wide windows, while narrow layouts retain chapter navigation and search. Code examples have Copy controls, and tables scroll when necessary.

Focus a pane divider and use arrows to resize where supported. Split's divider also offers Home to reset its proportions. Reduced-motion preferences affect decorative effects and supported exported web-edition motion.

## Document and writing terms

| Term | Meaning |
| --- | --- |
| Workspace | A saved project pointing to a folder and its associated app records. |
| Source | The editable `.tex`, `.bib` and supporting files used to build a paper. |
| Root / entry | The complete LaTeX document selected for compilation. |
| Preamble | Commands before `\begin{document}`, including packages and definitions. |
| Package | A LaTeX extension loaded with `\usepackage`. |
| Environment | Content enclosed by matching `\begin` and `\end`. |
| Float | A figure/table whose placement is chosen by LaTeX within requested constraints. |
| Label | A unique key used to refer to a numbered object. |
| Citation key | An identifier connecting a citation command to a bibliography record. |
| SyncTeX | Build metadata mapping PDF locations to LaTeX source. |
| Build artifact | Output/intermediate files produced by compilation or generation. |

## Review and data terms

| Term | Meaning |
| --- | --- |
| Snapshot / checkpoint | A preserved source state used for comparison or recovery. |
| Named version | An intentional manuscript milestone, optionally with a matching PDF. |
| Baseline | The source state against which changes are compared. |
| Tracked change | An insertion or deletion recorded with its author, pending until someone accepts or rejects it; the file already holds it (insertions in, deletions out). |
| Live edit | A change already applied to working source. |
| Staged proposal | A proposed source state awaiting author acceptance. |
| Stale | A result/preview no longer known to match current inputs. |
| Fingerprint | A content identity used to detect changed source/data. |
| Provenance | Recorded origins, transformations and evidence behind an output. |
| Recipe | A declarative Figure Studio design and data-processing specification. |
| Publish table/figure | Generate manuscript assets from a saved draft/recipe. |
| Freeze | Pin a source, asset or version to preserve a chosen state. |
| Evidence assessment | A recorded interpretation of inspected sources, separate from metadata checking. |

## Agent and sharing terms

| Term | Meaning |
| --- | --- |
| Context | Material supplied to a conversation or read by its tools. |
| Discuss | A conversation mode primarily for reading and analysis. |
| Edit | A mode enabling authorized guarded changes. |
| Grant | Explicit access to a scope/capability; separate from per-action approval. |
| MCP | A protocol through which an external agent discovers and invokes app tools. |
| Compaction | A continuation summary for long context while local history is retained. |
| Review invitation | Access to a shared workspace under a role and grants. |
| Offline review file | A self-contained exported reader for feedback returned later. |

## Phases, rebuttals and editions

| Term | Meaning |
| --- | --- |
| Phase | Where the paper is in its life (Drafting to Published); it arranges the side panel and the tools in view, and locks nothing. |
| Submitted version | The version saved by **Mark as submitted**; changes since submission are measured against it. |
| Response view | The rebuttal as the reviewers' comments with your answers under them: the file `rebuttal/response.md`. |
| Follow-up | A reviewer's later comment in the discussion, answered under the point it replies to. |
| Marked PDF | A latexdiff build of the paper with every change since submission coloured. |
| Edition | One form of the paper built from the same source: the paper, the preprint, the supplementary material, or a copy. |
| Edition mark | `\ifpreprint … \fi` and its kin: text only some editions print. |
| Edition view | The LaTeX and PDF as one edition prints them; what it leaves out folds away. |

Related: [navigation](navigation.md), [agent](agent.md), [troubleshooting](troubleshooting.md).