Formatting the body of an article

The single post

Everything between the article header and the footer blocks is ordinary WordPress content, styled by the theme. You write with the blocks WordPress already gives you, and Verba dresses them. This page is what to expect from each one, and which of Verba own blocks belong inside a piece of writing rather than on a landing page.

#Headings

Use headings as an outline. The article title is the h1, so your first level inside the text is Heading 2, then Heading 3 under it.

This matters beyond appearance: the automatic table of contents is built from your headings, and so is the outline a search engine reads. Skipping from Heading 2 to Heading 4 to make text smaller breaks both. If you want smaller text, change the size, not the level.

#Quotes

Three shapes, and they are not interchangeable.

Quote

The default. An indented passage with an optional attribution line. Use it for something somebody said or wrote.

Quote, large style

The same block with the Large style applied from the block sidebar. Bigger type, more space around it. One per article at most, for the line the piece turns on.

Pullquote

A line lifted out of the surrounding text and repeated for emphasis. It is a design element rather than a citation, so the text in it should already appear in the article.

#Images

Verba sizes and crops images for you, and the lightbox is a core WordPress feature you switch on per image in the block sidebar. Two things are worth doing by hand every time:

Write alt text. It is what a screen reader announces and what shows if the file fails to load. Describe what the image shows, in a sentence, and leave it empty only when the image is purely decorative.

Write a caption when the image needs one. Captions are read far more often than body text, so a caption that repeats the sentence above it wastes the most-read line on the page.

For which file to upload and why an image looks soft or wrongly cropped, see the image sizes article in the Tutorials section.

#Galleries

The Gallery block lays images out in columns and Verba styles the grid at one through five columns. A gallery of two or three images reads as a comparison; past about eight it reads as an archive, and a separate page usually serves it better.

#Tables

The Table block is styled with a header row, alternating row separation, and horizontal scrolling on narrow screens so a wide table never pushes the page sideways.

Keep tables to genuinely tabular data. A table used for layout falls apart on a phone, and a reader on a phone is most of your audience.

#Code

Fenced code uses the Code block, which keeps whitespace and does not wrap. Preformatted text uses the Preformatted block. Both sit on their own surface so they read as separate from the prose.

#Separators

The Separator block has three styles: the default short rule, Wide line, and Dots. They mark a change of subject inside a long piece. Two separators in one screen means the section should probably be a heading instead.

#Drop caps

WordPress can enlarge the first letter of a paragraph, from the Typography panel in the block sidebar. Verba styles it. Use it on the opening paragraph only.

#Verba blocks that belong inside an article

Most of Verba blocks build page sections. These are the ones written for the middle of an article:

Quote

A designed quotation with its own attribution, avatar, and surface. More deliberate than the core Quote block, for the passage you want the reader to stop at.

Before / After

Two images with a slider between them. For anything the reader should compare in place rather than by scrolling.

Video Box

A video with a poster frame, so an embed does not load its player until somebody asks for it.

Image Hotspots

Points placed on an image, each opening a note. For diagrams, product shots, and anything you would otherwise explain with "top left".

Singular Post

One post, rendered as a card, inside your text. The way to reference another article without dropping a bare link.

Quick Links

A compact list of links as a block, for a set of references at the end of a section.

Label

A small pill of text. For an inline marker such as Updated or Sponsored.

Button

A single call to action. Fine in an article, but one, and not next to the share buttons.

Section Title, Post Listing, and the other section blocks work inside an article too, but they carry section spacing designed for a page layout. Inside prose they read as an interruption. Keep them for pages.

#What not to do

Do not paste styled HTML from a word processor. It brings inline colors and fonts that survive the paste and then ignore your theme, including every future change to it. Paste as plain text, then format in the editor.

Do not set colors and font sizes on individual paragraphs. The style kit sets type and color for the whole site at once, and a paragraph carrying its own values stops following it.

Last updated

Was this article helpful?

FIND THE ONE THAT FITS YOUR PROJECT

Import a demo, swap the content, adjust the layout. Modern WordPress under the hood, fast even when the site fills up.