Skip to content
Hub Nexus
Hub Nexus

The editor — text, maths, diagrams, pictures, film and files

Hub Nexus editorsUpdated 7 min read

Comments and detailsChangesSupport

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.

The editor, with what a new page can start as

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.

The / menu

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

The bar of formats over a chosen word

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.

The bar in Full: the Home tab's groups under their labels

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.

The command palette, narrowed to "out"

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.

The shortcuts sheet: each command's keys beside what to type

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.

Tabs only: the tabs alone, a row dropping when one is pressed

Undo and Redo are on Home for when there is no keyboard. The keys, with Ctrl in place of ⌘ on Windows:

KeysDoes
⌘B, ⌘I, ⇧⌘Xbold, italic, struck out
⇧⌘Hhighlight
⌘Ecode
⌘Klink
⌥⌘1 to ⌥⌘6, ⌥⌘0heading 1 to 6, back to text
⇧⌘7, ⇧⌘8, ⇧⌘9numbered list, bulleted list, task list — again to undo it
⇧⌘↑, ⇧⌘↓move the block up or down
⌘Dduplicate the block
⌘Ffind and replace
⇧⌘Pthe command palette
⌘/every shortcut on one sheet
⌥⌘Tthe 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.

Headings, lists, a quote, formatting, a link and maths in a sentence

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.

A tip with a title and a list, a warning, and a highlight

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.

A task list, a divider and a footnote

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.

Maths and a diagram, with the Markdown beside them

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.

The table's group at the end of the bar

Paste cells copied from a spreadsheet and they become a table.

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.

The bar under a link

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.

A video player and a card, each from an address on its own line

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.

A picture at half its width, with its description

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

The video recorder, open in the editor

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.

A selected picture, with × and a line to write on above and below

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.

A block's menu

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:

FileWhat readers get
PDFpages to turn, one at a time or two side by side, with text they can select
CSV or TSVa table they can sort and search, 50 rows at a time
EPUBa book with its contents, and a larger or smaller text size
glTF (.glb)a 3D model to turn and zoom
Word, PowerPoint, Excelconverted to a PDF when you add them

A table from a CSV file

A PDF

A book

A 3D model — NASA's Ingenuity helicopter

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.

Find and replace

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

The outline beside the article

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.

Focus: everything but the paragraph being written dims

A word goal under the editor

Full screen

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.