User Guide

Everything you need to know to get the most out of railreader2.

Getting Started

Download and install

The AI layout model is bundled in all packages.

Opening a PDF

Use File → Open or press Ctrl+O to open a PDF. You can also pass a file path as a command-line argument. When no file is open, a welcome screen shows with instructions.

First steps

Once a PDF is open, you can scroll through pages with PgDn/PgUp, zoom with +/- or the mouse wheel, and pan by dragging. When you zoom past 3x, rail mode activates automatically — this is where the AI-guided reading begins.

Rail Mode

Rail mode is the core feature of railreader2. When you zoom past the threshold (default 3x), the AI layout analysis detects text blocks and reading order, and navigation locks to those blocks. Non-active regions are dimmed so you can focus on the current block and line.

railreader2 rail mode navigating a text block line by line at high magnification with the current line highlighted
Rail mode — line-by-line reading at high magnification with the current line highlighted

Line-by-line navigation

When you reach the last line of a block, pressing Down advances to the next navigable block. At the last block on a page, it advances to the next page. You can also hold Down/S at the last line of a page to advance to the next page automatically, without needing to release and re-press the key.

Click to jump

Click on any detected block in rail mode to jump directly to it. The view snaps to the clicked block's first line.

Horizontal scrolling

Holding Right/D scrolls horizontally along the current line with speed ramping — it starts slow and accelerates. Ctrl + mouse wheel also scrolls horizontally. The speed ramp time and max speed are configurable in Settings.

Free pan (Ctrl+Drag)

Hold Ctrl in rail mode to temporarily break out of rail constraints. While Ctrl is held, you can pan and zoom freely as if rail mode were inactive, and the page is drawn clean — the rail dim and line overlay are suppressed so nothing obscures the figure you're inspecting. When you release Ctrl, the view snaps back to the exact rail position you left. This is useful for quickly checking a figure, footnote, or other element outside the current reading flow without losing your place.

Zoom position preservation

Zooming in and out preserves your reading position within the current line. The camera adjusts so the text you were reading stays in view rather than jumping to the block origin.

Tip: Press Shift+D to toggle the debug overlay, which shows all detected layout blocks with their class labels, confidence scores, and reading order. Useful for understanding why rail navigation behaves a certain way.

View Rotation

Quarter-turn the whole displayed page — useful for sideways scans or a wide table laid out in landscape. Rotate with Ctrl+R (clockwise) / Ctrl+Shift+R (counter-clockwise), from the View → Rotate menu, or from a block's right-click context menu. Rotation is per-document (shared by every tab or pane viewing the same file) and persists across sessions.

In rail mode, if the current line lands on a block that's sideways relative to the page's rotation, a one-time toast points you at U (“Rotate to Read Block”) — pressing it rotates the whole page just enough to make that block upright and re-runs layout analysis on it, so you get real per-line detection instead of guessed geometry. Press U again once it's upright to reset rotation back to 0. A status bar badge shows the current rotation (e.g. “Rotated 90°”) with a one-click reset button.

Annotations can't be authored while rotated — the toolbar's Annotate button is greyed out and existing annotations aren't shown, because their stored geometry is always in the page's unrotated frame. Rotate back to 0° to see and edit them again.

Auto-Scroll

Press P in rail mode to toggle semi-automatic auto-scroll. The view flows through prose line by line on its own — but rather than running unattended through the whole document, it parks (stops and waits for you) whenever it reaches something worth pausing on, then continues at your signal. The easy, mechanical part stays automatic; the “am I done with this?” decision stays yours.

The status bar shows an "Auto-Scroll" indicator while flowing and "Parked — press D to continue" while stopped. Adjust speed with the rail toolbar slider, [ / ] keys (±5), or Ctrl+[ / Ctrl+] for fine adjustments (±1); holding D/Right during flow temporarily boosts speed. Scroll speed is zoom-independent — reading pace stays consistent at any magnification.

Auto-scroll trigger: Auto-scroll can also start automatically after sustained horizontal scrolling. If you hold Right/D continuously for long enough, auto-scroll engages and continues on its own when you release the key.

Jump Mode

Press J in rail mode to toggle jump mode. Instead of continuous scrolling, Right/D and Left/A perform saccade-style jumps — advancing by a configurable percentage of the visible width (default 25%).

Hold Shift with Right or Left to perform a short jump at half the normal distance. This is useful for fine-grained positioning within a line.

This mimics natural reading eye movements and is useful for scanning text quickly. Adjust jump distance with [ / ] or in Settings → Rail Reading.

Tip: Auto-scroll and jump mode are mutually exclusive. Enabling one disables the other.

Line Focus & Highlight

Line focus dim

When enabled, line focus dim applies a smooth feathered dimming overlay to the entire page except the active line in rail mode. Non-active lines fade toward the background colour, reducing peripheral distraction while maintaining a clean visual transition.

railreader2 line focus dim effect fading non-active lines to reduce distraction during rail reading
Line focus dim — non-active lines are dimmed to reduce distraction

Toggle with the F key, the F button on the rail toolbar, or in Settings → Rail Reading. Dim intensity is adjustable from 0 (off) to 1 (maximum). The padding around the active line (how much extra space stays fully visible) is also configurable.

Line highlight tint

The active line in rail mode can have a configurable colour tint applied as an overlay. This makes the current line stand out more clearly, especially at high magnification. Press H to toggle the line highlight independently of line focus dim.

Choose from five presets in Settings → Rail Reading:

Opacity is adjustable from 0.0 (invisible) to 1.0 (fully opaque). The default is Auto at 25% opacity.

Freeze Panes

Pin part of a page in place — like Excel's Freeze Panes — so a header row, a label column, or both stay visible while the rest of the page scrolls under them. It is page-wide and works on any page, not just detected tables, and does not depend on table detection at all.

Open the Freeze button (the snowflake) on the toolbar — always available whenever a page is loaded — and pick a mode:

The pointer shows a guide line while a placement is armed, and the click drops the split exactly where you point — there is no snapping to detected boundaries (which are sometimes wrong). The two axes compose: freeze rows first, then add a column freeze to build up to “both”. Zoom is locked while frozen so the panes and body can't drift apart, and the frozen strips re-render crisply as you read.

Each split pane and tear-off window freezes independently, and a freeze belongs to the page it was set on — it clears automatically when that view moves to another page. To release it, click Unfreeze in the Freeze flyout, use the ❄ Frozen — Unfreeze chip that appears in the frozen pane's corner, or press Z again. Press Escape to cancel a placement you've armed but not yet dropped.

Colour Effects

Four GPU-accelerated colour filters are available, applied only to PDF content (not the UI). Access via View → Colour Effect, Settings → Appearance, or press C to cycle through effects on the active tab.

railreader2 amber colour filter applied to PDF content via GPU-accelerated shader
Amber filter — warm tint for comfortable reading
railreader2 high contrast colour effect combined with rail mode for maximum readability
High contrast + rail mode — maximum readability

Each tab keeps its own colour effect independently — you can have one PDF in Amber and another in High Contrast. The per-tab effect is saved with the reading position and restored when you reopen the file.

Each effect has adjustable intensity (0.0 to 1.0). Rail mode overlay colours automatically adapt to the active colour effect for readable contrast.

Tip: Press C to quickly cycle through colour effects. The status bar briefly shows the active effect name.

Annotations

Toggle Annotation Mode from the toolbar's Annotate button (or Ctrl+E, the Edit menu, or a block's right-click context menu) to reveal the annotation tool row.

railreader2 annotation tools showing highlights, freehand pen marks, rectangles, and text notes on a PDF page
Annotations — highlights and text notes on a PDF page

Number keys 1–5 jump straight to Highlight, Pen, Rectangle, Text Note, and Eraser respectively; Underline, Strikethrough, Squiggly, and Text Box have no numeric shortcut — pick them from the toolbar.

Tool cursors

Each annotation tool shows a distinct mouse cursor so you always know the active mode:

Annotation toolbar: colour & thickness

In annotation mode, the toolbar's Colour button opens a flyout with one shared five-colour palette — Yellow, Green, Red, Blue, and Black — used by every colour-capable tool (Highlight, Underline, Squiggly, Strikethrough, Pen, Rectangle, Text Note, and Text Box). Each tool remembers its own last-picked colour independently, so switching tools doesn't change another tool's colour.

The Thickness button opens a flyout with three stroke presets — thin, normal, thick — but only applies to Pen and Rectangle; it's disabled for every other tool.

Annotation z-order

Annotations are drawn in a fixed z-order: highlights appear below freehand strokes and rectangles, which appear below text notes and text boxes. Within each tier, annotations are drawn in the order they were created.

Popup notes

Text notes display as a compact folded-corner icon (16px). In browse mode, click the icon to expand a floating popup showing the full note text with word wrapping. Click again to collapse.

Select, move, and resize

In browse mode (no annotation tool active), click on any annotation to select it (shown with a dashed blue outline). Drag a selected annotation to move it. For freehand annotations, 8 resize handles appear on the bounding box — drag a handle to scale proportionally. All move and resize actions support undo/redo.

Delete selected annotation

Press Delete or Backspace in browse mode to remove the selected annotation. This uses the same undo-supported removal as the eraser.

Undo and redo

Ctrl+Z undoes the last annotation action (including moves, resizes, and deletions). Ctrl+Y or Ctrl+Shift+Z redoes. Each tab has an independent undo/redo stack.

Persistence

Annotations are saved automatically to internal storage. They load automatically when you reopen the file. When the same PDF is open in multiple tabs, all tabs share the same annotation data — edits in one tab are immediately visible in the other, with independent undo/redo stacks per tab.

Export

Use File → Export with Annotations to create a new PDF with annotations rendered into the pages. The original PDF is not modified.

Use File → Export Annotations as JSON to save all annotations for the current document as a standalone JSON file. This is useful for sharing with other RailReader2 users, backup, or programmatic access to annotation data.

Use File → Import Annotations… to import annotations from a JSON file. Imported annotations are merged with any existing annotations on the active document — your annotations are preserved, and the imported ones are added alongside them. Duplicate bookmarks (same name and page) are skipped.

Text Selection

The floating toolbar in the top-left corner provides three modes:

The active mode is shown with a blue highlight on the toolbar button. Press Escape to cancel selection and return to browse mode.

Bookmarks

Press B to bookmark the current page, or click + Add Bookmark in the bookmarks panel. A dialog lets you name the bookmark (pre-filled with "Page N").

Managing bookmarks

Press Ctrl+Shift+B to open the Bookmarks section of the side panel. Each bookmark shows its name and page number.

Duplicate handling

If you bookmark a page that already has a bookmark, the existing bookmark's name is updated instead of creating a duplicate.

Persistence

Bookmarks are stored in the same annotation file as highlights, notes, and other annotations. They persist across sessions automatically.

Index Pane

Press Ctrl+Shift+I to open the Index pane — a browsable index of all figures, tables, and equations detected by the layout analysis model. It is one of the side-panel accordion sections (alongside Outline, Bookmarks, Search, and Comments).

Background scanning

RailReader2 progressively analyses all pages in the background when idle. As pages are scanned, detected figures, tables, and equations appear in the pane. A progress indicator shows how many pages have been scanned (e.g., “12 of 20 pages scanned”). Background scanning pauses automatically during rail mode to avoid interfering with reading.

Scan All

Background analysis only reaches pages near where you have been reading. To index the entire document at once, click Scan All at the top of the pane — it sweeps every page for figures, tables, and equations and reports progress as it goes. The result is kept with the document, so switching tabs and back does not lose it.

Browsing entries

Each entry shows a thumbnail crop for figures and tables, or extracted text content for equations (Unicode math symbols from the PDF text layer). Use the Figures, Tables, and Equations toggle buttons at the top to filter by category. Click any entry to navigate to that page, or right-click it to open it in the portal pop-out window — a quick way to park a figure on a second monitor while you keep reading; Lock it there to keep it pinned.

Comments

The side panel's Comments section gathers every text note and reviewer comment in the document into one scrollable list, so you can read or jump between them without scrolling the pages.

Portals

A portal links a reference in the text — a “see Figure 3”, a “cf. Table 2”, an “(Eq. 7)” — to the figure, table, or equation it points to. Once linked, the target stays in view while you rail-read past the reference, so you never have to scroll away from the paragraph to see what it cites.

The linked target appears in the side panel's Portals section, and — optionally — in a detachable, always-on-top pop-out window you can drag to a second monitor. That pop-out is a live viewport, not a still image — rail reading, freeze panes, and annotation all work inside it, and it re-aims itself as you read on.

Creating a portal

Right-click a detected block on the page and choose Create Portal — Keep This Block In View While Reading. Or use the two-step Set as Portal Target → Link Target to Current Paragraph when it is easier to mark the figure first and find the reference afterwards.

Sources are line-precise: the link fires at the exact line you were on, so several references in one paragraph (line 2 → Figure 3, line 8 → Figure 4) each surface their own target in turn. The shown target stays pinned until you reach a different portal's source, so it never flickers as you scroll.

On-page markers

Subtle, always-on markers show where portals are anchored on the current page: a small gutter dot beside each source line and a corner badge on each target block. The currently-shown portal is drawn accented. Click a marker to act on it — a source jumps to (shows) its target, a target jumps back to its source; a marker that stands for several portals opens a chooser.

Pop-out window

Click Pop out ↗ in the Portals pane (or click the docked preview) to detach the target into a floating, borderless, always-on-top window — useful on a multi-monitor setup. The window hosts a live viewport of the target, so you can rail-read, freeze panes, and annotate inside it just like the main view; it follows the reading position, re-aiming as you cross new references. Drag its top bar to move it, the corner grip to resize; scroll to zoom and drag to pan inside it, double-click to fit. The Pin toggle controls always-on-top, Lock freezes the current target so reading on (or an auto-pin) won't replace it until you unlock, and Dock returns it to the panel. Its size and position are remembered.

Temporary peek

To glance at a block without saving a link, right-click it and choose Open in Portal (Temporary) — or right-click any entry in the Index pane. It opens in the pop-out window only, leaves any saved portal's tracking untouched, and dismisses itself once you read on (unless you Lock it).

Managing portals

The Portals pane lists every portal in the document. Rename a portal inline, click Go to source to jump to and frame its reference, or Delete to remove it. Portals are saved per-document in a sidecar keyed by the PDF's path, so they persist across sessions.

Acknowledgement: the portal concept — and the name — is borrowed from Sioyek, a PDF reader for research papers whose Portals feature inspired this one.

Copy as LaTeX (VLM)

Press Ctrl+L to send the current rail block to a Vision Language Model and copy the result to the clipboard. You can also Ctrl+right-click any detected block to open a context menu with Copy as LaTeX, Copy as Markdown, Copy Description, and Copy Image options — the same four are on the Edit menu (Copy Block as LaTeX / Markdown / Description / Image), acting on the current rail block. The Ctrl+L shortcut auto-selects the action by block type: equations → LaTeX, tables → Markdown, figures → description.

Setup

Open Settings > VLM and configure an OpenAI-compatible API endpoint. Use Test Connection to verify your setup.

Structured JSON output

Under Settings > VLM there's a Use structured JSON schema responses checkbox (off by default). Enabling it forces capable models (GPT-4o, Qwen2.5-VL, Gemini) to return a JSON object matching a strict schema, producing cleaner output — no stray $$ wrappers, code fences, or prompt echoes. Some local or OCR-specialised models don't reliably support JSON schema and may return truncated output; disable the checkbox in that case.

Recommended models

See the VLM setup guide for detailed instructions on all three options.

CLI Tool

RailReader2 ships a standalone headless CLI for automated PDF extraction. Download railreader2-cli-linux-x64.tar.gz (Linux) or railreader2-cli-win-x64.zip (Windows) from GitHub Releases, then extract the archive. On Linux, make the binary executable with chmod +x RailReader2.Cli.

ONNX model

The CLI uses the Docling Heron-INT8 ONNX layout model by default, with PP-DocLayoutV3 available as an alternative. If the GUI is installed, the CLI finds the models automatically from the shared cache. If the GUI isn't installed, download the models by running ./scripts/download-model.sh from source. The structure command works without the model but skips layout analysis.

render — export pages as PNG

Renders PDF pages as PNG images, with optional colour effects and annotation overlay. 

railreader2-cli render <pdf> [options]
OptionDescription
--pages <range>Page range, e.g. "1,3,5-10" (default: all)
--dpi <int>Render DPI (default: 300)
--effect <name>Colour effect: none, highcontrast, highvisibility, amber, invert
--intensity <float>Effect intensity 0.0–1.0 (default: 1.0)
--annotationsBurn annotations into rendered pages
--output-dir <path>Output directory (default: ./screenshots)
 
# Render first 5 pages with amber filter
railreader2-cli render paper.pdf --pages 1-5 --effect amber --output-dir ./out

# Render all pages with annotations baked in
railreader2-cli render paper.pdf --annotations --dpi 150

structure — extract document structure

Extracts the PDF outline (table of contents), ONNX layout blocks, and per-block text as JSON. 

railreader2-cli structure <pdf> [options]
OptionDescription
--output <path>Output JSON file path (default: stdout)
--include-textInclude extracted text per layout block
--analyzeRun ONNX layout analysis to detect blocks
--pages <range>Page range for analysis (default: all)
 
# Full structure with layout analysis and text
railreader2-cli structure paper.pdf --analyze --include-text --output structure.json

# Just the outline (no model needed)
railreader2-cli structure paper.pdf

annotations — export annotations

Exports annotations as rich JSON (with extracted text, layout block correlations, and nearest section headings) or as an annotated PDF. 

railreader2-cli annotations <pdf> [options]
OptionDescription
--output <path>Output file path (default: stdout for JSON)
--format <json|pdf>Export format (default: json)
--include-textExtract text under each annotation
--include-blocksCorrelate annotations with layout blocks (implies ONNX analysis)
 
# Rich JSON export with text and layout context
railreader2-cli annotations paper.pdf --include-text --include-blocks --output annotations.json

# Export as annotated PDF
railreader2-cli annotations paper.pdf --format pdf --output paper.annotated.pdf

vlm — transcribe blocks via a vision LLM

Sends detected equation, table, and figure crops to an OpenAI-compatible vision API and writes the transcriptions as JSON. Equations become LaTeX, tables become Markdown, figures become one-sentence descriptions. Uses the same endpoints as the GUI's Copy as LaTeX feature (OpenAI, Ollama, vLLM, LMStudio, etc.). 

railreader2-cli vlm <pdf> [options]
OptionDescription
--classes <list>Comma-separated subset: equation, table, figure
--allShortcut for all three classes
--pages <range>Page range (default: all)
--page <n> --block <i>Transcribe a single block by page + block index
--from-structure <path>Reuse an existing structure --analyze JSON instead of re-running ONNX
--endpoint <url> / --model / --api-keyOverride AppConfig VLM settings (API key also read from $OPENAI_API_KEY)
--equation-* / --table-* / --figure-*Per-class endpoint/model/api-key overrides for mixed routing
--prompt-style <style>instruction (default) or ocr
--concurrency <n>Parallel VLM requests (default: 1)
--dump-crops <dir>Write the PNG crops to disk (useful for debugging)
--no-structured-outputDisable JSON schema response format (default: on)
--no-html-to-mdKeep HTML tables as-is (default: convert to Markdown)
--output <path>Output JSON file path (default: stdout)
 
# Transcribe every equation and table in a paper to LaTeX/Markdown
railreader2-cli vlm paper.pdf --classes equation,table \
    --endpoint https://api.openai.com/v1 --model gpt-5.4-nano-2026-03-17 \
    --output transcriptions.json

# Mixed routing: local Ollama for equations, OpenAI for figures
railreader2-cli vlm paper.pdf --classes equation,figure \
    --equation-endpoint http://localhost:11434/v1 --equation-model qwen2.5-vl:7b \
    --figure-endpoint https://api.openai.com/v1 --figure-model gpt-5.4-nano-2026-03-17 \
    --output rich.json

# Reuse a pre-computed structure JSON (skip ONNX)
railreader2-cli structure paper.pdf --analyze --output structure.json
railreader2-cli vlm paper.pdf --from-structure structure.json --all --output vlm.json

export — convert PDF to Markdown

Exports a PDF to structured Markdown using layout analysis, VLM transcription, and annotation extraction. Heading hierarchy is resolved by matching detected heading blocks against the PDF outline tree. Degrades gracefully depending on available tools. 

railreader2-cli export <pdf> [options]
OptionDescription
--output <path>Markdown output file (default: stdout)
--pages <range>Page range (e.g. 1,3,5-10)
--no-page-breaksOmit page break markers (---) between pages
--no-vlmDisable VLM transcription (placeholders instead)
--no-annotationsExclude annotations from output
--figure-dir <dir>Save figure PNGs and reference them in the Markdown
--endpoint / --model / --api-keyVLM overrides (same as vlm command)
--concurrency <n>Parallel VLM requests (default: 2)
--prompt-style <style>instruction (default) or ocr
--no-structured-outputDisable JSON schema response format
 
# Basic export (text + headings, equations/figures as placeholders)
railreader2-cli export paper.pdf --no-vlm --output paper.md

# Full fidelity with VLM (LaTeX equations, Markdown tables, figure descriptions)
railreader2-cli export paper.pdf \
    --endpoint https://api.openai.com/v1 --model gpt-5.4-nano-2026-03-17 \
    --output paper.md

# Export with figure images saved to disk
railreader2-cli export paper.pdf --figure-dir ./figures --output paper.md

Graceful degradation: With ONNX + VLM, you get full fidelity (headings, LaTeX, pipe tables, figure images). With ONNX only (no VLM), equations and figures become placeholders and tables render as code blocks. Without either, the output is plain text per page with heading markers from the PDF outline.

Settings

Press Ctrl+, or use the menu to open Settings. Changes take effect immediately and are saved automatically to the config file.

Appearance

Rendering

Rail Reading

Auto-Scroll

Advanced

OCR

A scanned page is a picture of text. It carries no text layer, so everything built on one stops working: line-by-line rail reading, search, text selection, table cells, Markdown export, and VLM grounding. OCR reads the text back off the image so those features behave as they would on a born-digital page. It is off by default and costs nothing until you turn it on.

PackDownloadRecognition speed
Tiny~6 MBFastest
Small~31 MBModerate
Medium~138 MBSlowest — a minute or more per scanned page is normal

Tiny or Small are the right default for reading. Full recognition is CPU-heavy and runs on its own worker thread, separate from layout analysis, so a scanned page's recognition no longer blocks layout analysis of other open documents. It still queues behind any other scanned page already being recognised, though, since OCR itself runs on a single thread. On the Medium pack a page can still take a minute or more — it isn't frozen, and the session log records each page as it completes.

Config file

Configuration is stored at ~/.config/railreader2/config.json (Linux) or %APPDATA%\railreader2\config.json (Windows). You can edit it directly; restart the app to apply changes.

Troubleshooting

RailReader2 writes a diagnostic log during each session. If you encounter a problem, the log helps developers understand what happened.

The app seems to freeze on a scanned page

Almost always OCR working, not a crash. Full recognition runs on its own worker thread (separate from layout analysis, so it no longer blocks other open documents), but a second scanned page still queues behind one already being recognised — and with the Medium language pack a single page can take a minute or more. Switch to the Tiny or Small pack (Settings → OCR), or set OCR mode to Lines, which restores rail reading on scans without the recognition cost.

“OCR model failed to load”

The selected language pack isn't installed. Open Settings → OCR, press Download language pack, and restart. Recent versions fall back to the bundled recogniser instead of disabling OCR, so this message means only that your chosen pack is unavailable — not that OCR is broken.

A scan reads as one giant rail line

Line grouping is being defeated by page tilt. Check that Skew correction is enabled (Settings → OCR) and that OCR mode is Lines or Full — skew is measured from the OCR results, so it can do nothing with OCR off. If it is already on, the page may exceed the ±5° correction limit, or carry two differently-tilted columns, which the correction deliberately declines to guess at.

Exporting the log

Log file location

The log is overwritten at the start of each session. Old .log files are automatically removed after 7 days by the cleanup service.

Controls & Icons

The toolbar and the panel controls use a set of crisp Lucide vector icons that inherit the theme text colour and scale with the UI font size. Here is what each one does.

IconNameAction
Toolbar
Browse / PanPan the page and click to navigate — the default mode
Text SelectSelect text on the page to copy
CopyCopy the selected text (Ctrl+C)
AnnotateEnter annotation mode (Ctrl+E)
Annotation tools (toolbar, shown in Annotation Mode)
HighlightDrag over text to highlight
UnderlineDrag over text to underline
StrikethroughDrag over text to strike through
SquigglyDrag over text for a squiggly underline
PenFreehand drawing
RectangleDraw a rectangle outline
Text noteDrop a collapsible popup note
Text boxDrag a box, then type into it (typewriter-style)
EraserErase annotations under the cursor
ColourShared 5-colour palette (yellow/green/red/blue/black) for every colour-capable tool
ThicknessStroke thickness for the pen and rectangle only (thin / normal / thick)
Panel & navigation
SidebarShow or hide the side panel (left of the tab strip)
Add bookmarkBookmark the current page (Bookmarks section)
BackReturn to your previous location after a jump
PausePause auto-scroll (rail toolbar)
Clear / CloseClear the search, or close a popup note
OverflowList all open tabs when the tab bar is full

Keyboard Shortcuts

Key Action
General
Ctrl+OOpen file
Ctrl+WClose tab
Ctrl+TabNext tab
Ctrl+QQuit
Ctrl+,Settings
Ctrl+MToggle minimap
Ctrl+Shift+MToggle margin cropping
Ctrl+Shift+OOpen Outline section
Ctrl+Shift+BOpen Bookmarks section
Ctrl+Shift+IOpen Index section (figures / tables / equations)
Ctrl+Shift+H / G / T / EJump to next heading / figure / table / equation
Ctrl+LCopy block as LaTeX (VLM)
Ctrl+GGo to page
Ctrl+\Split editor (add a pane to the right)
Ctrl+Shift+\Close the focused pane
Ctrl+R / Ctrl+Shift+RRotate view clockwise / counter-clockwise
F1Keyboard shortcuts dialog
F11Toggle fullscreen
Navigation
PgDn / PgUpNext / previous page
Home / EndFirst / last page
SpaceNext line (rail) or next page
+ / -Zoom in / out
0Fit page to window
Shift+DToggle debug overlay
URotate to read the current sideways rail block (press again to reset)
Rail Mode
Down / SNext line
Up / WPrevious line
Right / DScroll forward (hold)
Left / AScroll backward (hold)
Shift+Right / Shift+LeftShort jump — half distance (jump mode)
Home / EndLine start / end
PToggle auto-scroll (semi-automatic; D/S to continue when parked)
JToggle jump mode
BAdd bookmark for current page
Alt+Left / ` (backtick)Navigate back
Alt+RightNavigate forward
CCycle colour effect on active tab
FToggle line focus dim
HToggle line highlight
[ / ]Adjust speed or jump distance (±5)
Ctrl+[ / Ctrl+]Fine adjust speed or jump distance (±1)
Shift+[ / Shift+]Adjust blur intensity (±0.05)
Ctrl+Shift+[ / ]Fine adjust blur intensity (±0.01)
Ctrl+DragFree pan/zoom in rail mode (release to snap back)
ClickJump to block
Search & Annotations
Ctrl+FOpen search panel
F3 / Shift+F3Next / previous match
Ctrl+EToggle annotation mode
1 / 2 / 3 / 4 / 5Highlight / Pen / Rectangle / Text Note / Eraser
Right-clickBlock actions (Copy as LaTeX / Markdown / Description / Image) + toggle Annotation Mode
Ctrl+ZUndo
Ctrl+YRedo
Delete / BackspaceDelete selected annotation (browse mode)
Ctrl+CCopy selected text
EscapeCancel tool / close search / stop auto-scroll / exit fullscreen