The editor

Rich text

Rich text edits in place, styled exactly as it will be published. Each field allows only the tools its template lists, so nothing else can be typed, pasted or dropped in.

Click into a rich text field and a small dark toolbar appears above it. You're editing the page itself: headings, lists and quotes take on the site's own styles as you write.

Tools are set by the template

A rich field lists the tools it allows after its type:

<div>{{ body:rich:headings:lists:links:images:code }}</div>

Paragraphs, bold and italic are always on. Everything else is opt-in:

ToolWhat it adds
headingsHeadings at levels 2, 3 and 4. Level 1 belongs to the page's own title.
listsBulleted and numbered lists.
linksLinks to other pages, sites, email addresses and phone numbers.
imagesImages with captions, kept in the page's folder.
tablesTables, with buttons to add and remove rows and columns.
quotesBlock quotes.
calloutsA set-apart box for notes and tips.
embedsYouTube and Vimeo videos.
codeInline code and code blocks.

The toolbar only shows buttons for the tools the field allows. If you paste something the field doesn't allow, Verso keeps the words and drops the rest: a pasted heading in a field without headings becomes a paragraph, and pasted styles and classes are always removed.

Keyboard shortcuts

You can do most formatting without leaving the keyboard. On Windows and Linux, use Ctrl where this table says Cmd.

Type or pressTo get
Cmd+BBold
Cmd+IItalic
Cmd+E, or `text`Inline code
## then a spaceHeading 2 (### for 3, #### for 4)
- then a spaceBulleted list (* and + work too)
1. then a spaceNumbered list
> then a spaceBlock quote
``` then a spaceCode block. Add a language first, like ```js, to label it.
Shift+EnterA line break inside a paragraph
Cmd+EnterLeave a code block
TabIndent inside a code block, or move to the next cell in a table
Cmd+Z, Cmd+Shift+ZUndo and redo inside the field
EscapeFinish editing the field

The shortcuts that start lists, headings, quotes and code blocks only work for fields that allow that tool.

Links

Select some text and press the link button. Type an address and press Enter. You can write a full address, an address on your own site like /journal/, or an anchor like #pricing. Verso fills in the rest when it can: hello@example.com becomes a mailto: link, and example.com becomes https://example.com. Click inside a link and press the button again to change or remove it.

Code

Inline code is for short things inside a sentence, like a file name. A code block keeps every space and line break exactly as you type it, and Enter adds a new line instead of a new paragraph. The language you type after ``` is saved on the block as data-lang, so a script on your site can highlight it. Verso doesn't highlight code itself.

Videos

In a field with embeds, paste a YouTube or Vimeo link onto an empty line and it becomes a video with a caption. Or use the video button and paste the link there. Verso stores one clean address for each video, using YouTube's privacy-enhanced domain, and loads it lazily. Links from other sites are turned down.

Tables

The table button adds a small table. While the cursor is in it, the toolbar grows buttons to add a row below, add a column to the right, and delete the row, the column or the whole table. Tab and Shift+Tab move between cells.

What's saved

Each rich field is saved as its own file next to page.json, named after the field, like body.html. It holds clean HTML with no classes, one block per line, so changes read well in git. The look comes from the "rich" map in verso.json, which gives each element its Elevate classes when the page is rendered. See Rich fields.