Overview

The markdown editor is the flagship editor for writing pages. It is the recommended editor for most users.

Tip

To learn about the Markdown syntax and the supported addons, check out the Markdown Syntax guide instead.

Interface

/guide/images/markdown-editor-ui.png

The editor is divided into 2 sections:

The right-most Page Actions Bar also becomes orange in edit mode, with additional functions.

Running on the powerful Monaco engine (the same engine as VS Code), it provides everything an editor needs to quickly write content.

The top toolbar (in blue ) contains shortcuts to formatting (e.g. bold, italic, etc.). Select text in the code editor and click on one of the formatting buttons to apply that formatting to the selection.
The left toolbar (in grey ) contains shortcuts for inserting content (e.g. links, images, blocks, etc.).
On the right portion of the editor, a minimap is displayed to quickly locate and move around long pages.

Some elements (e.g. tables, content blocks, etc.) can be edited visually by clicking the grey Edit <...> link above them.

Press F1 to show the Command Palette. It's a quick access dialog to all available commands and editor configurations.

Note

The command palette may show keyboard shortcuts that are already registered by the browser / extensions and may not work as a result.

With a text selection, press Ctrl + D to select the next instance.
Hold Alt while clicking to insert multiple cursors.
Press Ctrl + Shift + Up/Down to add a cursor above or below the current one.

The Render Preview shows a preview of the Markdown content, as it will displayed once saved.

The Render Preview can be toggled off/on by clicking the icon at the top in order to use the full width as the code editor.
The preview will automatically scroll to stay in sync with where you are in the code editor (cursor position). To disable the scroll sync, click the button to toggle it off.
When using tabs, the tab matching the content where the cursor is will automatically be focused.

In addition to the usual buttons, the following buttons are available in the editor: