The editor
The slash menu and its fifteen blocks - headings, code, images, embeds, tables, callouts, FAQs and a live Canvas diagram - plus the toolbar and the drag handle.
The editor is a writing surface first: type and it behaves like a document. Everything beyond plain text comes from one menu.
The slash menu#
Press / on an empty line. Type to filter - /img, /code, /tab all get you
there without arrowing through the list.
Fifteen blocks, in three groups.
Style#
| Block | |
|---|---|
| Text | Back to a normal paragraph. |
| Heading 2 and Heading 3 | The two levels the menu offers. Your post's title is already the top-level heading, so start at Heading 2. |
| Bullet list and Numbered list | |
| Blockquote | |
| Code block | Syntax highlighted, with a language picker. |
Insert#
| Block | |
|---|---|
| Divider | A horizontal rule. |
| Image | Upload or paste. |
| Embed | Paste a URL - YouTube, Vimeo, Loom, Spotify, CodePen, CodeSandbox, StackBlitz, Figma, a tweet and more. |
| Canvas diagram | One of your own boards, animation included. See embedding a board in a post. |
| Bookmark | A URL as a rich link card rather than bare text. |
| Table |
Editorial#
| Block | |
|---|---|
| Callout | A boxed aside - note, warning, and so on. |
| FAQ | A question-and-answer block, marked up so search engines can read it as one. |
Selecting text#
Select any text and a small toolbar appears: bold, italic, underline, strikethrough, a text colour, a link, and a code block.
Markdown shortcuts also work as you type - **bold** for bold, - for a list, > for a quote -
and straight quotes, dashes and ellipses are tidied into their typographic forms automatically.
Moving blocks#
Hover the left edge of a block for a drag handle. Drag to reorder, or use the handle's menu to duplicate or delete.
Images#
Uploaded images are stored and served by us, so a post does not break when some other host goes away.
Give each one alt text. It is what a screen reader announces and what shows if the image fails to load - and, on a technical post, it is often the only description of a diagram.
Related#
Was this page helpful?