Content blocks

Press / in the editor to open the block menu and insert any content block.

Text blocks

Paragraph and headings

Paragraphs are the default text block. Use H2 for major sections and H3 for subsections.

Blockquote

For quoted content or highlighted statements.

"Documentation is a love letter you write to your future self."

Horizontal rule

Visual divider between sections.

Inline formatting

Select text to apply formatting with the toolbar or keyboard shortcuts:

• Bold (Ctrl/Cmd+B) — emphasis

• Italic (Ctrl/Cmd+I) — subtle emphasis or titles

• Code (Ctrl/Cmd+E) — inline code, commands, or file names

• Highlight — draw attention to key terms

Lists

Bullet and numbered lists

Bullet lists for unordered items, numbered lists for sequences.

• Item one

• Item two

1. First step

2. Second step

Task list

Interactive checkboxes readers can mark complete. Progress persists in their browser.

• Create a collection

• Write your first article

• Connect a custom domain

Use for setup checklists, prerequisites, or procedures readers track themselves.

Procedures

Steps

Numbered procedure where each step has a title and body. More visual than a simple numbered list.

Use for complex procedures, tutorials, or workflows where each step needs detailed instructions.

Layout blocks

Columns

Side-by-side content. Choose between 2 or 3 columns when you insert the block.

Use for comparisons, feature grids, or splitting related content.

Card

Highlighted box linking to another article. Add an icon via the icon picker.

Use for related article links or next-step navigation.

Button

Single call-to-action button for external links.

Use for primary external actions. One per article maximum.

Code blocks

Single code block

Code with syntax highlighting. Add a filename label if helpful.

function greet(name) {
  return `Hello, ${name}!`;
}

Multi-code

Same code in multiple languages with tab switching.

// JavaScript
fetch('/api/articles')
  .then(res => res.json())

# Python
import requests
response = requests.get('/api/articles')

Use for API examples with SDKs in multiple languages.

Collapsible content

Details

Content that expands when clicked. Reader sees only the summary until they open it.

Use for FAQs, optional background, or troubleshooting not all readers need.

Media

Image

Add by dragging files into the editor, pasting from clipboard, or via the slash menu. Supports PNG, JPEG, GIF, and WebP. After inserting an image, hover over it and click Edit to crop or annotate it. See Edit images in the article editor.

Video

Add videos by embedding from a hosting platform or uploading a file directly. Press / and select Video from the block menu, then choose to embed a URL or upload a file.

Embed a video

Paste a URL from YouTube, Vimeo, Wistia, Loom, or Tella to embed the video in your article.

Upload a video

Upload a video file directly from your computer. Supported formats are MP4, WebM, MOV, and OGG.

Upload limits:

• Maximum file size: 512 MB

• Maximum duration: 2 hours

If a video does not meet these requirements, you will see an inline validation error in the upload control. Common errors include:

• File type not supported — upload an MP4, WebM, MOV, or OGG video

• File too large — maximum size is 512 MB

• Video too long — maximum duration is 2 hours

• Empty file — the video file contains no data

• Upload failed — the video could not be uploaded, try again

Custom HTML

Add custom HTML to embed third-party widgets, forms, or other external content from providers like Typeform, Calendly, Tally, or any service that gives you embed code. Press / and select Custom HTML from the block menu.

Side notes

Callout

Highlighted paragraph for tips, warnings, or important info.

Limit to one or two per article. Never stack multiple.

Data

Table

Structured data in rows and columns.

Related resources

• How to create articles manually

• Create and edit articles with Fern