Navigating

MojoPad navigates like a browser, because a wiki is a web.

• Back / Forward — ⌘[ and ⌘], or the toolbar arrows.
• Home — ⇧⌘H returns to your home page (set it in the Info palette ▸ Document).
• Open Page… — ⇧⌘O opens the quick switcher: your most recent pages are already listed, and typing narrows them with fuzzy matching. It's forgiving on purpose: words can come in any order (list grocery finds GroceryList), spaces don't have to match, a capital inside a joined name counts as a word start, and gcl-style abbreviations work too. If nothing matches, Return creates a page with that name — jump-or-create in one gesture. The fastest way to move in a big document.
• Recent Pages — the Go menu keeps your last ten visits one click away.
• Command palette — ⇧⌘P, or the ⌘ button just left of the search box, runs any menu command by name and jumps to any page — one box for everything, no shortcut to memorize.
• Today's Note — ⌘T. See Daily Notes.
• The Graph — ⌃⌘G shows the whole document as a living map. See The Graph.
• Outline — the Outline toolbar button (left of Graph, or ⌃⌘O) opens a list of the current page's headings in a sidebar; click any heading to scroll to it. The button lights up while it's open.
• Open Tasks — ⇧⌘T gathers every checkbox across the whole document into one dashboard, grouped by page. Click a task's box to check it off (or back on) in place, or its text to jump to the page it's on. Two dropdowns put your typed properties to work: filter to just the tasks on pages with a given value (every to-do on an Active project, say), and group by a property instead of by page (all your tasks under High / Medium / Low). A Show done switch reveals completed items, struck through, while the count in the title always reflects what's still open.

Tabs

Hold ⌘ while clicking any link or page-list row to open it in a new tab; the tab bar appears automatically (and has a ＋ button for more). Right-click a page in the page list and choose Open in New Tab. ⌘W closes the current tab, and closes the window when only one tab remains. Middle-click a tab to close it, right-click one for Close Other Tabs and Close Tabs to the Right, and ⌘1–⌘9 jump straight to a tab by position. In Settings ▸ Links you can flip the default so plain clicks open tabs and ⌘-clicks navigate in place.

You land where you left off

Switching to a page you've been editing puts the caret back at your last edit — the page opens scrolled to where you were working, cursor blinking mid-thought, instead of dumping you at the top. It remembers for every page you've touched this session, so hopping between two drafts feels like flipping between two typewriters, each holding your place.

The page list

The left-hand list shows every page. The filter box at the bottom narrows it as you type — and it stays while you open what it found, so a filter that gathered three pages is still holding them when you come back for the second one (Esc in the box clears it, as does the ✕ it shows while it holds anything). It filters fuzzily, same as the quick switcher: ⌘J focuses it, you type a few words in any order, and the best match rises to the top. The ⇅ button beside it picks the sort order: Alphabetical, Date modified (newest first — handy when you touched a page yesterday but can't remember its name), Date created, Recently viewed (your reading order), or Manual — in Manual, drag a row onto another to arrange the list yourself; the order is saved in the document, so it travels with it. New pages join at the end until you place them. Any sort other than the default flattens the tree: you are asking for one ordered list, so folders stop grouping the rows while it is on. Your folders are not gone and nothing has moved — set the sort back and the tree is exactly as you left it. (This is the most common "where did my folders go?", and it is also what a filter typed in the box does, for the same reason.) Rest the pointer on a row for a moment and a preview card shows the page's first lines. Right-click any row for Pin to Top — pinned pages gather at the top of the list, and ⌥⌘1–⌥⌘9 jump straight to them in pin order, the keyboard twin of ⌘1–⌘9 for tabs. The chord is yours to change: in Settings ▸ Shortcuts, Jump to Pinned Page 1–9 records one combination and the digit stands for all nine — record ⌃1 and ⌃1–⌃9 become your pin keys. Also on the right-click menu: Set Icon (give the page an emoji shown in the list, on its tab, and in its title), Set Cover (a banner image across the top of the page — once it's there, right-click the banner to resize it (Short/Medium/Tall/Full) or change/remove it; right-click ▸ Reposition to drag the image up or down to the spot you want, then click Save position), Open in New Tab, Rename, Duplicate, New Page from Clipboard, and Delete. Pinned pages gather in a Pinned section at the top of the list (the rest fall under All Pages); right-click ▸ Unpin to release one.

Folders in the sidebar

The Pages panel is one unified tree: folders and pages live together in a single list, the way a file browser shows them. Each folder wears a small amber folder icon and folds or expands — click the row, or →/← from the keyboard. Pages nest beneath their folder, and a group at the bottom holds the pages themselves.

The two halves size themselves. Folders scroll in the upper area, pages in the lower one, and the line between them is draggable — put it where your work wants it and MojoPad remembers. Double-click the line to put it back. Nothing changes for a wiki with a handful of folders: the upper area only reaches half the sidebar before it starts scrolling.

Unfiled, or every page. The heading at the foot of the tree is a switch. Unfiled — how it has always been — lists the pages in no folder. Click it for All pages and the list keeps every page in view however many folders you have gathered them into, which is what you want when that list is the drawer you fish things out of while you write.

One folder at a time. Right-click a folder and choose ◎ Focus this folder and the tree shows only that one — a clear desk for the thing you are working on today. The row above it names the folder and takes you back to all of them. Nothing is hidden and nothing is moved: it is the view that narrows, and it says so.

A page lives in one folder. Filing a page moves it — out of Unfiled, and out of any folder it was in before — which is why the menu says Move to new folder…. If you want one page to belong to several things at once, give it a tag or a property and make a smart folder from that: a saved search gathers pages without moving any of them, and a page can be gathered by as many as you like.

Prefer a plain list? The ⇅ sort menu at the bottom offers Flat — ignore folders, which shows every page in one run (by name or by date) and hides the folder structure without changing it. Switch back to Folders (tree) any time.

Several pages at once

Most of what you do to one page you eventually want to do to twenty: tag a run of them, give them all a type, get rid of a batch. Press the ☑ button beside the Filter box — Choose several pages at once — and each row gains a checkbox. Click to choose, shift-click to take the whole run between this row and the last one you touched — or shift-click back across a run you have already chosen to clear it — or All for everything the list is currently showing, which is the useful part, because a filter is already a question and this acts on its answer.

⌘-click is not the way in, here or anywhere in MojoPad: it opens a page in a new tab, and it goes on doing that while you are choosing. The check is the gesture.

A bar appears at the foot of the list with the count in it, and three things to do: Type…, Tag… and Delete. Deleting asks first, names the number, and warns you separately if any of them is a kind other pages depend on. Nothing here skips Recently Deleted. Done puts the list back to normal.

The same is on the right in the Pages palette, which can also move pages into a folder, add them to the Table of Contents, and set what they ARE.

If your folders have vanished

They have not been deleted — the sidebar is showing a view that leaves them out. The ⇅ button beside the Filter box chooses how the sidebar is arranged, and two of its choices are flat by nature: Manual — drag rows to arrange and Flat — ignore folders. Pick Folders (tree) and everything comes back exactly as it was.

A filter does the same thing for as long as it is on, because a filter is a question about pages rather than a shape: clear the Filter box, or turn off a property filter, and the tree returns.

Filing, reordering, and nesting — all by drag

Organizing happens by dragging, and where on a folder you let go decides what happens:

• Drag a page onto a folder → the page files into it. (Drag a file straight from the Finder onto a folder and it imports and files in one motion.)
• Drag a folder onto the middle of another folder → it nests inside as a sub-folder. While you hover the body of the row, a filled highlight box wraps the target — that's your cue it will go in.
• Drag a folder onto the top or bottom edge of another folder → it reorders to sit just before or just after that folder, as a sibling. A bright bar appears along that edge, showing exactly where it will land.

So the one gesture does two jobs: aim for the body of a folder to tuck one inside another, aim for an edge to rearrange the running order. The two look deliberately unalike, so you can tell which you will get before you let go: a bar is a gap you are dropping into, an outlined box is a destination you are dropping onto. Filing is only filing: nothing is copied and no page moves on disk — folders hold titles and references, so a drag rearranges the outline while your pages stay in their own files. (MojoPad also refuses to drop a folder into itself or into one of its own sub-folders, which would strand the branch.)

With one deliberate exception: a folder you are following. A folder that mirrors one on your Mac ought to behave like one, so dragging a page into it writes the page out as a file there — after asking, because putting a new file in a folder you own is not a light thing even when the gesture is. From then on the page lives on disk: edit it here or in any other editor and both stay in step. A rich-text page becomes Markdown, so anything Markdown cannot express is simplified, while its name, tags, properties and backlinks stay here in the wiki. If a file of that name is already in the folder your page is written under a different one and the status line says so — nothing of yours is ever written over. See Files on this Mac.

Or skip the aiming entirely. The reordering bands are the top and bottom thirds of the row, so there is more to hit than it looks — but the middle is the biggest part of the target and it nests, which is easy to do by accident when the neighbor is closed and nothing seems to happen. So there is a way that needs no aim at all: right-click a folder ▸ Move Up / Move Down. It shifts the folder one place among its siblings, and the two items only appear when there is somewhere to go, so a folder already at the top has no Move Up. A pinned folder counts as somewhere else — an unpinned folder cannot be moved above one, because the pin would put it back.

Pin the folders you live in

Right-click a top-level folder ▸ 📌 Pin folder to top and it rises above the rest, marked with a pin; the unpinned folders keep their own order below. Unpin folder sends it back. Pinning changes display order only — it never touches what's inside.

Move a folder to another document

Right-click a folder ▸ Move to Another Document… to send the whole branch — its sub-folders, every page inside, and any attachments (PDFs, images, and the like) — into another MojoPad document. Choose the destination document (or make a fresh one), then pick where it should land inside it: at the top level, or tucked into one of that document's own folders. Copy to Another Document… does the same but leaves the original where it is.

Kinds travel with the pages. If the folder holds a kind, or the pages in it are of one, the kind goes too — along with the names and types of the properties it uses, since those live in the document rather than on the page. Where the destination already has a property of the same name, the arriving pages are pointed at its one, so you do not end up with two fields called Year. Pages arrive still knowing what kind they are.

The pages travel with new identities so nothing collides, and if the destination already has a folder of the same name you simply get a second one — MojoPad never merges two folders silently. A move sends this document's originals to Recently Deleted (recoverable for 30 days), since the pages now live in the other document. Keep the destination document closed while you transfer, so its own saving can't clobber the newly-arrived folder.

Jump to a pinned page

Pages can be pinned too (right-click a page ▸ Pin), and you can leap to them from the keyboard. ⌥⌘1–⌥⌘9 open the first nine pinned pages in pin order; for a longer shelf, ⌥⌘P (Go ▸ Jump to Pinned Page…) opens a fuzzy list of every pinned page — type a few letters and press Return. It's the equivalent of Emacs bookmarks, and unlike the number keys it scales past nine.

The rest of the tree

• Folder menu — right-click a folder to Rename (or double-click it), New Sub-folder (folders nest as deep as you like — a Books folder with a shelf per book, say), Add Page Here, New Page Here (a fresh page filed straight in), pin/unpin, or Remove. A controls row at the top holds ＋ New folder and Collapse all / Expand all.
• File / unfile a page — a page's menu offers Add to (a folder, or a brand-new one); once filed, it gains Remove from folder.
• Filter works inside the tree — folders with a match open automatically, the rest hide.

Folders still drive the order of your PDF and ePub exports — your table of contents. New wikis no longer open with an empty Table of Contents folder (export order comes from the whole tree, so it was never doing the job its name implied); any wiki that still has one can remove it from the folder menu.

From the keyboard. Press ⌘J (View ▸ Go to Page) to jump into the list with the current page selected, then ↑/↓ to move, Home/End to jump to the ends, Return to open, and Esc to return to the editor. Start typing and it hands off to the filter box.

History is per-tab

Each tab keeps its own back/forward history, so two tabs can walk two different trails through the same document.

Switch documents

The chip at the far left of the toolbar shows the open document's name and a color dot. Click it to hop to a recent document (the window switches in place), or to Open… or start a New document. Each recent entry also has an Open in a new window button, so you can keep one wiki open while you jump to another. Every document gets its own accent color on the chip, so you always know which one you're in.