MojoPad navigates like a browser, because a wiki is a web.
⌘[ and ⌘], or the toolbar arrows.⇧⌘H returns to your home page (set it in the Info palette ▸ Document).⇧⌘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.⇧⌘P, or the button just left of the search box — a small
window with a ›_ prompt in it — runs any
menu command by name and jumps to any page — one box for everything, no shortcut to memorize.⌘T. See Daily Notes.⌃⌘G shows the whole document as a living map. See The Graph.⌃⌘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.⇧⌘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.To read a folder from its first page to its last, go through a wiki you have just imported, or check each page a
filter has gathered, press ⌃⇧⌘↓ (Go ▸ Next Page) for the page below the one you are on in the Pages
panel, and ⌃⇧⌘↑ (Go ▸ Previous Page) for the page above it. The keys work while you are writing, in the
Pages panel and its filter box, and on a board or a map.
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.
Asking for a tab of a page you already have takes you to it. Open a page in a tab — from
the list or from a link, with whichever click opens tabs for you — send it back from a small window,
or open the page an import tells you it already has, and if a tab already holds it you land on that
tab instead of getting a second. If it is the tab you are looking at, nothing happens at all, so your
place in it is not disturbed. A click that opens a page in place still does exactly that, as
it always has, whether or not another tab holds it too. The exceptions are the commands that exist
to make a tab and say so: ⌘T, Open in New Tab, and opening a set of chosen pages as
tabs.
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 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, or View ▸ Sort Pages with a check beside the one in use,
picks how the list is arranged: Folders (tree), the default, with the pages below in
alphabetical order; Date modified (newest first — handy when you touched a page
yesterday but can't remember its name); Date created; Recently viewed (your
reading order); Folders, pages by hand, where your folders stay and you drag the pages below
them into your own order; Manual, the same order of yours as one list without folders (the
order is saved in the document, so it travels with it, and new pages join at the end until you
place them); or Flat, every page in one run. Date modified, Date created, Recently
viewed and Folders, pages by hand keep your folders and arrange the pages below them; pages with exactly the same date, or not
viewed yet, are in alphabetical order among themselves. Manual and Flat set the folders
aside: you are asking for one ordered list, so folders stop grouping the rows while either is
on. Your folders are not gone and nothing has moved — choose Folders (tree) and they
come back exactly as they were. (This is the most common reason folders seem to vanish.) To arrange
pages by hand and keep your folders, choose Folders, pages by hand instead of Manual.
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.
Some lists are yours to order, not the calendar's:
⌥⌘1 is always the draft.The pinned pages. Drag a pinned page up or down the Pinned section. While you hold it, a
line with a small open circle at its start shows where it will land: above a row when the pointer is in the
upper half of that row, below it in the lower half — so the bottom half of the last pin is the end of the
list. Let go and it is there. This works in every order the ⇅ button offers, with folders and pages as
one list or as two areas. The pins' order is the order ⌥⌘1–⌥⌘9 open them in. A page that
is not pinned is not pinned by dragging it onto the pins — right-click it ▸ Pin to Top for that.
Carry a pin down into your folders instead, onto the line between two pages of a folder, and it is filed
there — and stays pinned.
The pages below your folders. Choose ⇅ ▸ Folders, pages by hand. Your folders stay as they are, and the pages below them keep the order the list showed when you chose it, so nothing jumps. From then on, drag a page above or below another, the same way as the pins. (In every order, a page from this list let go on the line between two pages of a folder is filed there.) Manual uses the very same order, as one list without folders. In any other order, letting a page go on that list says why it can't be arranged there and offers Arrange by Hand, which chooses Folders, pages by hand for you. In Flat, which has no folders, it offers Use Manual instead: the same one list, in your own order. A list narrowed by words in the Filter box, or to the pages with one value of a property, can't be arranged either; clear the filter first. (The ✦ filter for AI-built pages is the exception: with it on, the pages it shows still drag into order in Folders, pages by hand and in Manual.)
In those other orders, the note comes only for a page let go on a page of the list, or in the space below its last page. Let it go on the list's heading, or short of its first page — on the way up to your folders, say — and nothing happens and nothing is said. And in All pages, a page let go beside a page that is in a folder is filed beside it, in that folder (see Unfiled, or every page, below).
When nothing lands. No line is drawn where a drop would not change anything. While the bar saying the wiki was changed on another device is up, no line is drawn and letting go tells you to choose Reload or Keep mine first, because nothing you arrange can be saved until you do. In a second window on the same wiki, the pins and the order are arranged in the window you opened the wiki in.
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.
What belongs to a folder. The pages in a folder start right under the folder's name — past its arrow and its icon — so a long run of pages reads at a glance as the contents of the folder above them. A folder inside it lines its icon up with those pages, its arrow just to their left, and its own pages start under its name in turn. Folders nested deeper than that step in a little less at each level, so a chain of folders still reads as one inside another and keeps its names. In a sidebar narrower than it starts out, the steps tighten, so a folder's pages start under its icon rather than its name, down to a small step at the narrowest; there, folders two or more levels deep share one column and their names may be cut to “…”, while every page keeps enough of its name to read. A focused folder at the top of the tree indents its pages the same way.
One list, or two areas. The tree scrolls as one list: folders, then the pages beneath them. If you would rather keep the two apart, turn on Settings ▸ Links & Pages ▸ Folders ▸ Show folders and pages as two areas in the Pages panel. Folders then scroll in an upper area and pages in a 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. The upper area only reaches half the sidebar before it starts scrolling.
With two areas, the line and both halves always stay on screen. A long Pinned section is drawn in full when the sidebar has room for it. When it does not, the pinned pages scroll on their own and the folder area gives up height, so the line and the page list stay in view.
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.
In All pages, a page that is in a folder is listed by its name like any other, with a small 📁 after it — so a folder's pages are there twice: in the folder, and in this list. Either one takes a page you carry to it. Let a page go just above or below a page with a 📁 here and it is filed beside that page, in its folder; a page from another folder moves there. While you hold it, the line with its small open circle shows on that row, and the row names the folder the page goes into — to Reading, say — so you know where it lands even when the folder is scrolled out of view; when the folder is open, the line shows on that page's own row in the folder too, where the page you carry will go. The message offers Undo, as for any move. The list keeps its order, so the page you let go stays where its name puts it, now with its own 📁. (While this list is in an order of your own — Folders, pages by hand, with nothing typed in the Filter box — a page let go there is placed in that order instead.)
A few folders at a time. When you are writing one paper, you want the folders for that paper in front of you and the rest out of the way — a clear desk for the work at hand. Right-click a folder and choose ◎ Focus this folder, and the tree shows only that one. To bring in another, right-click the row at the top of the tree — the one that names what you are focused on — and choose it from the list, or use View ▸ Focus Folders, which lists your folders with a check beside the ones showing. Choose as many as the work needs; choose a checked one again to put it away. In a wiki with a great many folders, both lists end with an item that counts the rest, such as 40 More Folders…: it opens the command palette on every folder, so you can type part of a name to find the one you want.
None of this moves or deletes anything. It is only the view that narrows, MojoPad remembers it with the wiki, and the row at the top of the tree always says what is showing.
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 ⇅ button beside the Filter box, or View ▸ Sort Pages, offers Flat — ignore folders, which shows every page in one run, by name, and hides the folder structure without changing it. Switch back to Folders (tree) any time.
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.
They have not been deleted — the sidebar is showing a view that leaves them out. Look for one of these:
Organizing happens by dragging, and where you let go decides what happens:
So the one gesture does two jobs, and the two look deliberately unalike, so you can tell which you will get before you let go: a line is a gap you are dropping into, a filled, outlined row is a destination you are dropping onto — and only a folder is ever a destination. What you carry rides just below and to the right of the pointer, as a small tag with the page's or folder's name, so it never covers the row you are over, or the folder that row names. Nothing is drawn where letting go would change nothing, or where the move can't be made: MojoPad refuses to drop a folder into itself or into one of its own sub-folders, which would strand the branch. 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.
Filing the page you are reading. File ▸ Move This Page to a Folder… — or type move in the command palette — lists every folder in the wiki, so you can file a page without finding it in the tree first. That matters when the tree is not showing it: when the list is filtered, when you are focused on other folders, or when you arrived by a link or a search. The folder the page is in already is marked this page is here. The first choice, Out of its folder — at the top of Folders, takes the page out of whatever folder it is in without putting it in another. A page lives in one folder, so this moves it rather than leaving a copy behind. The folder path above the page does the same from a click — see Where a page lives, below.
Taking a move back. Move a page with right-click ▸ Move to, File ▸ Move This Page to a Folder…, a folder's Add Page Here…, the folder path's card, the Pages palette, or by dragging it — from a folder, from the pins or from the list below the folders — onto a folder or next to a page in a folder it was not in, and the message that says where it went offers Undo, which puts it back where it was: in the folder it came from, in the same place in the list, or in no folder at all. (⌘Z is for your words, so it does not undo a move. A page saved as a file in a folder you follow is the one move Undo does not take back — see below.)
A folder you are following asks what you mean. Two moments this is for:
So however you move a page into a folder that mirrors one on your Mac — or into a folder inside one — MojoPad asks the same question: the folder path's card, File ▸ Move This Page to a Folder…, dragging a page — from another folder, from the pins or from the list under the folders — onto the folder or next to a page in it, a folder's Add Page Here…, right-click ▸ Move to, the Pages palette's Move to… for several pages, and File it… in the Journal's inbox triage. Two answers, and Cancel:
Cancel moves nothing. Moving several pages at once asks once, and says how many can become files. Protected pages, boards, maps and papers cannot become a file, and a page that already has a file of its own elsewhere on your Mac keeps that one, so they are filed here whichever you choose — and a page like that moved on its own is not asked about: it is filed, with Undo, and the message says why. When some pages were saved and others only filed, Undo puts back the ones filed and leaves the files alone.
Some folders are only ever filed into, with the reason in the message: in a wiki with a password, which never writes its pages out; in a folder that is only here in MojoPad — one you made with New Sub-folder… that is not on your Mac; and in a folder your Mac won't let MojoPad write in. While the bar saying the wiki was changed on another device is up, a move into a folder you follow waits like any other change to how the wiki is arranged — see On a shared or synced drive. If the bar comes up while a page is being saved as a file there, the file just made for it is taken back — never a file anyone else put there since — and when it can't be, the message names the file left in the folder. A script or a connected assistant cannot answer a question, so it is never asked one: the page is filed in MojoPad, and the answer says the folder mirrors your Mac and the page did not become a file. In a second window, or a page opened in a small window, nothing is filed at all, as for any move. See Linked Files and Folders.
Making, importing and moving whole folders into it ask too. Three more moments, each with the same two answers and Cancel:
A script that makes a page or keeps a file in a folder you follow is not asked either: the page or file is filed and nothing is written to your Mac, and the script's log in the Scripts palette says so.
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.
Three moments this is for:
Reading the path. The line above every page's title starts with its folders, outermost first — 📁 Research › Sleep › Trials — and the folder that holds the page is a shade darker. A page loose at the top of the tree says Folders. A page in no folder at all says Unfiled. A long folder name is shortened with …, and a page more than three folders deep shows the first folder, …, and the last two; point at the path for all of it. In a narrow window the path folds to the 📁 alone, which opens the page's own folder.
Clicking a folder. A small card opens under the name:
From the keyboard. Tab reaches the folder names like any other button; Return opens the
card; ↓ and ↑ move through it, → goes into a folder and ← back
out; Esc closes it and returns you to the name you opened it from.
Where it is not shown. The path is part of the page's title area, so it goes when you hide the title (View ▸ Hide/Show Page Title), and it is not drawn in Focus Mode, in a page opened with Open in Small Window, in the Journal or a Longform document, which have heads of their own, or over the graph, the gallery and a database view. It is never written into the page: an export or a share of the page is exactly what it was.
In a second window the path is there and the card lists everything, but pages are filed from the window you opened the wiki in. Pressing Move there says so in the card, every time, and moves nothing; opening a folder or showing it in the Pages panel works as usual.
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. Pinned folders keep an order of their own: drag one onto the top edge of another pinned folder, or the bottom edge of one that is folded (below an open folder is the top of what is inside it), or right-click it ▸ Move Up / Move Down. A folder that is not pinned can't be put between two that are, so no line is drawn there.
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, and their kept versions go with them (see Page versions); a copy takes none. Keep the destination document closed while you transfer, so its own saving can't clobber the newly-arrived folder.
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.
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. To open the pages one after another in the list's order without
coming back to it each time, press ⌃⇧⌘↓ and ⌃⇧⌘↑ instead (Go ▸ Next Page and Previous
Page, described above under Read your pages one after another).
Each tab keeps its own back/forward history, so two tabs can walk two different trails through the same document.
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.