MojoPad

The Canvas

Some thinking doesn't want to be a list — it wants to be laid out on a table: this idea next to that one, an arrow between them, the odd sticky note in the corner. A canvas is a spatial board where your pages become movable cards you can arrange, connect, resize, and edit — and it's still just a page in your wiki, so it links, versions, exports, and encrypts like everything else.

Your first board in a minute

  1. File ▸ New Canvas (⌃⌘N), or run New Canvas… from the command palette (⇧⌘P). Name it and you're looking at a dot grid.
  2. Drag any page from the Pages panel onto the board. It lands as a card showing the page's live content — not a copy, the actual page.
  3. Double-click empty board and type — that's a sticky, a loose thought that lives only on this canvas.
  4. Hover a card and drag one of its edge dots to another card — an arrow. Double-click the arrow to label it.
  5. Double-click a page card's text and just write. You're editing the real page, right there on the board. Press Esc or click the background when done.

That's the whole model: pages as cards, stickies for loose thoughts, arrows for relationships, and everything editable in place.

Cards

  • Every page card is the live page. Change the page anywhere — on the board, in the editor, in Side by Side — and every card showing it updates. Delete a card (✕ or ) and only the card goes; the page is untouched.
  • Three sizes: click in a card's header to cycle pill (just the title), preview, and full. Drag the right edge to set width, or the corner grip to size it freely — long content scrolls inside the card with a normal mouse wheel.
  • Double-click the title to open the page in the editor; double-click the body to edit it right on the board. While editing, the card carries the full editing engine — links, formatting, the works.
  • Light or dark ground. The board is warm paper by default — like every serious spatial tool — so card colors really read: right-click a card and pick a color, and it gets a tinted header band and a soft wash. Color your evidence green and your doubts red; the grouping is the point. Prefer a dark desk? The zoom pill's / toggle flips this board to a dark ground (see Getting around) — a per-canvas choice, saved with the board; your colored cards keep their light faces and pop against it.
  • Right-click a card for sizes, colors, and actions. -click to multi-select; -drag on the background lassoes a group. Selected cards move together.
  • Photos, PDFs, and videos are cards too. Drop image or PDF files straight from Finder — they're imported as file pages and land on the board; photos show and PDFs read in place. Drag a YouTube, Vimeo, or TED link from your browser onto the board (or right-click ▸ Add video here…) and it becomes a video page, named after the video, playing right on the card. Images come in three ways: drag a file from Finder, right-click ▸ Add image / file here… for a picker, or copy an image anywhere and right-click ▸ Paste image.

Stickies — markdown note cards

Double-click the board and type. A sticky is a canvas-local markdown note: no page is created, nothing shows in your page list — but it writes like a MojoPad note. Type # headings, - lists, **bold**, or press / for the same insert menu pages have — headings, lists, quotes, the lot. Click away and the card renders your markdown beautifully. When a sticky grows up, right-click ▸ Make page… — it graduates to a real markdown page, formatting intact. Capture loosely, promote deliberately.

Arrows that become knowledge

Arrows you sketch are board-local — free, disposable thinking. When one turns out to be true, right-click it ▸ Make real: the relationship is promoted into the wiki itself and shows up in the graph and connections from then on. The board is where connections are tried; the graph is where they live.

Connectors take color and direction. Right-click a connector: the same 8-color picker the cards use sits at the top (the arrowheads follow the line's color), and an arrowheads section chooses where the arrow points — end, start, both ends, or none.

Not everything is an arrow. Right-click any connector to change its look — and Branch turns it into a true mind-map limb: every branch child hangs off one point at the parent's bottom, and the connector forks — a trunk down, a bar across, a drop into each child's top, MarginNote-style. The upper card is always the parent, whichever way you dragged, so the flow always reads downward, and the tree re-routes live as you move cards. Line and Dashed round out the set, and one more click — Use this style for new connectors — makes every connector you drag from then on born that way, so building a whole map never means restyling each limb. The library will keep growing.

Frames

Lasso a few cards, right-click ▸ Frame selected — a titled region that moves as one. Use frames to name neighborhoods of the board: "Evidence", "To read", "Chapter 2".

Right-click a frame for its own menu: color chips tint the region (the same palette cards use, worn lighter), Fit to contents shrink-wraps the frame around the cards it holds, and Collapse to a pill folds the whole neighborhood — its cards and their connectors hide, and the pill tells you how many cards are sleeping inside. Double-click the pill to open it again. Collapsing is how a big board stays readable: fold the neighborhoods you're not thinking about right now.

Working the board

Undo works on the board. ⌘Z takes back the last board change — a move, a delete, a connector, a color, even a full ✦ Arrange — and ⇧⌘Z brings it back. While you're typing inside a note, undo belongs to the text, exactly like any page; click out and it's the board's again. The camera never jumps on undo — only things move, not your view.

Duplicate and copy. ⌘D duplicates the selected cards just beside themselves. ⌘C copies them — connectors between copied cards ride along — and ⌘V pastes at your pointer, on this board or any other. Both live in the card's right-click menu too.

Line things up. Select two or more cards and right-click: a compact row of align buttons appears — left, centres, right, top, middles, bottom, and (with three or more) distribute. While dragging a single card you'll feel it snap to the edges and centres of its neighbours, with a hairline guide showing what it matched; hold to drag free.

Pin what must not move. Right-click a card ▸ Lock in place — it keeps its spot through drags, group moves, and aligns (a small 🔒 rides its title). And when cards overlap, ⬆ Front / ⬇ Back in the same menu settles who's on top.

Take a picture. Right-click the background ▸ Export board as PNG… — the whole board, fit to view on the paper ground, saved wherever you point it. (It captures at your window's resolution — a bigger window makes a bigger image.)

Sending things TO a canvas

Or just type. Click the board and start typing — a note is born under your pointer with your first keystroke already in it. Type / instead and the whole creation catalog opens right there. Thought → keystroke → card.

Right-click the board — everything that can land on a canvas is in that menu. Create fresh: a sticky, a new page, a new canvas (a board within the board), or a sketch. Bring in: an existing page, an image or file (picker), a video (YouTube, Vimeo, or a TED talk), a web page (captured as a readable article), or just Paste — the clipboard finds its shape: an image becomes an image card, a video link becomes a playing video, anything else a sticky.

  • Send Block to Canvas… (command palette, from any page): the paragraph the caret is in becomes a live card on the canvas you pick — it stays in sync with the source page.
  • Drag selected text from the split pane, another window, or a browser onto the board — it lands as a sticky. Text dragged from the split pane carries a small from chip that reopens its source.
  • Excerpt mode ✂ — the research trick, for PDFs and ePub books. Drop one on the board (or add one already in your wiki), right-click its card ▸ Open beside the board — it opens in the split pane, full size. Click in the pane's header, and every copy (⌘C) in that pane lands on the board as a card automatically. Dragging a selection from the pane onto the board does the same thing, no ✂ needed. Either way, the passage stays highlighted in the source, permanently, saved with the page. Take a paper apart without ever leaving the board.
  • The thread back. Every excerpt card wears a chip — from Paper.pdf · p.12, or from Book · ch.3. Click it: the source opens beside the board, scrolls to the spot, the highlight pulses, and a thread draws itself from your note to the exact passage it came from. Your board and your reading stay stitched together. (Right-click a highlight in the reader to remove it — cards keep their text either way.)

The board thinks ✦

Everything here runs on your local AI and your wiki's own meaning index — private, on your Mac, nothing sent anywhere.

  • Ghost threads. Drop a page card (or click one) and faint dashed threads reach out to the cards on the board it's semantically related to — the board telling you "these belong together." Click a ghost and it becomes a real connector; click the background and they vanish. Never saved, never in the way.
  • ✦ Suggest label. Right-click a connector ▸ ✦ Suggest label: the local model reads both cards and proposes relationship labels — supports, contradicts, elaborates on… — pick one and it's on the arrow.
  • ✦ Synthesize. Select two or more page cards (-click or -drag a lasso), right-click ▸ ✦ Synthesize — the full Synthesis engine writes a new note from exactly the cards you gathered. Read, excerpt, arrange, write: the whole research loop without leaving the board.
  • ✦ Arrange by meaning. Right-click the background ▸ ✦ Arrange by meaning: the cards glide into topic blocks, clustered by what they actually say. (Stickies and unindexed pages gather in a block of their own, and Undo arrange puts everything back where it was.)
  • Show wiki links. Right-click the board ▸ Show wiki links and faint lines appear between cards whose pages already link to each other — the knowledge structure you've built showing through the spatial layout. The read-side twin of Make real: arrows you promote into the graph, links revealed out of it.
  • From the graph. -drag a box around a neighborhood of the graph and choose Cards on a canvas… — the pages spill onto a board (new or existing) as a grid of cards, ready to arrange and connect.

Getting around

Drag the background to pan; scroll wheel pans too; +scroll (or trackpad pinch) zooms around your cursor. The zoom pill at the bottom-left does the same visually: and + step the zoom, the percentage snaps back to 100%, fits the whole board in view (also on the background's right-click menu), shows or hides the minimap, and the / toggle switches this board between the light paper ground and a dark ground — a per-canvas choice, saved with the board. The board remembers your camera position per canvas.

The minimap floats at the bottom-right: every card and frame in miniature, with a rectangle showing where you're looking. Click anywhere on it — or drag across it — and the camera goes there. On a board of ten cards it's charming; on a board of two hundred it's how you live.

Find on the board. ⌘F on a canvas searches cards: type and matching cards light up, Return glides you match to match (⇧Return goes back), Esc puts the bar away. It looks through sticky text and page names alike.

Every card is linkable. Right-click a card ▸ Copy link to card — paste that link on any page (or anywhere on your Mac) and it opens this board with the camera landing on that exact card. And every page knows where it sits: the Context palette's On boards section lists the boards holding a card of the open page, one click from prose to picture.

Good to know

  • Where does it save? A canvas is a normal page whose content is the board layout. It gets page versions, encryption, export, and travels inside your .mojopad document like any page. Cards reference pages, so a canvas adds almost nothing to file size.
  • Search finds your stickies, arrow labels, and frame titles — and page cards are found through their own pages, as always.
  • If a page on the board is deleted, its card says so — remove the card whenever you like.
  • Encrypted pages show as locked cards; unlock the page to see it on the board.
  • Big boards are fine. The canvas is engineered to stay smooth in the hundreds of cards; off-screen cards cost nothing.
  • In exports (HTML, EPUB, Word, a published site) a canvas page renders as a clean map of the board plus a list of its cards — page cards become real links to their exported pages.