The editor — text, maths, diagrams, pictures, film and files
Hub Nexus editorsUpdated 7 min read
One editor writes every page. What you see is what readers get, and underneath it is plain Markdown, so nothing you write is locked in.

Start a page
A new page offers what it can start as: Video, Record a video, Record audio, Pictures, PDF or document, Text from Word, or the headings of a How-to guide or a Research write-up. Start typing instead and the choices go away.
Write
Markdown works as you type: ## starts a heading, - a bulleted list, 1. a numbered one, > a quote, and **bold**, *italic*, ~~struck out~~ and ==highlighted== turn into what they say.
Type / for a menu of blocks: a picture, video, audio or file first, then headings, quotes, callouts, lists and task lists, a table, a divider, a code block, a footnote, maths, a diagram, the recorders and text from a Word document. Keep typing to narrow it down.

Choose a few words and a bar of formats appears above them: bold, italic, struck out, highlight, code and link.

The bar
The bar has three tabs — Home for history, text, paragraphs, the three most-used inserts and Find; Insert for pictures, recordings, structure, code, maths and references; View for the panes and the modes — and three layouts, which ⌥⌘T (Ctrl+Alt+T on Windows), the ⌃⌄ button at the bar's end or View › Toolbar cycle: Full, every group under its label; Compact, one row of icons that folds what does not fit into ⋯; Tabs only, the tabs alone until one is pressed. The layout you choose is kept in this browser.

Every command in one list: press ⇧⌘P (Ctrl+Shift+P) for the command palette, type a few letters of a command or of where it lives, and press Enter.

Every shortcut on one sheet: press ⌘/ (Ctrl+/), or Keyboard shortcuts on the View tab. Each command shows its keys beside what to type for it: # and a space for a heading, **words** for bold, > [!NOTE] and a space for a callout. Type in its field to narrow it, as in the palette.

With the cursor in a table, a link or a code block, or on a picture, a callout or a diagram, that thing's own commands join the end of the row — a table's rows and columns, a link's address, a code block's language, a picture's size, a callout's look — and go when you leave it.

Undo and Redo are on Home for when there is no keyboard. The keys, with Ctrl in place of ⌘ on Windows:
| Keys | Does |
|---|---|
| ⌘B, ⌘I, ⇧⌘X | bold, italic, struck out |
| ⇧⌘H | highlight |
| ⌘E | code |
| ⌘K | link |
| ⌥⌘1 to ⌥⌘6, ⌥⌘0 | heading 1 to 6, back to text |
| ⇧⌘7, ⇧⌘8, ⇧⌘9 | numbered list, bulleted list, task list — again to undo it |
| ⇧⌘↑, ⇧⌘↓ | move the block up or down |
| ⌘D | duplicate the block |
| ⌘F | find and replace |
| ⇧⌘P | the command palette |
| ⌘/ | every shortcut on one sheet |
| ⌥⌘T | the next bar layout |
Articles keep no underline, so ⌘U says so rather than underlining something the page will drop.
Markdown pasted as plain text is laid out as Markdown. If you wanted the characters as they were, press Paste as plain text in the notice that follows.

Callouts
A callout sets a passage apart: Note, Tip, Important, Warning or Caution, each with its own colour and mark. Choose one from the / menu or type > [!NOTE]. It can have a title and hold paragraphs, lists and code. Press Enter on its empty last line to step out, or use the control in its corner to change its kind or turn it back into text. A callout is written the way GitHub and Obsidian write one, so it reads the same there. With the cursor in a callout, its look and its folding are two lists at the end of the bar, with its title and Plain text again.

Lists, dividers and footnotes
- [ ] and - [x] make a task list whose boxes readers see ticked or not, a line of --- a divider, and [^1] a footnote, with its note on a line of its own that starts [^1]:. Readers can jump from the number to the note and back.

Maths, diagrams and code
Write maths between $$ lines, or inside a sentence between single $ signs. A diagram is a mermaid code block. Both are drawn as you write; Code shows the source, Drawing the result.

A code block keeps code exactly as written. In Markdown it sits between two lines of three backticks, with the language named after the first.
With the cursor in a code block, the bar's row ends in its language list and Copy; with a diagram selected, in Drawing, Code and Remove.
Tables
Press the table button, or choose Table from the / menu.
- Tab and Shift+Tab go to the next and the previous cell; Tab in the last cell adds a row.
- Enter goes to the cell below, and in the last row adds one. Press it again in that new, empty row and the row goes and you are out of the table.
- Shift+Enter starts a new line inside a cell.
With the cursor in a table, the bar's row ends in the table's own group: a row or a column beside the cursor, a column aligned left, centre or right — numbers line up on the right — and Delete ▾ for the row, the column or the table.

Paste cells copied from a spreadsheet and they become a table.
Links, players and cards
Press ⌘K, or Link on the bar of formats. With the cursor in a link, a bar under it opens the address in a new tab, changes it or removes the link, and the bar's row ends in the same three; ⌘K there changes the address too. Type hubnx.com and it becomes https://hubnx.com; type an email address and it becomes one readers can write to.

Paste an address on a line of its own and it becomes a block. A YouTube, Vimeo, Loom, Spotify or SoundCloud address becomes a player; any other becomes a card with the page's title and site. Nothing from the other site loads until a reader presses play or the card.

Pictures, film and recordings
Drop a picture or a film into the article, use the picture button, or choose Picture, video, audio or file from the / menu. It goes in where the cursor was when you added it, even if you keep writing while it uploads. Large files upload in parts and pick up where they left off if the connection drops.
Under a picture, choose its size — 25, 50, 75 or 100% of the picture's own width, never wider than the page — and press Describe this image to say what it shows. Screen readers read that description aloud, and it appears under the picture.

Record audio, Record video and Record screen record straight into the page. The video recorder can switch between cameras.

With a picture selected, the bar's row ends in its size list, Describe this image, Replace image and Remove image.
Move, remove and make room
Click a picture, film, file or diagram to select it. A selected block shows × to remove it, and a line above and below it to write on; ↑, ↓ or Enter opens one too. A line you leave empty goes away by itself, so the page never collects blank lines.

Hover any block and a handle appears at its left. Drag it to move the block, or click it for Add a line above, Add a line below, Duplicate, Move up, Move down and Delete.

Files readers open in the page
Drop a file in the same way. Readers open it right in the page, full screen, or download the original:
| File | What readers get |
|---|---|
| pages to turn, one at a time or two side by side, with text they can select | |
| CSV or TSV | a table they can sort and search, 50 rows at a time |
| EPUB | a book with its contents, and a larger or smaller text size |
glTF (.glb) | a 3D model to turn and zoom |
| Word, PowerPoint, Excel | converted to a PDF when you add them |




A file that is not what its name says is refused before it uploads, with what to do instead.
Text from a Word document
To edit a Word document's words rather than show it as a PDF, choose Text from a Word document from the / menu, or Text from Word on a new page. Its headings, bold and italic, links, lists, tables, pictures with their descriptions, footnotes and endnotes come into the page where the cursor is. The document is read in your browser; only its pictures are uploaded. Anything Word cannot hand over, such as an equation or a chart, is counted and named, so you can add it yourself.
Find your way around a long page
Find and replace counts every match, steps through them, and can replace them all at once. Undo puts them back.

Outline lists the headings beside the text. Press one to go there.

Write without distraction
- Focus dims everything but the paragraph, list or table you are in.
- Typewriter keeps the line you are typing in the middle of the screen.
- Word goal, under the editor beside the word count and reading time, counts your words towards a number you set and says when you reach it. The goal is kept in this browser, for this change.
- Full screen leaves only the editor.



Check it before you save
- Markdown side by side shows the same article as Markdown beside it. Edit either side and the other follows; the two scroll together.
- Preview shows the article as readers will see it.
Nothing is lost
Your text saves as you write. If the browser closes first, it is kept in that browser: open the change again and press Restore them. If the same change was saved in another tab or on another device, the editor stops and offers Merge it in, keeping your text on screen while it does.
In review
When someone proposes a change, reviewers see each file compared: pictures side by side, films and recordings with their length and size, PDFs in two viewers, tables cell by cell. See How to write a page, improve one, and get paid.