The block editor gives you a toolbox full of building blocks for your articles. Each one does something a little different, from plain text to interactive callouts. Let's break down the blocks you'll reach for most so you know exactly which one to use.
You can upgrade to the new Block editor at any time in the article's ⋯ More menu, or contact support to upgrade all articles at once.
/ anywhere in an article to bring up the slash command menu and see all the blocks available to you.Text Blocks
Icon | Block Name | What It's For | Slash Command(s) |
 | Text | The default paragraph block for regular body copy |
|
 | Large Heading | For major section breaks |
|
 | Medium Heading | For subsections |
|
 | Small Heading | For smaller subsections within your content |
|
 | Bullet List | Unordered items |
|
 | Numbered List | Ordered items, perfect for step by step instructions |
|
 | Callout | Helps important information stand out from the rest of your copy. Choose from Note, Tip, or Warning |
|
 | Quote | Visually sets apart something someone else said from your own writing. Press Shift + Enter inside it to start a new line without leaving the quote |
|
 | Code Block | Adds syntax highlighted code snippets. Highlighting shows up when the article is viewed, not while you're editing |
|
 | Markdown Block | Write whole sections using GitHub-flavored Markdown. It transforms into HTML when previewed |
|
Media & Embeds
Icon | Block Name | What It's For | Slash Command(s) |
 | Image | Upload or embed an image |
|
 | Embed | Drop in external content like YouTube, Arcade, Vimeo, or Spotify. You can also just paste in your link and it'll expand! ✨ |
|
Emoji | Search for an emoji and drop it into your text |
| |
 | File | Attach files under 5MB directly to your article |
|
Layout & Advanced Blocks
Icon | Block Name | What It's For | Slash Command(s) |
 | Table | Organize data into neat rows and columns. Click the + along the bottom or right edge to add a row or column. Hover over a row or column and click its handle for options to insert, move, or delete it. The first row's handle can also turn on a Header row |
|
 | Divider | Add a horizontal rule to visually separate sections |
|
 | Fold | Hide a section behind a summary line your reader clicks to expand. Great for optional detail, long examples, or FAQ style content |
|
 | Tabs | Show content in horizontal tabs, so readers can switch between versions of the same thing instead of scrolling past the ones they don't need. A block holds up to 10 tabs. See Using the Tabs Block |
|
 | Steps | Numbered steps with room for a screenshot on each one. Best for walkthroughs where every step needs its own picture. A block holds up to 20 steps. See Using the Steps Block |
|
 | Decision tree | An interactive branching guide. Ask a question, give the reader a set of answers, and send each answer down its own path. Handy for troubleshooters. A tree holds up to 30 nodes, with up to 8 answers on each. See Building a Decision Tree |
|
Diagram (Mermaid) | Write a flowchart, sequence diagram, and more as text, and the editor draws it for you. See Using the Mermaid Diagram Block |
| |
 | Button | Insert a clickable button, handy for linking to another page or resource |
|
 | HTML Block | For when you need full control, paste raw HTML |
|
 | Clip | Insert reusable content you've saved as a Clip. Update the Clip once and it updates everywhere it's used |
|
Variable | Insert a short reusable text value, like a product name or support address, saved as a Variable. It always shows the Variable's current value, so updating it in one place updates every article using it |
|