Introduction to the Block Editor
New Block Editor: Write smarter, not harder. Slash commands, instant block changes, pure documentation magic! ๐
The Block Editor is our new WYSIWYG text editor that's been built from the ground up to make technical writing effortless. If you're coming from our legacy editor, you'll notice some exciting changes that'll transform how you create content.
You can enable the Block editor Beta by heading to an article and clicking โฐ More > Upgrade to new WYSIWYG.
What happens to my existing content?
When you upgrade to the Block Editor, your existing content is preserved. Your articles will look the same to readers, and you can continue editing them with the new interface. The Block Editor maintains all the content blocks you know and love. HTML blocks, code blocks, quote blocks, and more.
We've put a lot of effort into making sure articles preserve formatting. If something looks wrong, contact us and we'll take a look.
What Makes the Block Editor Different
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
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 โบ๏ธ
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?
Working with Blocks
