Transclusion and Panes
A wiki gets its power from reuse: write something once, see it everywhere it matters. MojoPad takes the page embed further — embed just a section, or just a single block, and open a second page beside the one you're writing. All of it live.
Embed a section
Add a heading's name after the page name and the embed shows just that section — the heading and everything under it, up to the next heading of the same level:
![[Project Plan#Milestones]]
Three ways to make one:
- Type it —
![[Page#Heading]]on its own line, on any page that takes text: formatted, Markdown, or plain text. - Pick it — type
/and choose Show a note inside this one; after you pick a page with headings, MojoPad offers the whole page or any single section. - Copy it from the outline — open the Outline (
⌃⌘O), hover a heading, and click the ⧉ that appears. Paste on any page and it becomes the live embed.
Embedding on a plain-text page
Plain-text pages embed too — put ![[Page Name]] on a line of its own and it
renders there like anywhere else, whole page or single section. A reader asked for exactly this: a
plain-text page should be able to pull in another plain-text page, and there was no good reason it
couldn't.
What is worth knowing is what the file holds. A plain-text page's whole promise is that the
text is the text, so what is stored is the marker you typed — ![[Page Name]] — and never
the borrowed words. Edit around it, close the page, open it in any other editor: the line is still
five characters and a page name. The embed is a way of seeing the other page, not a copy of
it, so the other page changing changes what you see here and nothing needs re-doing.
The marker has to be alone on its line. ![[Notes]] and more stays as written, on the
same principle: a block that swallowed the words beside it would be taking liberties with a page whose
point is that it doesn't.
And it travels. Export the page — HTML, PDF, Markdown, Word, ePub, a published site — and the
embedded page comes with it as a quoted passage under its own name, the same as on any other page
type. So a plain-text outline of a talk assembled out of ![[Section One]] markers goes
out as the whole talk, not as a page of markers. The same is true of a pane beside it and of a card:
what you see is the other page, wherever you are looking from.
Embed a single block
Any paragraph, heading, or list item can carry a small permanent name — a block id — and be embedded anywhere:
- Click into the paragraph you want to reference.
- Run Copy Block Link from Find anything (
⇧⌘P). - Paste.
![[Page#^ab12cd]]becomes a live embed of just that block.
On Markdown pages the id is plain text — a trailing marker like Some paragraph. ^ab12cd —
so it travels with your notes and round-trips cleanly (the marker is hidden when the page renders).
You can write your own memorable ids: end a line with ^budget and reference it as
![[Plans#^budget]].
An embed travels with the export
When you export a page — HTML, PDF, Markdown, Word, ePub, a published site — an embedded
page comes with it, as a quoted passage under the name of the page it came from. So a manuscript
assembled out of ![[Chapter One]] embeds exports as the whole manuscript, not as a
page full of holes. Embeds nest three deep and never loop; a live database view names itself
rather than pretending to be a table in a file that can't refresh.
Live, and connected
Section and block embeds are live views: edit the source and every embed shows the new content the next time it renders. Click an embed's title to jump to the source, right at that section. Embeds count as connections — they appear in Backlinks and on the map.
Panes: several pages side by side, each with its own tabs
Some work needs more than one page in view at once. Three cases panes are built for:
- Writing an argument out of four papers. Your summary on the left, the studies it weighs standing in panes to its right, and a colored thread from each sentence to the paper it leans on. Every pane is a whole page: scroll it, search it, mark it, quote from it, or type in it.
- Notes beside a draft. This week's plan beside last week's, a chapter beside its outline — both yours to change, each saving to its own page.
- A source beside the page you are writing. A book or a PDF in one pane with its whole reader — zoom, find, marks, where you left off — while you write about it in the other.
Opening a page beside
There is one command for it: Open Beside. It opens a page in a new pane to the right of the pane you are in, and your caret stays where you were writing.
- Right-click a link, or a page in any list — the Pages panel, search results, a database view, a tab — and choose Open Beside.
⌥-click a page link.- Press
⌥⌘↩. With the caret in a link, or just after one you have typed, that page opens beside and your caret stays in the sentence — the quickest way to bring up a source while you write about it. With the caret anywhere else, it asks which page, as View ▸ Open Beside… does. In a dialog, a list or a board card being written in, the key is left to them. You can give it another key in Settings ▸ Shortcuts. - View ▸ Open Beside… (also in Find anything) asks which page, all from the keyboard. Type a name nothing matches and it offers Write in a new page…: the page it makes opens on the left and the threads start from it, because the page being written goes where writing goes, and reading runs left to right.
- If you would like every link to do this, choose Open Beside the page you are in under Settings ▸ Links & Pages. A plain click on a link then adds a pane, in every pane.
Earlier versions had four names for this — Open Beside This Page, Add a Pane on the Right or Left, Open on the Left to Write In and Write here too — plus a reading pane that could only be read and a Side by Side mode that could only hold two. They are one command now, and every pane is the same.
Show another page in a pane
Any pane can show any page, and changing what one shows leaves the others as they are.
- Click into the pane. Click its page or its bar. The pane you are in wears a quiet ring and a tinted bar.
- Choose the page. Click it in the Pages panel, or press
⌘J(View ▸ Go to Page), type a few letters of its name and pressReturn, or click a link on the page that pane shows. The page opens in that pane, and only that pane changes.⌘-click a page in the Pages panel to open it in a new tab of that pane instead.
◀ ▶ in the pane's bar go back and forward through the pages shown in the tab in front.
A link follows your setting. By default, a link opens in the pane you clicked it in
— a link to a PDF or another file, or to a page you saved from the web such as a PubMed record or an article
you clipped, in a new tab of that pane, so the page you were reading stays. If under Settings ▸ Links & Pages you chose Open links and results in a new tab, it
opens in a new tab of that pane; if you chose Open Beside the page you are in, it opens in a new
pane to the right instead. The Pages panel and ⌘J always use the pane you are in. A link to a PDF, a
book or a web page you saved can go to one pane beside your writing instead, each in place of the last:
When a link opens a paper, in the same Settings pane (see One pane for the papers you follow,
in Writing a Long Paper).
- A new pane: Open Beside adds one, as described above.
- A page that is already open in another pane is not opened twice: that pane lights up and the status line says which pane it is. To have it here instead, drag its tab into this pane's bar.
- Moving a pane: drag its tab to the left or right edge of another pane. A pane with one tab moves there whole; from a pane with several, the tab you drag moves into a new pane there.
- + makes a new page. The + in a pane's bar makes a new, untitled page in your wiki and opens it in a new tab of that pane.
Every pane is a whole page
- Type in any of them. Click into a pane and the keyboard is there. Formatting, links, lists, pasting, dictation and Find work in it exactly as in the first, and it saves to its own page. The pane you are in wears a quiet ring and a tinted bar.
- Each pane has its own tabs and its own ◀ ▶ for Back and Forward. + makes a new,
untitled page in a new tab of that pane,
⌘Wcloses the tab you are in (and the pane, with its last tab), and⌘1to⌘9pick a tab in the pane you are in. A page that arrives on its own — a web clip, an import — opens in the pane you are in, in a tab with nothing of its own to show if it has one, rather than adding another. - One page, one pane. A page is open in one place at a time. Ask for a page that already has a pane and that pane lights up, instead of a second copy appearing. Going Back (or Forward) to a page that is open in another pane shows a card in the pane you are in, saying which pane has it; its tab reads In pane 2: … while the card is there. Go there takes you to that pane, with your caret where you left it. Bring it here saves the page, closes it there and opens it in this pane. The card keeps up with the page: drag its tab or move its pane and the card names the pane it is in now, and both buttons go there; close that pane and the page opens in the card's place. A day in the Journal or a sheet of a Longform document that is open in another pane is shown read-only where it appears a second time, with Go there beside it.
- Words travel between panes as a copy. Drag or paste text from one pane into another and it arrives cleaned the way any paste is, while the original stays where it was. Outline rows, and blocks moved by their ⠿ handle, move only within their own page: dragged over another pane they stay put, and MojoPad says so.
- The Outline and Page Styles open at the right-hand side of the window, outside every pane, and act on the page you are in.
- Boards, maps and the views that fill a pane — the map, Tasks, the Journal, search results and the rest — open in the pane you are in, as many at once as you have panes. See Views in any pane below.
- One format bar, over every pane. It formats the page you are in, and it stays exactly where it is as you click from pane to pane: over a paper, a board, a plain-text page or a view, the buttons that cannot act there are hidden where they stand, so nothing below the bar moves under your pointer.
Views in any pane: a board beside your draft, two views at once
Every pane can hold a board, a storyboard, a mind map, the map, Tasks, the Journal, a folder as one Longform document, the gallery or a database view, or search results — and several panes can hold them at once. Some of the ways that helps:
- A board beside your draft. The cards of your argument in one pane, the chapter you are writing from them in the next, so you can look across while you write instead of switching back and forth.
- Two boards, or a board and a mind map. Move ideas from a board of evidence to a board of the argument, or keep the map of a chapter beside the board you are planning it on.
- Tasks beside the map. Check off what you planned while the map shows how the pages it touches connect.
- The Journal beside the page you are writing. Today's notes in one pane, the draft they feed in the other.
- Two searches at once. Search for one idea in one pane and another idea in the pane beside it, and read the two lists of results side by side.
How they behave:
- A view opens in the pane you are in. Click into a pane, then open the map, Tasks, the Journal, the gallery or a folder as one Longform document, or search from the Search box: it opens there, and the other panes keep what they were showing. A link to a board or a map opens it in the pane you clicked in, like any page, and its tab can be dragged or moved to any pane.
- Each view answers for its own pane. Each board keeps its own zoom, the cards you picked, the
card you are writing in, its own Find and its own Undo, and saves to its own page.
Scrolling or zooming over a board beside you moves that board.
Esccloses the map or the search results in the pane you are in, and leaves Find, a search or the map in another pane as it was.⌘Fin a pane holding the Journal filters that Journal; in the pane beside it, it finds in that page. The arrow keys and a paste in a paper or a page stay there, never reaching a board in another pane. - A search in one pane leaves a search in another standing. Each keeps its own results, its own
checks by meaning and its own Back: open a result in one pane and Back in that pane returns to its
search. Searching again in the other pane, or pressing
Escthere, never stops this one. - Two Tasks views stay in step. A task checked off in one is checked off in the other.
- A day of the Journal is written in one place. With the Journal in two panes, or a day open as a page in another pane, the second copy of that day is shown to read, with Go there beside it.
- Nothing else moves. Opening a view beside the others leaves Find open where it was, leaves the Pages drawer where it was, and the format bar keeps its height, so no pane shifts under your pointer.
- A board's Undo goes with the board. Work on a board in one pane, open it later in another, and
⌘Zthere takes back the last change made to it, wherever that was made. Opened beside your page, a board leaves you where you were and opens the Card panel with it. - The Search box says the search of the pane you are in. Go to a pane with results and the box shows what that pane asked, so a word typed there refines that search; in a pane with none, the box is empty.
- Each storyboard has its own Send. With two storyboards side by side, Send opens its panel on the one you pressed, and Create page makes that one's page. On a board, ▶ walks that board alone.
- Narrow panes. On a laptop, Tasks beside two other panes shows its tasks and puts the list of views and projects behind the ☰ button in its header: press it to pick Today, Upcoming or a project. The Journal's header goes onto two lines, with the filter on the second.
- Excerpt Mode and boards. With a board open in any pane, ✂ Excerpt Mode puts what you copy on the board you were in most recently, and Send Block to Canvas puts its card on the board as it stands on screen.
- They come back. A desk, and the wiki as you left it, put each board and map back in its pane — a map beside its notes in either order.
Arranging them: comparing three papers while you write
Say your draft is on the left and three papers stand beside it: a steroid trial, a splinting study and a surgical cohort. As you write, you want the two you are comparing right now side by side, the third out of the way but one click from coming back, and the page you just looked up kept behind the paper it belongs with. Panes are arranged for that in three ways, and none of them happens unless you do it.
- Drag a tab. Press on a tab and move it. A line shows where it will land: between two tabs of
a pane's bar, to move it into that pane at that place; or down a pane's left or right edge, to open it in
a new pane there. Let go over another window or the desktop and it opens in a window of its own. It is
always a move: the page leaves the pane it was in, so it is still in one place. The tab you carried is
the one in front where it lands, and a pane whose last tab you carry away closes. Drag a pane's only tab
to another pane's edge and the whole pane moves there, keeping its color and its width. Press
Escwhile dragging to put it back where it was. - Move to Pane ▸ does the same from a menu. Right-click a link, a tab, or a page in any list
— the Pages panel, search results, a database view — choose Move to Pane, and pick a
pane by its number and the page it shows, or New Pane on the Right (offered wherever it would move
the page). A page open nowhere opens there as a new tab; a page open in another pane moves. Your caret
stays in the sentence you were writing, and the pane it went to lights up. Choose the pane you are
writing in and the page goes into a tab behind your page, so the sentence you were writing stays in
front. From the keyboard, Move to Pane… in Find anything
(
⇧⌘P) moves the page you are in, chosen with the arrow keys andReturn. - Fold a pane. ⋯ ▸ Fold Pane turns a pane into a narrow strip at its place in the
row, with its number, its color and its page's name down it; the open panes share the room it gave up.
The pane keeps its tabs, and a thread from your draft to its paper still arrives, on the strip — running
along the edges of any open pane between them, never across that pane's words. Click the
strip — or reach it with
Taband pressReturnor the space bar — and it opens where it stood. Unfold All Panes opens every strip at once. Asking for a page that is in a folded pane (a link, Go there) opens its pane too. The last open pane cannot be folded.
A page behind another in a pane's tabs keeps its own color, shown along the top of its tab, and a thread from a sentence that mentions it ends on that tab. So the splinting study, filed behind the steroid trial, is still tied to the words that cite it; click its tab to bring it forward.
The pane bar
With more than one pane open, each has a bar across its top: ◀ ▶, the pane's thread dot ● (or ✎ on the pane the threads start from), its number, its tabs and +, ⋯ and ✕. While a board is open for excerpts to land on, a pane showing a page or a paper also has ✂ for Excerpt Mode. A pane with one tab gives that tab the whole bar, so its page's name reads in full, and its ✕ is the pane's own. In a pane too narrow for all of it — three panes in a laptop window, say — ◀ ▶ and + move into the ⋯ menu as Back, Forward and New Tab, and the toolbar's own ◀ ▶ still act on the pane you are in. The ⋯ holds:
- Draw Threads From This Pane — threads start from the page you are writing, and this chooses which pane that is. Clicking into another pane to read or copy does not move them.
- Swap with Pane on the Left and Swap with Pane on the Right.
- Move Pane to a New Window — the pane goes to a window of its own with every one of its tabs, in the same order, the same one in front. It closes here only once the new window has them. A pane of more than a hundred tabs stays where it is, and the status line says so: close some of its tabs first.
- Fold Pane and, while any pane is folded, Unfold All Panes.
- Close Pane.
From the keyboard
View ▸ Next Pane (⌥⌘O) and View ▸ Previous Pane move the keyboard from pane to
pane and put the caret back where you left it in each; with only one pane open, ⌥⌘O asks which page
to open beside. ⌥⌘↩ opens the link at your caret beside, or asks which page when the caret is not in
one. View ▸ Close Pane closes the pane you are in. The same commands, and the ones on
⋯, are in Find anything (⇧⌘P), with Move to Pane…, Fold Pane and
Unfold All Panes — so moving a page to another pane, folding and unfolding need no mouse. Next Pane and
Previous Pane step over a folded pane rather than opening it.
Sizing them, and narrow screens
Panes share the width equally — the page you are writing too — so four papers and a draft on a large display, or a draft and two papers on a laptop, each get the same room. Drag the line between two panes to give one more room; a pane you have dragged keeps its width while the others make room around it — folding and unfolding a pane beside it included — and a double-click on the line shares the room equally again.
Panes narrow as you open more. When there is no longer room for all of them, the page you are writing keeps a width prose is comfortable at, the others stop at the narrowest a pane is drawn, and the row scrolls sideways rather than squeezing anything further: scroll it to reach any pane, and every pane's buttons come with it. The first time that happens, the status line suggests folding the panes you are not reading (⋯ ▸ Fold Pane). No pane folds, moves or resizes by itself. A narrow pane lays a paper or a book out more tightly, so it stays readable there.
A draft and two papers on a laptop. Before the panes are squeezed, the window makes room for them: the
page list folds into the rail on the left first — its pages icon wears a small mark and says so when you
point at it — and then, if that is not enough, the panels on the right step aside to tabs on the window's edge.
To look something up in the list, press the pages icon: the list opens over the panes, which stay where they
are, and Esc, or a press anywhere else, puts it away; choosing a page in it opens the page and puts it away too.
⌘J and View ▸ Hide/Show Pages still work — Hide/Show Pages keeps the list open as a column until you open
or close a pane. Nothing is changed in Settings: it is the window making room, and the list and the panels
come back by themselves when there is room again — a wider window, or a pane closed.
They come back
Quit with panes open and they are there the next time you open the wiki, each with its tabs, in its color, at the width you dragged it to, and folded if you folded it. A desk (View ▸ Desks) keeps them too, widths and folds included. A desk saved on a larger display fits a smaller one: the widths you dragged shrink together, keeping their shape, until every pane has room. A desk or a session saved by an earlier version comes back as panes: the reading pane, the columns and both halves of Side by Side each become a pane, in the order they stood, sharing the width equally. No two papers beside the page you are writing wear the same color as long as there are colors left.
If something looks wrong
Help ▸ Save Diagnostic Report… has a line in its Rendering section beginning Panes:. It says how many panes are open and how many tabs each holds, how many are folded, which pane has the keyboard, which the threads start from, which view each pane shows (the map, Tasks, the Journal and the like), how many page colors are worn, and whether every pane carries the same editing safeguards as the first. It is counts only, never a page's name or a word of it.
A second window on the same wiki
A small window is a card: one page, floating, for glancing at. Sometimes what you want is a second workspace — two real windows on one wiki, so a long document can sit open on one screen while you write against it on another, each with its own tabs.
Window ▶ New Window for This Wiki opens one, and so does Open in a New Window
on any page list, which opens the second window straight onto the page you picked. It is in the
Find anything (⇧⌘P) too, and Settings ▶ Shortcuts will give it a key of your
own — it ships without one, because every combination a hand reaches for is already taken.
Asking for it from a second window does nothing and says so: a new window comes from the one
you opened the wiki in. It is a full
window: its own tab bar, its own Pages panel, the toolbar, find, the outline and the format bar.
Pages you write in it are saved exactly as they are anywhere else, and both windows stay in
step — save in one and the other has it a moment later, with the same warning bar as always if you
were both editing the same page. If your cursor is in that page when the other window saves it, the
words under your cursor stay put until you leave the page, and then change where they are — in any
pane or a day of the Journal as much as on a page of its own. If you were in the other
window when it saved, the change is already showing when you come back. If it saves the page while this
window is asking you something — the address for a link, the page for [[, the file for Link to a
File…, the size of a table — the page changes behind the question, the question keeps your typing and
Return still answers it, and what you answer goes where you asked for it, in the page as it is now —
on the same side of a link, a word in bold or a formula as your cursor was. It goes in only when your line can be
told for certain: the line you were writing in is still exactly as it was, so are the lines around it up to the
nearest line with words above it and below it (or the top or the end of the page), and the page has no more and no
fewer lines like those two than it had. Where another line in the page is just like yours, or stands between lines
just like those two, those two must each be the only line like it in the page. An empty line also needs no other
empty line next to it. (A Markdown page doesn’t keep an empty paragraph you make with Return, so when the other
window saves, an answer meant for one isn’t added.)
If the page was closed or locked, or if where it goes can’t be told for certain that way — for example, the
line you were writing in was changed or deleted, the lines around it changed, or another line just like it could be
it — nothing is added and the status line says why (a snippet’s Fill In form says it on the form):
MojoPad doesn’t guess where it goes.
⌘Z then takes out what was added and leaves the other window’s changes; press it again and it goes
back past those too. Type there first, and the bar
asks which to keep — Use theirs or Keep mine — before anything is saved. That goes for
a storyboard, a mind map and a canvas too, a thought you are still writing on one included, and the answer
always goes to the page the bar names, even if you have clicked into another pane since. While the bar is
asking, a rename, a tag, a property or a line an assistant adds goes onto both versions, so whichever you
choose keeps it; and closing the window or quitting before you choose asks first. A page locked with a
password of its own works the same way in both windows. If it locks again while the bar is asking —
after the time set in Settings ▶ Security — your version and theirs are locked away with it,
and neither stays on screen; unlock it and the bar is still asking, with both. Keep mine also works
while it is locked. Writing in a property
that holds prose asks nothing: it is not the page's words, so what you write there and the other window's
change are both kept — and so is a thought typed on a mind map in the pane beside your page. A rename
from the other window asks nothing either: what you type is saved under the new name, and every pane and
stack shows it.
Delete a page in one window and the other has it in Recently Deleted too, as if you had deleted it there: it leaves that window’s panes and lists, and File ▶ Recently Deleted… in either window lists it, so you can restore it from whichever you are in. Restore it in one and it is back in both; Delete all forever… in one and it leaves the other’s Recently Deleted as well, so neither offers back a page that is no longer in the wiki. A number in an Ask answer that leads to a paper says which of the two happened (see Numbers that point to the passages of a paper).
A password put on a page in the other window protects it here too, at once. If the page is open in this window, it locks: its lock screen takes the page's place, wherever the page was showing — any pane or a small window as much as the page on its own. If you were writing in it at that moment, nothing you wrote is lost, and nothing is saved without the password. Your words stay in this window, and a bar says a password was put on the page, with two ways on: Unlock… opens the page with its password and then asks, as above, whether to keep your version or theirs — whichever you keep is saved with that password — and Export my changes… saves your words to a file you choose, outside the wiki, for when you don't know the password. There is no Keep mine on that bar: it would save your words without the password. The same happens when the password is changed in the other window. When it is taken off there while you are writing, the bar offers Use theirs, which shows the page as it now is, with no password, and Export my changes…: your words were written while the page had a password, and they are not saved without one. In case MojoPad closes unexpectedly while your words wait, it keeps a copy of them on this Mac, locked with the page’s password — the one you last unlocked it with — and offers it back the next time it starts (see Two Macs and a password). While either bar is up, closing the window or quitting asks first, and after the time set in Settings ▶ Security the page is covered by a lock screen with the same two ways on — when the password was changed or taken off, Export my changes… there first asks for the password your words were written with. While the bar is up, your words in that window are kept from everything that leaves it, as any page with a password is: a connected assistant, search, exports and a page that shows this one inside itself. A password put on, changed or taken off on another device is handled the same way, and a password taken off there is said when it arrives. And Encrypt Page… on a page that is locked here asks you to unlock it first, rather than offering to take its password off.
What the second window does not do is rearrange the wiki. Folders, pins, properties, kinds, saved views, page styles, desks, the sort order and your flashcard reviews are all kept in the window you opened the wiki in — saving a desk says so before it asks you for a name. Try one of them in the second window and it says so; the rest of the time a quiet Second window chip in the status bar is there to be hovered or clicked for the whole explanation.
There are two kinds of gesture here, and they behave differently. The ones that are only a change to the arrangement — a pin, a folder dragged somewhere, a rename — go through on the screen in front of you and are not kept: reopen the window and the arrangement is as it was. A sentence says so the first time and then not again for half a minute, so a run of them can look entirely successful. Make those in the window you opened the wiki in, where they hold.
The ones that would change your pages as well are declined before they start. Deleting a property, changing a property's type, importing kinds or references, merging another document into this one, making a new page type, and the two commands on a followed folder all say no and do nothing at all. That is the more important half, because those gestures write the wiki and your pages, and a second window is allowed to write pages. Deleting a property here took its answer off every page, which cannot be undone, and left the property itself standing — empty — the next time you opened the wiki. Choosing to stop following a folder sent its pages to Recently Deleted while the folder went on being followed, so every file arrived as a page again on the next open. Each of those commands now refuses at the door, before anything is touched, and names the window to do it in.
Importing files is not on that list, because importing is writing pages and that is what a second window is for. The one part of it that cannot land is a field a file brings that this wiki has no property for yet: those fields are left rather than written somewhere nothing could find them, and the import names them when it finishes. A field the wiki already has a property for is filled as usual, here or anywhere.
Nor is filing them — and the notice says which of the two happened. Drop files on a folder here and the pages arrive, unfiled, and it tells you so rather than naming a folder they are not in. File them yourself in the window you opened the wiki in, whenever you like; the pages are already saved and waiting.
That holds for every way something can land in a folder, not only the obvious one: a folder of notes that arrives arranged in folders of its own, File ▶ Import's part-by-part plan, a paper handed to MojoPad from outside, an emailed page and the files it brought, the export Table of Contents, and the folders MojoPad makes without being asked — for pages born on the task surface, for today's note, for a kind. None of them draws a folder here that the next open will not have. A day in the Journal is the one that still lands: what puts an entry on its date is a mark on the page, which is the page's own, not the wiki's arrangement.
Following a folder is done in the window you opened the wiki in, too: Link a Folder says so here before it asks you for one. A folder you already follow keeps working while the second window is open — the wiki's own window takes in what arrives, and the new pages turn up in both — and if that window closes, the second one takes the following over along with everything else.
Why that limit exists, because it is worth knowing rather than guessing at: a wiki's arrangement is kept as one thing, and each window holds its own copy of it while it is open. If both windows could write it, the one that saved last would quietly replace everything the other had done — a folder you made, a page you pinned — with no sign that anything had gone. Pages are different: each is its own, so two windows can write different pages all day without touching each other's work. Making the arrangement behave like the pages is the next piece of this, and until it is built the second window is honest about what it keeps.
Close the wiki's own window and the second one takes over. It becomes the window that keeps the folders and the rest, its chip goes, and it says so — so you are never left with a window that can only point at one that has closed.
It reads the wiki before it writes it. While both windows were open, the other one was the only one keeping the folders, pins and properties — so the moment it closes, this window catches up with everything that was done there, and only then starts keeping them itself. That order matters: before it, the window took over still holding the wiki as it had been when it opened, and the next pin wrote that back over everything the other window had done in between. The folders you had open here are drawn from the wiki as it now stands, which is the small price of catching up.
If the wiki cannot be read at that moment — it moved, or it is still coming down from a sync — the window stays as it was and says so, rather than taking over with a copy it cannot trust. Reopen the wiki and it takes over cleanly.
A few smaller things follow from the same rule. The second window opens on the page you sent it to rather than restoring your tabs, and it does not remember its own tabs when it closes — your places belong to the wiki's own window. It does not run the wiki's page scripts, which the first window has already run. It does not take clips from the web clipper, because filing one is a change to the arrangement. And Open Recent in it opens that wiki in a window of its own rather than taking this one somewhere else. Close it whenever you like; nothing depends on it.
A page in its own small window
Sometimes the reference you keep glancing at deserves its own little window — checklist, style guide, the page of numbers you're writing against. Right-click any page and choose Open in Small Window: the page opens as a compact card that floats above your other windows, so it stays in view while you write anywhere else — even in another app.
Any page, from any list. Not only the sidebar: search results, the Context, Backlinks, Related and Rediscover panes, the Pages pane, and the list you check sources from all offer the same right-click — Open, Open Beside, Open in Small Window and Open in a New Window. Comparing two results no longer means opening one, going back, and running the search again.
If you would rather it behaved like any other window and went behind whatever you switch to, turn off Keep small windows in front of other windows in Settings ▶ Links & Pages. Cards already open change the moment you do.
The card opens as a live reading view: edit the page in the main window and the
card updates the moment it saves. Links inside it work. Close it like any window
(⌘W), or click Open in Main Window to continue in the full app — it arrives
as a new tab, so the page you were working on is still there when you come back, and the
card closes behind you. If that page is already open in a tab, you land on that one rather than
getting a second copy of it.
And you can write in it. Click the ✎ pen in the card's header and the page becomes editable right there, with the same formatting controls and the same Find and Replace as the main window — jot the thought, check the box, rewrite the paragraph. The pen becomes 👓 eyeglasses; click again to go back to reading (your edit saves as you go, and the main window mirrors it the moment it lands). A card set to reading never changes the page: its Page Versions shows every version to read and compare, and puts one back only once you switch the card to editing (see Page versions), and a database view you open from the page — a board, a table or a gallery — keeps its filters, sort, columns and lanes as they are until you do (see Database Views). If the same page ever has unsaved changes in two windows at once, MojoPad never guesses: a small bar appears — Use theirs / Keep mine — and nothing is overwritten until you choose.
Open as many cards as you like: each is its own window, so you can draft in one, keep a source open in another, and work on a translation in a third, sized and placed however suits you.
📓 Book Notes — the reading room in one click
Every PDF and ePub's toolbar has a 📓 Book Notes button. Click it and MojoPad assembles your reading room: it opens (creating it the first time) a page named <Book> — Notes, opens the book in a pane beside it, and files the pair under Books ▸ that book — each book on its own shelf. Nothing you've already filed is moved. From there the excerpt loop below does the rest: drag a passage across and it arrives quoted, linked back to the exact spot — notes that argue with the book, page by page.
Writing with the keyboard and want to scroll the book without reaching for the mouse?
View ▸ Next Pane (⌥⌘O) hops the keyboard between the two. While the book's pane
holds the keyboard it wears a quiet ring, and the arrow, space, and page keys scroll the reading —
press ⌥⌘O again and you're back in your sentence, where you left the caret.
Your layout comes back. The two panes are remembered for the wiki — reading on one side, notes on the other. Quit MojoPad, reopen the wiki later, and the book is back in its pane beside your notes, so you pick up exactly where you were. Close the pane and it stays closed next time.
And the book remembers your place. A PDF or EPUB you're reading resumes where you left off next time you open it — a PDF at the same page, an EPUB at the same spot in the same chapter (anchored to the chapter, so it holds even if you resize the pane or change the reading font). This works in the first pane too, not just the one beside it. EPUBs are reflowable and have no fixed page numbers, so the place is remembered as a position within the book rather than a page count.
Give the page more room: fold the top. Reading on a laptop, or with the paper in a narrow pane, the title block and the row of buttons above a PDF or ePub take a good slice of the screen. Press Fold ⌃, the last button on that row, and both become one slim line: the paper’s name, where you are (“p. 3 of 14 · 2 highlights”, following you as you scroll), then the same buttons in the same order — Open in PDF editor…, Open Beside…, Book Notes, Reload, Clear highlights — each still one click. The sentence about annotating and pressing Reload moves into Reload’s tooltip: hold the pointer over it. The line stays pinned as you read. Unfold ⌄ sits exactly where Fold was, so the pointer does not move; it brings the title, folder, type and dates back. MojoPad remembers your choice for every paper you open, in every pane (each paper has its own slim line). View ▸ Fold/Unfold Paper Header does the same from the menu, and you can give it a key in Settings ▸ Shortcuts. In a pane too narrow for all the buttons, they gather into a ··· menu beside Unfold — the same names in the same order. It is separate from Hide/Show Page Title, which still hides the title on every page.
Zoom a PDF with the small − 100% + pill at the reader's lower right — or ⌘+ /
⌘− while your pointer is over the pages, ⌘0 to snap back to fit width, or a trackpad
pinch. Pages re-render sharp at any size (never a blurry stretch), your highlights stay exactly on
their words, and each document remembers its zoom along with your reading place. In the pill, 100% means
fit width: the paper as wide as its pane (rest the pointer on it and it says Back to fit width; press it, or
⌘0 with the pointer over the paper, to get back there), and the other numbers count from that.
Two zooms: the whole window, and just the paper
When it matters. The text feels small, or the paper feels small, and two controls both say zoom. They are different things.
- View ▸ Page Zoom (Zoom In
⌥⌘=, Zoom Out⌥⌘−, Actual Size⌥⌘0, or a percentage from the same menu) makes the whole window bigger or smaller: your writing, the sidebar, the buttons, and the PDF too. - The − 100% + pill at the PDF reader's lower right zooms only the paper, inside its pane. Nothing else in the window changes size.
What to do. Use either one, or both. A highlight or quote you make from 1.103.0 on lands on its words at any Page Zoom, and at any zoom of the pill. A mark made in an earlier version (1.102.x) was only right at View ▸ Page Zoom ▸ Actual Size; made at another Page Zoom, it may sit off its words. MojoPad does not rewrite old marks. To fix one, right-click it, choose Remove highlight, and select the words again (or make the quote again). If you are still on 1.102.x, set Page Zoom to Actual Size before you mark.
Jump around a long paper or book: its Outline. With a PDF or a book in front, the same small
≣ 6 sits at the top left of the title block, beside the type — and the toolbar’s Outline
button and ⌃⌘O work as they do on a page you wrote. Any of the three opens the same panel down the
right-hand side, in the same look and at the same indents; press the same one again and it closes, and the
toolbar button lights while it is open. What the panel lists is the document’s own contents:
- A PDF with a contents shows it, nested the way the PDF nests it (parts, chapters, sections), and the number on the chip is how many entries there are. Click an entry and the paper scrolls to the exact spot it points at, or to its page when it points at no more than that.
- A PDF without one — most scans — lists Page 1, Page 2 and so on, and the chip shows how many pages there are, so the panel is never blank. Click a page to go to it.
- A book shows its own table of contents with its parts and chapters nested, or, when it carries none, its chapters by title. Click one to scroll to it.
It follows your reading. The entry for the part you are in is lit, and the light moves down the list as you
scroll (or up, as you scroll back). If the list is long, the panel scrolls to keep the lit entry in view. A paper
whose title block is folded (Fold ⌃, just above) has no chip to click; the toolbar button and
⌃⌘O still open the panel.
PDFs and books read fully in the pane — real pages, selectable text, and the excerpt loop below.
The book's pane is a pane like any other, with its own tabs in the bar across its top, and any page
can stand in it: a page link clicked there opens in that pane — or beside it, if that is what you
chose under Settings ▸ Links & Pages — and ⌥-click always opens it beside. To put the
book on the other side, choose ⋯ ▸ Swap with Pane on the Left in its bar;
✕ in the bar closes it, and dragging the line between the two panes resizes them — the
width comes back next time. All of what a pane can do is in Panes: several pages side by side, each
with its own tabs, earlier in this chapter.
Excerpt into your notes
Reading a PDF or book in the pane, pull the good bits straight into the page you're writing:
drag a selection onto the note (or ⌘C it, then ⌘V on the page) and it lands as a
quote — dropped as its own block, never split into the line you were on — with a ↩ backlink
to the source and its own highlight left in the document. With ⌘C and ⌘V, paste within half
a minute of the copy: after that, or if you copy something else in MojoPad first, you get the words alone,
with no quote around them. The quote is made only in the page itself: pasted or dropped into a property, a
plain text page or a Markdown page in the raw source view, the words arrive as they are. In the Journal,
the quote goes into the day you are writing in: click into another day to quote into it. Click the ↩ and the source opens in a
pane beside your page at that exact spot — or, if a pane already shows it, that pane goes to
the spot — with a thread drawing from your quote to the highlight. The same gesture
works on a formatted text page, a Markdown page, or a canvas card, so an idea always leads back to where you
found it.
Drag a selection right away. In a paper kept in your wiki, press anywhere on the words you
selected and move: the drag starts at once, with no need to hold the pointer still first, and a slip of the
hand as you press doesn't lose your selection. Everything else you do on the selected words works as it
always has — a click clears them, a double-click selects a word and a triple-click a line, ⇧-click
extends the selection, and right-click opens its menu. To start a new selection that begins inside the
selected words, click once to clear them, then drag. Dropped into another app, the
passage arrives as the same text it always did. A paper read in place from a folder works as before: hold
the pointer still for a moment, then drag.
Papers in a folder you follow work with Ask answers too. A number in an answer, or a quote link in it, opens such a paper at the passage with its line, and marks nothing: MojoPad keeps no highlights in a file it only reads, so a press that would mark goes to the passage and says why there is none. The passages listed under the answer include these papers, and an answer you keep keeps its numbers (see A number drawn quieter, in red, or not at all, in Local AI).
A passage that runs over a word the paper split at the end of a line — tin- on one line, gling on the next — is quoted and highlighted like any other, and the quote writes the word without a gap.
Each excerpt owns a separate highlight, so quoting the same passage in two places never tangles them. Highlights are permanent marks: right-click one in the reader to remove it, or clear them all at once with the button on the bar above the paper or book that says how many there are — Clear 3 highlights, say — in whichever pane it is open. It asks first.
Every highlight in one place — and what each color means
You are reviewing the literature on one question, and you have been marking papers for a month. Some of the marks are the finding you will build on, some are what it rests on, some are what argues against it, and they are in fourteen papers, a book, a saved web page and your own notes. Open the Highlights tab in the side panel (or choose Show Highlights in Find anything) and they are all there, grouped by what each color means to you.
Give each color a name. At the top of the tab are the five colors, each with a count. Click a color’s name — Amber, say — type Key finding and press Return. Esc puts the old name back, and Return on a name you did not change keeps it. Do the same for the others: Supports, Method, Against, Ask counsel. From then on the names are what you see: the group headings, and the color choices when you highlight — the bar that appears over words selected in a paper, the highlight button’s list in a page, and Recolor in a mark’s right-click menu all say Key finding where they said Amber.
The name belongs to this wiki; the mark keeps its color. Nothing in your papers or pages is rewritten when you name a color, so a copy of the wiki opened in an older MojoPad shows every highlight as it always did, in its color, and simply shows the color’s own name. Two colors cannot have the same name. A wiki with a password keeps its names sealed with the rest of it.
Read them, and go to them. Under the colors, every highlight is listed by name, each group folding closed with its arrow. A row shows the words in their color and where they came from — the paper and its page, the book and its chapter, the saved page, or your own page. Click a row to open the passage, the way a link to it would; ⌥-click opens it beside the page you are on, and the row then says Shown beside ↩. A highlight a book made carries no color, so books and older PDF marks are listed together under Uncolored.
Narrow it. This wiki, This paper (the page in front) and This folder (the folder it is in, subfolders too) set what is counted and listed, and Filter at the bottom keeps only PDFs, books, saved web pages or your own pages. Pages with a password are never read; the tab says how many it left out.
Take them with you. Copy as quotes puts every listed highlight on the clipboard, each as “words” — source, page. Make a page of these… (the footer, or the small page button on a group’s heading) makes an ordinary page called Highlights — Key finding: the quotes grouped by source, each quote a link back to its passage, so every source shows the new page in its Backlinks. It is a snapshot — it says when it was gathered (“Gathered October 31, 2026 from 24 highlights”), and it does not change afterwards, so words you start to work in are never rewritten under you. Make it again whenever you want a fresh one: MojoPad never writes over a page of that name, it makes Highlights — Key finding (2).
Just one? Right-click a highlight in the paper and choose Copy highlight: its words go on the clipboard as a link to the passage, ready to paste into your notes (see Copy a highlight as a link, in Importing).
Your marks are readable by an assistant
What you highlight is the most considered thing on the page. Somebody decided, one passage at a time, that this mattered — and a connected assistant can now read exactly that, rather than being handed the whole document and left to guess. It gets the passages in the order you read them, each with the place it sits in the work (page 7, chapter 3) and the day you made it. A highlight in a paper also comes with the color you chose for it, when you chose one. A highlight in a book carries no color of its own — MojoPad marks a book in one shade, with none to choose — so none comes with it. Each one also comes with a link that opens the paper or the book at that mark, the kind of link your own excerpts carry, so a page an assistant writes from your marks can link each passage, not only the paper it is in.
So you can ask for a timeline built only from what you marked across twenty papers, with every line citable back to the page it came from. There is a ready-made way to ask — from-what-i-marked under AI Agents — and it is told not to fill the gaps from the papers themselves, so where your marks run out it says so instead of writing something that reads the same and is not yours.
What a color means is yours, and nothing guesses at it. If yellow means evidence to you and pink means I do not believe this, that is worth saying out loud when you ask; a paper's colors come back by name and no meaning is assumed.
A page with a password gives no marks at all. What you highlighted is part of what the password covers — a mark holds the passage itself — so it is sealed with everything else, and an assistant is told the password is the reason rather than being handed an empty list.
If you encrypted a page before this, its marks were written beside the ciphertext rather than inside it — a page already on disk is not changed by MojoPad learning better. Nothing in MojoPad will read them, but they are in the file. Help ▸ Diagnostic Report has a line under What you have marked while reading that says how many pages are like that, and on almost every Mac it says none. Unlock such a page once and it is re-sealed with your marks inside.
Link a report to the passages it quotes
A link can carry the words of a passage in one of your PDFs, not just the paper. Click it and MojoPad opens the paper at that page, finds the words, marks them, and draws a line from the link to the mark. (If you would rather see the passage and leave the paper unmarked, one setting does that: see Seeing a passage without marking it, below. A link in an Ask answer, rather than in one of your pages, always does: see A link in an Ask answer shows the passage, and never marks it.) Three ways people use it:
- A report an assistant writes for you. You ask Claude, connected to MojoPad, to read the papers in a folder and write a page on what they say about one question. Every claim in that page ends in a link to the sentence it rests on — and one click shows you the sentence in the paper beside the report, so you can check the claim against the source instead of trusting it.
- A script that builds report pages. A program that writes pages into your wiki on disk, with the wiki closed, can write the same links. Nothing is marked until you click one, so the script never touches your marks.
- Your own notes, pointing at the evidence. A reading note that says the cohort was small (p. 4) can link to those exact words, and keep working in a copy of the wiki, or after the mark was removed.
Your first one, in a minute
- Open a page an assistant wrote with links like these — they look like any other link.
- Click one. The paper opens beside the page (or moves, if it is already open in a pane) at the page the link names, the quoted words turn yellow, and a line runs from your link to them. Each paper opens a pane of its own; to have each new one take the place of the last in one pane instead, see One pane for the papers you follow, in Writing a Long Paper. If a second line runs from your link in the color of the stripe along the top of the paper’s pane, that is the pane’s thread: it runs to the top of the pane and starts from the link you just clicked (see Threads: which column this sentence stands on, in Writing a Long Paper). Drawn Along the edges, Straight across or Quiet, it stays while the pane is open; drawn Color only, it shows for a moment and then only while you point at the link or the pane. The checkbox under Settings ▶ Links & Pages ▶ Threads turns threads off.
- Click the same link again: MojoPad goes to the same mark. It never lays a second one over it.
- Right-click the mark. The first line of its menu says Made from a link on “your report”, which opens the report; below it are Copy highlight, the colors and Remove highlight, as on any mark.
Those four steps are what happens with Mark the passage, the choice MojoPad starts with. If you have chosen Show the passage without marking it instead (see Seeing a passage without marking it, below), step 2 points the words out more lightly than a highlight and saves no highlight, clicking the link again shows them again, and there is no mark to right-click.
Following several in a row. The passage you land on pulses for a few seconds, so your eye finds it. Follow the next link before it stops and only the new passage pulses: the one before goes still at once, whichever pane, paper or book it is in, and its line goes with it. Following a link to a heading, a paragraph or marked words in one of your pages stops the passage before and its line the same way, whether that page opens in front of you or in a pane. The link you followed last is the one that counts: if MojoPad is still looking for the quoted words of the link before it, it neither marks them nor takes you to them once they are found, and Mark them, pressed after you have followed a link to another passage, marks the words and says on which page without taking you back to them. With Reduce motion on in your Mac’s Accessibility settings, the passage is lit for those seconds instead of pulsing.
Seeing a passage without marking it
Every click on one of these links in a page leaves a highlight in the paper, and sometimes that is not what you want:
- Checking a report. You read a report with forty links to make sure each claim says what its source says. You want to see each sentence, not to finish with forty highlights spread over a dozen papers that are not yours to mark up.
- A paper you keep clean. The highlights in a paper are the passages you chose while reading it, and you do not want a link somebody else wrote adding to them.
- A wiki you share. The papers travel with the wiki, and so would every highlight a click left in them.
Open Settings ▸ Links & Pages and set When a link quotes a passage to Show the passage without marking it. From then on, a click on one of these links does everything it did before except keep a highlight: the paper opens at the page, the words are found the same way, the passage pulses, and the line runs from your link to it. In place of a highlight the passage is pointed out on the page more lightly than a highlight would be: it is shown, not marked. The choice covers every wiki you open on this Mac. It is not part of an exported settings file, so make it on each Mac you read on (see Two Macs, one set of preferences).
How long it stays. Until you follow another link to a passage, in this paper or any other, or close the paper. The links that end it are the ones that stop a passage pulsing, in Following several in a row above: another quoted passage, a highlight, a page of a paper, or a heading, paragraph or marked words in one of your pages. Only one passage is shown at a time, in the whole window. Scrolling, zooming and reading on do not take it away.
What is kept. No highlight, and nothing else about the passage. It is not saved with the paper or the wiki, so it is not in a backup, an export, a printout, an earlier version of the page, or a copy of the wiki on another Mac, and an assistant that reads your highlights is not told about it. It has no menu of its own: a right-click on it is a right-click on the page. If the paper has its own password and locks, or the wiki locks, the passage is taken off the page at once.
One thing does change, as it does whenever you read a paper: MojoPad remembers which page you were on. After you have checked a report, each paper it cites opens next time at the page of the passage you looked at last, not where you had been reading before.
What still makes a highlight. Anything you ask for by name: Edit ▸ Links ▸ Mark the Quoted Passages, the Mark them button on a link that came from another app, and a highlight you make yourself by selecting words. Taking a passage out of a paper does too, as it always has: words you copy or drag from a paper onto a board or into the page you are writing stay highlighted in the paper, and so do words you make a link to with Copy Link to Selected Words. The setting is about following links, and changes none of those. And if a passage already has a highlight — yours, or one an earlier click made — MojoPad takes you to that highlight and draws nothing over it. To go back to marking with every click, set the same setting to Mark the passage. Highlights already made stay either way; remove one with a right-click and Remove highlight.
A citation written as a web address that carries a sentence (a doi.org link from a reference manager, opening your own copy of the paper) follows the same setting, and the status line says The passage this link points to is on page 4. It is shown, not marked.
A link in an Ask answer shows the passage, and never marks it
You put a long paper in Ask’s From row and ask what it found, and the answer comes back with links to the sentences it rests on. Before you decide whether the answer is worth keeping, you want to see those sentences. Click a link in the answer that quotes a passage: the paper opens beside the page you are in, the passage is pointed out as Show the passage without marking it points one out, it pulses, a line runs from the link in the answer to it, and the keyboard stays where it was, so you can go right on to your next question. No highlight is saved, whichever choice is set in Settings.
Why an answer is different. A highlight is something you keep, and the words in an answer’s link were chosen by a model, writing from whatever it was given to read. So a click on a link makes a highlight only when the link is in one of your pages. If your setting is Mark the passage, the status line tells you what happened instead: The passage this link points to is on page 4. It is shown, not marked. A passage that already has a highlight is gone to, as it is from any link, and nothing is drawn over it.
Keep the answer and its links are yours. Press ↳ Save as Page or ⤵ Insert under the answer, and its links are links in a page of your wiki. A click there follows your setting like any other: with Mark the passage it marks, and the first line of the mark’s menu says Made from a link on that page, however the answer was laid out.
It is the same for an answer in Chat with your wiki on the map. And a citation in an answer, written as a web address that carries a sentence, opens your own copy of the paper as that kind of citation always does, shows the sentence there, says so on the status line, and saves no highlight.
On a board, a card dealt to you as an answer, one titled ✦ AI or ✦ You asked, is a model’s words too: a link in it shows its passage and saves no highlight, until you make a page of the card (Save as page at its foot, or right-click ▸ Make page…). From then on the card shows that page, a click on its link follows your setting, and a highlight it makes says Made from a link on that page. The page is still the model’s words, so it is one that arrived: code written in it never runs (see Only pages you wrote will run). A card’s words are written in place, so the first click on a link in an answer card may only start you writing in the card: click the link again to follow it. A card you wrote yourself is yours already. Its links follow your setting, and a highlight one makes names the board.
A highlight that a click in an answer saved in an earlier version of MojoPad stays in the paper, and its menu still names the page that was in front at the time. Remove one with a right-click and Remove highlight.
Every passage at once
On a page full of these links, choose Edit ▸ Links ▸ Mark the Quoted Passages (also in Find anything, and on the right-click of any such link). MojoPad reads each paper out of sight, marks every quoted passage it finds, and ends with one sheet: Marked 12 passages in 4 papers; 2 quotes weren’t found, the quotes it could not find with the page each was looked for on, and any paper it left alone and why. Remove the marks this made on that sheet takes back exactly those marks and nothing you marked since. A passage that is already marked is not marked again, and neither is one you mark, or reach by clicking its link, while MojoPad is still working. If a paper is locked, or the wiki locks, before MojoPad finishes, the sheet lists each paper it didn’t finish and how many quotes are left in it. A paper whose password was changed on another device while MojoPad was marking it is listed too: answer the bar at the top about it first, then mark its passages again.
A whole folder of reports, or the whole wiki
Your assistant wrote forty reports into a folder, each citing papers. Right-click the folder and choose Mark the Quoted Passages in This Folder…, or choose Edit ▸ Links ▸ Mark the Quoted Passages Everywhere… for every page of the wiki. One sheet opens first and tells you what the run will do before any paper is opened: “Reports”, with its folders, has 61 links that quote a passage, on 38 pages, in 14 papers. The pop-up on the sheet changes which folder it is about, and the counts change with it. Press Mark Them, or Cancel and nothing happens.
While it works, a note at the bottom of the window says Marking quoted passages… paper 6 of 14 with a Stop button. Stop ends the run after the paper in hand, and the sheet at the end lists each paper it didn’t reach, so a stopped run never looks like a finished one. Each paper is opened once, however many reports quote it, and each mark is labeled with the page that holds its link, so a paper’s marks tell you which report each came from. Remove the marks this made on the final sheet takes back the whole run at once.
A page with a password of its own is never read, locked or not: its links aren’t marked, and both the first sheet and the last say how many such pages were left out. A paper read from a folder on your Mac, a locked paper, and a paper that isn’t a PDF are left alone and listed, as on one page.
How the words are found
The link names a page, and MojoPad looks there first, then on the page after, the page before, and two pages either way — never further. A link names the page by the PDF’s own count, starting at one, and the numbers printed on a paper’s pages are often different: a page or two later when the PDF adds a cover sheet, and a journal’s own numbers, which run through the whole volume, can be in the hundreds or thousands. A quote at the foot of a page is often counted as the next. Past two pages, the same words are more likely a different passage than a miscount, so MojoPad stops rather than mark the wrong one. A link that names no page, or a page past the paper’s last one, is looked for through the whole paper.
The same words more than once. A short quote — the cohort was small — can be on those pages several times. MojoPad marks the first place it comes to, looking in the order above, and on a page the first place in its text — words in the capitals the quote has them in before the same words in other capitals, whichever page they are on. A link that names no page gets the first place in the paper; one that names a page past the paper’s last is looked for from the last page back. If a link goes to the wrong passage, make its quote longer: a few more words before or after are enough to name one passage. An assistant can catch these before you click — when it checks a page’s quote links it is told which quotes are there more than once (see A report that links to the sentences it quotes, in AI Agents).
A quote that runs from the foot of one page onto the top of the next is found too, past the page number and the heading printed between the two halves. A mark is on one page, so MojoPad marks the part on the page that holds more of it.
A mark that already holds the words. When a mark on those pages holds a link’s quote, your click goes to that mark instead of looking again — once MojoPad has checked the mark against the paper: it reads the page the mark is on and looks for the quote where the mark lies. For a mark you made, or a click made, the words are there, and you go to it as you always have. (A selection dragged over a page break is marked on the page it began on only, so a quote that runs past that page is looked for like any other.) A mark whose words are not the paper’s words where it lies is passed over: MojoPad looks for the quote as if that mark were not there, and marks it where it is (or only shows it there, when When a link quotes a passage is set to show it without marking it, or when the link is in an Ask answer), or tells you it could not find it. That can happen when a program other than MojoPad has written marks into the wiki’s files, or when the PDF was replaced after it was marked. Mark the Quoted Passages goes by the same rule, and so does an assistant’s check, which tells the assistant that a mark did not match.
Only letters and digits are compared, in any language. Spaces, line breaks, punctuation, curly or straight quotation marks, the different dashes, a word broken across a line with a hyphen, the invisible hyphens some papers carry, and letters a font joins together (the fi in finding) are all taken as the page has them. Capitals are compared as written first, and only if that finds nothing are they ignored. A quote of fewer than eight letters is not looked for at all, because it would match on every page.
A manuscript with numbered lines. A paper under review prints a number beside each line, and in the paper’s text that number stands between the last word of one line and the first word of the next. MojoPad recognizes a column of line numbers in the left or right margin and reads the lines without them, so a quote that runs from one line onto the next is found whether or not it repeats the number, and a word broken at the end of a line — inter- on one line, vention on the next — is found written as intervention, inter-vention or inter- vention. The mark covers the quoted words only, not the number beside them. Numbers that are part of the text — a count, a figure’s number, a footnote — are read as the words they are. A table whose rows are numbered 1, 2, 3 down the very edge of its page, with nothing further out, can look like a numbered margin: a quote of one of its rows is still found, though its mark may leave out the row’s number.
When MojoPad doesn’t mark
- You asked it not to. With Settings ▸ Links & Pages ▸ When a link quotes a passage set to Show the passage without marking it, your click shows the passage and saves no highlight (see Seeing a passage without marking it, above). Everything below is the same with either choice.
- The link is in an answer, not in one of your pages. A link in an Ask answer shows the passage and saves no highlight (see A link in an Ask answer shows the passage, and never marks it, above). Save the answer as a page, or insert it into one, and its links follow your setting like any others.
- The words are not there. The paper opens at the page the link named — or at its first page, when the link names a page the paper doesn’t have. A link that names no page leaves you where you were reading. A notice at the bottom of the window says MojoPad couldn’t find the quoted words on page 4 of “Smith 2020”. It stays until you press OK. The usual reason is a quote written from a different version of the paper — a web page, a preprint — than the PDF you have.
- The paper has its own password and is locked. It opens on its lock screen and nothing is marked: its marks are sealed with it. Unlock it and click the link again. A mark made on such a page is sealed under its password, like every mark. If the bar at the top says the paper’s password was changed elsewhere, answer the bar first, then click the link again.
- The paper is one MojoPad reads from a folder on your Mac rather than holding a copy of. MojoPad never keeps marks in those, because the file can change under them. The paper opens at the words and the status line says why there is no mark. A link in an Ask answer, or any link when you have chosen to show passages without marking them, shows the passage in such a paper the way it does in any other, with its line, because showing writes nothing.
- The link came from another app — a Word file you exported, a mail message. Any program on your Mac can send MojoPad a link, so a link from outside never makes a mark by itself: MojoPad opens the paper at the words and offers Mark them, and the mark is made only when you press it.
- The quote is too long or too short to look for, or the link points at a page that is not a PDF. MojoPad opens the page and says so.
And a link to a mark that has since been removed — a citation from an excerpt, or a link you made with Copy Link to Selected Words — no longer opens the paper in silence: it says MojoPad couldn’t find the marked passage this link points to, and, for a citation that names a page, which page it opened instead.
What an assistant sees
MojoPad gives an assistant no tool that marks your papers. An assistant writes the link, and your click makes the mark — or only shows the passage, if that is what you chose in Settings or the link is in an Ask answer rather than in a page, and then there is nothing for an assistant to read. When an assistant later reads what you marked, a mark made from a link comes back labeled as one, so it is not reported as a passage you chose. The words a link quotes are never written to MojoPad’s log, and the diagnostic report counts these marks — reading highlights: 40 (12 made from a link) — without saying what they say.
A program that writes into a wiki’s files itself, outside MojoPad, is another matter: it can write anything there, a mark included, and a mark written that way looks like one of yours. MojoPad does not take such a mark at its word about the paper — see A mark that already holds the words, above.
Writing one by hand
The link is written mojoref:, the paper’s page id, then the parts it needs, each
after a semicolon:
mojoref:<page id>;pdf=4;q=the%20cohort%20was%20small
pdf= is the page, counted the way the PDF counts. q= is the words,
written the way a web address writes them — a space as %20, and most punctuation
the same way — at most 500 characters. Add c=green (or amber, pink or blue) for a
color other than yellow: one color for each kind of comment, say. The color is used when your click
makes the mark, so words that already have a mark over them keep the color they have. A link that
also names a mark, with hl=, goes to that mark while
it is there and uses the words when it is not. The words survive a Markdown page, a Markdown export
and a Word file; in Word the link still opens MojoPad at the passage. A color name MojoPad
doesn’t have is yellow. A part MojoPad can’t read — one it doesn’t
recognize, or a color that isn’t a plain word — is skipped and the rest of the link
still works, though a Word export leaves a link like that out and lists it with the links it
couldn’t keep. An assistant connected to MojoPad is told how to write these links, colors
included; you only need this to write one yourself.
Quoting words on a text page
You keep a research record as a page — a PubMed record, a clipped article, your own notes
— and a report quotes one sentence of it. A quote link works on a Formatted Text or Markdown
page as well as on a PDF. Write it without pdf=:
mojoref:<page id>;q=the%20seedlings%20were%20watered%20twice%20a%20week
Click the link and the page opens
beside you with those words lit where they stand, and scrolled to the middle of the pane. The words are
found the way a PDF’s quote is found: line breaks, curly quotes, dashes and a word split with a hyphen
at a line end don’t matter, capitals matter only when the page has the words no other way, and the
first place the words appear is the one you land on. Nothing is marked and the page is never
changed, whatever Settings ▸ Links & Pages says — a highlight in a page of words
would be an edit to your page. If the words aren’t on the page any more, because you rewrote
the sentence, the page still opens and the status line says so. A c= color is accepted but a
page of words always lights its words in one color.
The same links are checked by your assistant: asked to check the quote links on that page, it learns for each one whether the words are on the text page, and how many times when they are there more than once (lengthen the quote until it names one place). There is no page number to report, because a text page is one page. Mark the Quoted Passages leaves text pages alone and says why: marking is for PDFs, and a text page is lit when you follow the link instead. Images, boards and books are still left out of both.