Open an article (Content → Articles → New). The writing area is an empty page with a hint line; just start typing.
The toolbar
From left to right:
| Button | Use |
|---|---|
| + (Insert) | The highlighted button at the start of the toolbar. Opens the insert panel: image, gallery, video, file, table, callout, button, columns, collapsible section, divider, page break and Joomla's own buttons. |
| Template | Start the article from a template, or save the article you are writing as your own template. See Templates. |
| Read more | Places the Read more marker. The button is lit when the article has one. |
| Undo, Redo | Step back or forward. |
| Text style | Paragraph, Heading 1 to 6, Quote, Code block. |
| Bold, Italic, Underline, Link | Format the selected text. |
| Colours | One panel with two parts: text colour and highlight colour. |
| Bulleted list, Numbered list | Turn a list on or off. |
| Alignment | Left, centre, right, justify. |
| More (three vertical dots) | At the end of the toolbar: strikethrough, inline code, increase and decrease indent, subscript, superscript, clear formatting. |
| HTML source | View and edit the article's HTML. |
| Full screen | Write without distraction. |
When the editor is narrow the toolbar stays on one row and scrolls sideways.
The bar at the bottom shows the product name on the left and the number of words and characters on the right.
The "+" insert panel
Press +. The search field is focused: type a few letters and press Enter to insert the first result. Blocks are grouped as Media, Layout and blocks and Joomla. Arrow keys move between tiles, Escape closes the panel.
A block is inserted where the cursor is. On an empty line the block replaces that line. Inside a column, a callout, a collapsible section or a table cell, the block is placed inside it.
The "/" menu
On an empty line (or after a space) type /. A list opens at the cursor. Keep typing to filter, for example /image, /video, /table, /template. Use the up and down arrows to choose, Enter or Tab to insert, Escape to dismiss.
The selection bubble
Select some words and a small bar appears above them: Bold, Italic, Underline, Link, Heading 2, Heading 3 and Quote.
Links
Select text and press Ctrl+K (Mac: ⌘K), or press the Link button. Enter the address, tick "Open in a new tab" if needed, and press Enter. Put the cursor in an existing link and do the same to change or remove it.
Keyboard shortcuts
| Keys | Effect |
|---|---|
| Ctrl+Z, Ctrl+Y | Undo, redo |
| Ctrl+B, Ctrl+I, Ctrl+U | Bold, italic, underline |
| Ctrl+K | Link |
| Alt+F10 | Moves to the toolbar of the current block (image, video, gallery, table, callout). Escape returns to the text. |
| Tab, Shift+Tab | In a list: indent, outdent. In a table: next cell, previous cell. |
| Enter in an image caption | Continue in the paragraph below the image |
| Escape | Close the open panel or menu |
On a Mac use ⌘ instead of Ctrl.
Markdown shortcuts
Type these at the start of a line, followed by a space:
| Type | Result |
|---|---|
## | Heading 2 (### for Heading 3, and so on up to 6) |
- | Bulleted list |
1. | Numbered list |
> | Quote |
--- | Divider |
| three backticks | Code block |
Inside a line: **text** becomes bold, *text* becomes italic, and text between two backticks becomes inline code.
Saving
PX Editor is a Joomla editor, so you save with Joomla's usual Save and Save & Close buttons. Joomla's editor buttons (insert article, module, contact, field…) are in the Joomla group of the insert panel.