Help
Everything Verso does, and how to reach it. If something here doesn’t match what you’re seeing, email hello@versowriter.app and tell me — either the app or this page is wrong, and I’d like to know which.
Supported formats
Verso is a regular macOS document app. It opens the file you give it and saves back to the same kind of file wherever that is possible.
Open and edit
DOCX, DOC, DOTX (Word templates), ODT, RTF, and plain text (.txt). Word templates open as regular documents you can edit and save as DOCX.
View as rich text
Markdown (.md) files fully round-trip: open, edit, and save back to .md with headings, lists, code blocks, tables, and inline formatting preserved. Mermaid code blocks in Markdown files render as live diagrams (flowcharts, sequence diagrams, Gantt charts, and more). HTML files open as formatted rich text but save as DOCX or another format, not back to HTML.
Syntax highlighting
Source code files open with coloured keywords, strings, and comments. Supported: Swift, Python, JavaScript, TypeScript, Java, C, C++, C#, Go, Rust, Ruby, PHP, Shell, SQL, YAML, JSON, XML, HTML, CSS, R, Kotlin, and Markdown.
Smart paste
Tables pasted from web browsers, ChatGPT, and Gemini land as proper grids. Code blocks get automatic syntax highlighting. LaTeX math notation (inline $...$ and display $$...$$) renders as typeset equations.
Export
Any document can be exported to PDF, HTML, or Markdown from the File menu.
What to expect when saving
Verso preserves as much as it can when you save, but some formats carry less than others. Verso will always warn you before you lose anything.
DOCX
Keeps everything: formatting, images, tables, headers, footers, footnotes, comments, and tracked changes all survive the round trip.
ODT
Keeps most formatting, images, and tables. Headers, footers, and footnotes are preserved. Comments may not round-trip perfectly with all editors.
RTF
Keeps text formatting and footnotes, but may lose embedded images, headers, footers, and comments.
Markdown
Preserves headings, lists, code blocks, tables, bold, italic, strikethrough, and links. Images and complex formatting are simplified.
Plain text
Keeps your words. Everything else (formatting, images, tables, layout) is stripped. Verso shows exactly what will be lost before you save.
Page layout
Page setup lives in the Inspector sidebar, which opens with ⌘⌥I and applies to the current document immediately.
Page size, margins and orientation
Open the Inspector sidebar (⌘⌥I). The Document tab at the top gives you page size (A4, Letter, Legal), orientation (portrait or landscape), and margin presets (Normal, Narrow, Wide). Pick Custom to set each margin individually with top, bottom, left, and right fields shown directly in the inspector. Changes apply to the current document immediately.
Headers and footers
In the Inspector sidebar, toggle Header or Footer on. A text area appears at the top or bottom of every page. Click it to type. The footer starts with a page number by default. You can toggle “Different first page” to use a separate header/footer on page one (useful for title pages).
Columns
Go to the toolbar and choose Insert > Columns, or use the Inspector sidebar to pick 1, 2, or 3 columns. Text reflows automatically. Turn on Column Guides in the Inspector to see where each column sits on the page.
Images
Use ⌘⌥G or Insert > Image to pick a file. Once inserted, right-click the image for alignment (left, centre, right) and resizing options. Drag a corner handle to resize while keeping the aspect ratio locked. Hold Shift while dragging to resize width and height independently. Right-click gives you text wrapping modes: inline, wrap around, or behind text.
Tables
Press ⌘⌥T or go to Insert > Table to create a grid. Right-click any cell for the full context menu: insert or delete rows and columns, set cell background colours, and choose text wrapping. Tab moves between cells.
Watermarks
Go to Format > Watermark to add a text watermark to your document. Useful for marking drafts or confidential documents. The watermark appears across every page and exports to PDF.
Writing and formatting
The parts that act on the text itself rather than on the page it sits on.
The Format Painter
Select text with the formatting you want to copy, then press ⌘⌥C (or click the paintbrush icon in the toolbar). Select the target text and press ⌘⌥V to apply. The Format Painter copies font, size, colour, bold, italic, underline, strikethrough, and paragraph style.
Redefining a paragraph style
Format a paragraph the way you want it, then right-click the style name in the style dropdown and choose “Update Style to Match.” Every paragraph using that style updates to match your new formatting.
Changing text case
Select the text you want to transform, then go to Format > Change Case. Choose from UPPERCASE, lowercase, Title Case, or tOGGLE cASE. The transformation preserves all your formatting (font, colour, size) and only changes the letter casing.
A custom font size
Click the font size field in the toolbar and type any number from 1 to 999. Press Return to apply. Verso rounds to the nearest half point. You can also pick a preset from the dropdown.
Markdown shortcuts
When Markdown shortcuts are enabled, Verso converts Markdown syntax into formatted text as you type. Type **bold** for bold, *italic* for italic, # Heading at the start of a line for headings, > for blockquotes, - for bullet lists, [text](url) for links, and ``` for code blocks. Task lists work with - [ ] and - [x] . Toggle this on or off in Settings > Writing or in the Inspector sidebar under Writing.
Pasting from the web
Regular paste (⌘V) imports HTML from the clipboard, keeping bold, italic, links, headings, and images while stripping web artifacts like background colours. Paste and Match Style (⌘⌥⇧V) strips all formatting. Paste with Original Formatting (⌘⇧V) keeps everything from the source. Tables from ChatGPT, Gemini, and other tools paste as proper grids. Code blocks get automatic syntax highlighting.
Notes and citations
Footnotes, a table of contents and a Zotero library, all of which survive a DOCX round trip.
Footnotes
Press ⌘⌥F or go to Insert > Footnote. A superscript number appears at the cursor and a popover opens for typing the footnote text. Click any existing footnote marker to edit it. Footnotes renumber automatically when you add or remove them, and they round-trip through DOCX.
Table of Contents
Go to Insert > Table of Contents. Verso scans headings below the insertion point and builds a clickable list with page numbers and dot leaders. Use Insert > Update Table of Contents after editing to refresh it.
Citations with Zotero
Open Zotero 8 and make sure the local server is enabled: go to Zotero > Settings > Advanced and tick “Allow other applications on this computer to communicate with Zotero.” Then in Verso, open the Citations panel with ⌘⇧C or Review > Show Citations Panel. Verso detects Zotero automatically. Type in the search field to find references in your library and click to insert them. If you also have the Better BibTeX plugin installed, clicking the citation button opens Zotero’s native picker directly. You can also load a .bib or CSL JSON file if you prefer to work offline.
Comments and tracked changes
Both survive a .docx save and reopen, which is the only reason either is worth using.
Comments
Select the text you want to comment on, then go to Insert > Review > Add Comment. Type your note and click Add. Commented text shows a yellow highlight. Open Insert > Review > Show Comments to see all comments in a sidebar, where you can navigate between them with Prev/Next buttons or delete them. You can reply to a comment for threaded discussions. Resolve a comment by clicking its checkmark; resolved comments show a green highlight and survive .docx round-trips.
Track changes
Go to Review > Track Changes > Toggle Tracking (⌘⇧T) to start recording edits. Insertions appear underlined in green, deletions in red with strikethrough. Bold and font formatting changes are also tracked. Accept a change with ⌘⇧A or reject with ⌘⇧D. Use the Changes Panel (⌘⌥H) to see all revisions at a glance. Accept All or Reject All from the Review menu. Use Show/Hide Changes to toggle revision visibility. Tracked changes survive .docx save and reopen.
Modes and appearance
None of these change your document. They change what you can see of it.
Focus Mode
Press ⌘⇧F or go to View > Focus Mode. All chrome hides and the window resizes to show the full page. Surrounding text dims to about a third opacity at the sentence level, so only the sentence you are working on stays fully visible. Toggle between sentence-level and paragraph-level dimming from View > Focus on Paragraph. The dimming is purely visual and never modifies your document. Press Esc or click the exit button (top right of the page) to leave. Your entire workspace (inspector, sidebars, zoom, window size) is saved and restored exactly when you exit.
No-Paper Mode
Press ⌘⇧P or go to View > No-Paper Mode. Page boundaries disappear and you get a continuous scroll, similar to a code editor. Choose a text width in the Inspector: Narrow, Medium, Wide, or Characters (set an exact column count from 40 to 200). Markdown files open in No-Paper Mode automatically. Your preference persists across sessions.
Page appearance
Go to View > Page Appearance and pick from Light, Grey, Sepia, Dark, or Auto. Auto follows your macOS system appearance. Press ⌘⌥⇧A to cycle through them quickly. The chosen appearance also applies in Focus Mode. Print and PDF export always use white pages.
The document outline
Go to View > Document Outline to open a sidebar listing all headings in your document. Click any heading to jump straight to it. The outline updates automatically as you add, remove, or edit headings.
Customising the toolbar
Go to View > Customize Format Bar. A sheet shows all toolbar groups. Drag groups to reorder them, and toggle any group on or off with its checkbox. Your layout persists across sessions, so Verso remembers which tools you want visible and where.
Zooming with a trackpad
Pinch to zoom on your trackpad to zoom in and out of the document fluidly. You can also use ⌘ + and ⌘ – or the zoom slider in the status bar.
Finding things
Find and Replace
Press ⌘F to open the Find bar. Type your search term and use the arrows or ⌘G to jump between matches. Click the gear icon for case-sensitive, whole-word, and regex toggles. Expand the bar to show the Replace field for find-and-replace. Replace and Replace All are fully undoable.
Files and saving
Turning off auto-save
Go to Verso > Settings > General and toggle Auto-save off. When disabled, documents only save when you press ⌘S. When enabled, auto-save only kicks in for documents you have already saved at least once. It will never interrupt you with a save dialog while you are typing a new document.
Shortcuts
Formatting
- Bold
- ⌘B
- Italic
- ⌘I
- Underline
- ⌘U
- Strikethrough
- ⌘⇧X
- Superscript
- ⌘⇧ =
- Subscript
- ⌘⇧ -
- Clear formatting
- ⌘ \
- Copy style
- ⌘⌥C
- Paste style
- ⌘⌥V
Styles and paragraphs
- Heading 1
- ⌘⌥ 1
- Heading 2
- ⌘⌥ 2
- Heading 3
- ⌘⌥ 3
- Heading 4
- ⌘⌥ 4
- Body style
- ⌘⌥ 0
- Align left
- ⌘⇧L
- Align centre
- ⌘⇧E
- Align right
- ⌘⇧R
- Justify
- ⌘⇧J
- Increase indent
- ⌘ ]
- Decrease indent
- ⌘ [
- Bullet list
- ⌘⇧ 8
- Numbered list
- ⌘⇧ 7
Inserting
- Insert image
- ⌘⌥G
- Insert table
- ⌘⌥T
- Insert link
- ⌘K
- Insert footnote
- ⌘⌥F
- Insert citation
- ⌘⇧C
- Page break
- ⌘⇧↩
Finding
- Find
- ⌘F
- Find next
- ⌘G
- Find previous
- ⌘⇧G
- Use selection for Find
- ⌘E
Review
- Toggle tracking
- ⌘⇧T
- Accept change
- ⌘⇧A
- Reject change
- ⌘⇧D
- Changes panel
- ⌘⌥H
- Comments panel
- ⌘⌥M
- Citations panel
- ⌘⌥C
View and modes
- Toggle inspector
- ⌘⌥I
- Focus Mode
- ⌘⇧F
- No-Paper Mode
- ⌘⇧P
- Cycle page appearance
- ⌘⌥⇧A
- Zoom in
- ⌘ +
- Zoom out
- ⌘ –
File
- Export as PDF
- ⌘⌥⇧E
- Save As
- ⌘⇧S
The format bar along the top reaches most of the same places with the mouse, and can be rearranged from View > Customize Format Bar.
A note on feature requests
Verso does less, on purpose
Verso is intentionally focused. We read every feature request, but we only build things that make writing simpler, not things that add complexity. If your workflow needs a feature Verso doesn’t have, that’s OK. There are great apps that do more. Verso does less, on purpose.
Questions
Does Verso work on Intel Macs?
Yes. Verso ships as a universal binary that runs natively on both Apple Silicon and Intel Macs. Requires macOS 14 (Sonoma) or later.
What languages does Verso support?
Verso is fully localized in 16 languages: English, Japanese, Spanish, Arabic, Polish, Simplified Chinese, French, Korean, Italian, Russian, Dutch, Traditional Chinese, German, Turkish, Swedish, and Brazilian Portuguese. It follows your macOS language setting automatically.
Where are my files stored?
Wherever you put them. Verso is a regular macOS document app. Files live on your disk, in your folders. There is no cloud, no library, and no proprietary database.
Can I save a document back to Markdown?
Yes. Markdown files fully round-trip. Open a .md file, edit it, save, and headings, lists, code blocks, tables, and inline formatting are all preserved.
Is there a subscription?
No. Verso is $14.99 one-time on the Mac App Store. No subscription, no recurring fees, no in-app purchases. All updates are included.
Does Verso send any data anywhere?
No. There is no telemetry, no analytics, no crash reporting, and no network calls of any kind. Verso runs entirely offline.
Something's wrong, or missing
Email hello@versowriter.app. Please include your macOS version, what file you were working with, and a screenshot if you can. This helps us reproduce and fix the issue faster.
See also the roadmap, what’s new, send feedback, and contact.