Skip to main content
Table of Contents

Introduction to the Block Editor

New Block Editor: Write smarter, not harder. Slash commands, instant block changes, pure documentation magic! πŸš€

Rebecca Thompson
Updated by Rebecca Thompson
Table of Contents

This isn't just a simple update, it's a completely reimagined writing experience. The Block Editor introduces powerful new capabilities that make content creation more intuitive:

  • Drag and drop editing: Move elements around your article with ease
  • Smart element conversion: Transform content types without starting over
  • Enhanced performance: Faster loading and smoother editing experience
  • Improved user experience: Cleaner interface with better accessibility
Still seeing the Classic text editor? Head to our article about how to tell which editor you're using, and how to upgrade.

From Toolbar to Slash Commands

The biggest change you'll notice is how you add content. Gone are the days of hunting through toolbar buttons. You can now use slash commands to bring up contextual menus, making your workflow much more speedy.

Simply type / anywhere in your article and you'll see a menu of options. Want to add a callout? Type /tip or /note. Need a code block? Try /code. It's that simple. Check out the full list of shortcuts and commands to discover everything you can do.

And you can do it inside a current block. So if you want an image inside a text block, just type /image and it's super simple to insertβ€”all without clicking ☺️

The slash command menu is context-aware, so you'll only see options that make sense for where you're writing.
Modal saying 'Not available in this context'.

Getting Started

Ready to dive in? The Block Editor maintains all the content blocks you know and love. HTML blocks, code blocks, quote blocks, and more. The difference is in how you access and manipulate them.

Learn more about working with blocks. Start typing and use slash commands to explore. You'll quickly discover that this new approach makes writing documentation faster and more enjoyable than ever before ✨

What did you think of this doc?

Upgrading to the Blocks Editor

Working with Blocks

Get in touch

This site is protected by hCaptcha and its Privacy Policy and Terms of Service apply.