Pages and Linking

Linking is the soul of a wiki, and MojoPad makes it automatic. There are five kinds of links, and four of them make themselves.

1. Page-name links (automatic)

Whenever the name of an existing page appears in your text, it becomes a link. Type GroceryList anywhere and it links to the GroceryList page. Rename a page and every mention re-links to the new name automatically. Matching ignores case.

2. Aliases (automatic)

A page can answer to more than one name. Open the Info palette and add aliases — give "Robert Smith" the alias "Bob", and every Bob in the document links to him. Daily Notes use this trick out of the box: the page named 2026-06-11 also answers to "Thursday, June 11, 2026".

3. WikiWords (automatic, optional)

A WikiWord is a single word with a capital in the middle, LikeThis. With "Highlight WikiWords as potential links" enabled (Info palette ▸ Document, or Settings for new documents), WikiWords are underlined as potential pages — click one and the page is created. Turn it off if your writing is full of CamelCase that shouldn't link.

4. Web links (automatic)

Anything starting with http://, https://, or mojopad:// becomes a clickable link. Web links open in your browser; mojopad:// links jump to a page — even a page in a different MojoPad document. See Page Links Everywhere.

5. Links you make by hand

• Make Link (⌘L) — link the selection to a page with that exact name, creating it if needed.
• Link Selection to Page… — link the selection to any existing page, whatever the words say. Also on the right-click menu.
• Make Custom URL Link… (⌥⌘U) — register a phrase that links to a URL everywhere it appears in the document. Great for ticket numbers, company names, documentation sites.
• Add Link… (Format menu) — a one-off web link on the selection, without registering a phrase.

Knowing where a link goes

Rest the pointer on a page link for a moment and a small preview card appears — the page's first lines, without leaving where you are. Encrypted pages show a lock, attachments show their filename. Hovering a web link shows its destination URL in a tooltip, so you always know where a click will take you.

Prefer a quieter pointer? Turn the bubbles off with Settings ▸ Links ▸ Show a preview bubble when hovering links and page lists — the same switch also covers the page drawer and the Backlinks palette.

Removing links

Edit ▸ Unlink (also in the command palette) removes the link under the cursor, and it sticks: on a Markdown page the phrase is remembered as unlinked for that page, so it stays plain text after you leave and come back — automatic links and WikiWords alike. On a rich-text page the unlink holds for that exact spot. To unlink a phrase across the whole document, rename or delete the page (or remove the alias or custom URL that creates it).

Completing names

Halfway through typing a page name? Press ⌘K (Complete Page Name) and MojoPad finishes it for you, with a picker when several pages match.

Links that suggest themselves

With an embedding model installed (see Local AI), MojoPad goes a step beyond matching names. As you write, it reads the paragraph under your cursor and, when you pause, quietly offers existing pages it relates to by meaning — including ones you'd never have thought to name. A small Relates to strip appears in the corner with a page or three; click one and the link drops in right where you're typing. Ignore it and it fades. It's the fastest way to weave a new note into everything you've already written — the wiki grows its own connections as you think.

Your PDFs and books are part of this. The papers, manuals and books you keep in the wiki are read for meaning like everything else — so a paragraph you're writing can surface the paper it belongs beside, and Rediscover can hand back a paper you skimmed months ago and forgot. A long document is sampled across its whole length, not just its opening pages, so its findings count as much as its abstract. Nothing leaves your Mac; this is the same local index everything else here uses.

Embedding pages

The deepest way to connect pages is to embed one inside another. Write ![[Page Name]] on its own line — finish the closing brackets and it renders right there as you type, read-only, in a titled box (click the title to open the source page). This works the same on rich text pages and Markdown Pages. On a Markdown Page you can also type / and choose Embed page to pick from a list. Edit the source page and the embed shows the new content the next time this page renders — great for dashboards and maps of content. Embeds round-trip to ![[Page Name]] in the source; a page that is only a snapshot or attachment embeds as a card — and a PDF embeds with its first page showing, a little thumbnail of the paper right there in your literature note; click it to open the reader. An embed also counts as a connection: the embedded page shows up in its Backlinks and on the Graph, so embedding wires two pages together exactly the way a link does.

Embeds can go finer than a whole page — a single section or even a single paragraph. See Transclusion and Split View.