Setting Up for Writing
Writing a paper, a thesis or a long report? Set up for writing arranges MojoPad for it and puts your paper at the top of the sidebar: a numbered title page and five sections, word goals, a Word file at the end. It only adds. Your pages, folders and settings stay exactly where they are, and Back to the normal layout (below) takes the setup away without removing any page. Everyone else just keeps MojoPad as it is: nothing here is needed to use it.
A new wiki starts here
The first time a new wiki opens, MojoPad asks How would you like to start? on one screen, not a series of steps.
Set up for writing builds your paper and lands you in it; Use the normal layout (or Esc) leaves you in a
blank wiki. The panel on the right, headed Your writing setup and marked Live preview, shows what you would get: its
top bar, its Contents, a sheet of your paper, a side panel, and a short list of what is set up for you. With the keyboard, press Tab to move between the buttons and Space or
Return to press one. View ▸ Set Up for Writing… is still there whenever you want it.
When you press Set up for writing, the paper is made and you land in it: the cursor is already blinking in 1 Introduction, and a short card explains how it works.
Bring your notes
Coming from somewhere else? On the same screen, Bring your notes has four ways in. Each shows what it brings and whether MojoPad found it on this Mac. Your originals are only ever read, never changed.
- Scrivener project: your chapters in the same order, with notes, labels and status. If MojoPad found a project, press Bring in; to use another, press the line that says Found 1 on this Mac and choose it. When you then press Set up for writing, the chapters become your paper's Contents. If the writing setup is already on, the main button becomes Use the draft as Contents once the draft is in: it makes no new pages, it only points Contents at the draft's chapters.
- Obsidian vault: every note and every link. Press Choose folder…, pick the vault's folder, then Bring in.
- Apple Notes: all your notes and folders. The Mac asks you once whether MojoPad may read them.
- Folder of PDFs: each PDF becomes a source you can read and highlight.
While it works, the card shows what it is reading and the button becomes Stop (what was read is kept). When it is done, the card says in one line what came in. It all lands in a new folder in your wiki; nothing already there is touched.
The AI helper
Lower on the screen, AI helper shows what MojoPad found on this Mac, with nothing to install: Claude Code if it is there, On this Mac if a model is running on your computer, and always No AI. The best one found is already chosen, and MojoPad works fully with any of the three. Looking never starts anything or asks a question of any model. Pressing one sets the same choice as Settings ▸ AI, where you can change it any time. (Because it changes every AI feature, MojoPad asks you in a small window before it switches AI off, or back on.)
Set it up on a wiki you already have
- Press Set up for writing… at the bottom of the page list, choose View ▸ Set Up for Writing… (
⇧⌥⌘D), or open Find anything (⌘K) and type writing. The button stays there after the setup is on, so you can find the way back. - The same screen opens, titled Set up this wiki for writing?. Your pages and settings stay exactly as they are.
- Press Set up for writing. A Contents section appears at the top of the sidebar, the side panel opens, and a short How this desk works card explains it once.
Changed your mind right away? Press Undo in the note that appears, or choose Edit ▸ Undo. It does exactly what Back to the normal layout does, below, and it removes no page, not even a starter page you have not written in. Setting up again later only brings things forward; it never hides or moves a page, and everything is still in the menus and in Find anything.
Back to the normal layout
Want your wiki back to a plain one? Open Set up for writing… the same way (the button at the bottom of the page
list, View ▸ Set Up for Writing…, or ⇧⌥⌘D). While the setup is on, the screen says Writing setup is on, and an outlined
Back to the normal layout button sits along the bottom of the left side, beside Close. Press it. The Contents section, the
top bar, the calm frame and the side panel the setup opened go away, and the window looks like any other wiki. If
you opened or closed the side panel yourself with View ▸ Side Panel (⌥⌘\), it stays the way you left it.
Going back removes no pages. The My paper folder and its pages stay as ordinary pages, whether you wrote in them or not, and so does everything else. Your settings and the way you arranged your window are not touched. Close the wiki and open it again and it is still plain. This works however many times you set up before.
What about the Undo note? It is the same button. An Undo note from before you went back tells you it is out of date and does nothing, so it cannot bring the setup back or take any page away. To set up again, press Set up for writing…; that makes a new paper next to the old pages, and never over them. If you want the side panel back, choose View ▸ Side Panel.
The side panel. Setting up opens the side panel (This page, Found for you, Comments) if it is shut, and going back closes it again when the setup opened it. A panel you opened yourself with View ▸ Side Panel is yours and stays open. If the setup goes some other way, such as being turned off on another Mac, the panel it opened does not stay behind. It is not the Timeline's own Page info, which has its own switch.
A wiki saved with a test version's setup
If a pre-release build arranged your wiki for another kind of work, MojoPad now opens it with the normal layout and drops that setup's record; if it included writing, you keep your paper as the writing setup. Only that arrangement changes. No page, folder, tag or setting is touched, and Set up for writing… makes a new paper beside any old one.
Writing a paper
The setup makes a My paper folder of ordinary Markdown pages, drawn clean so no # or * shows while you write: Title & summary and 1 Introduction to 5 Discussion. Bold, headings, lists, quotes, footnotes, comments and notes shown inside all work, and Show symbols at the bottom of the window lets you see the Markdown whenever you like. The sheet shows your whole paper: the section you are in is the one you write in, and the others stand above and below it, faded, each with its heading and its first words (or faint lines while it is empty). Press one to write in it; the pages stay as they are. Click the paper's title on the sheet to name it. Click a row to write in it. A dot shows where each section stands, a thin bar shows how close it is to its goal (1,200 words each; change a page's goal in the side panel), and the top of the group shows the whole paper, such as 212 of 6,000 words. Double-click the paper's name to rename it. When you are done, Make Word file in the top bar turns the sections, in order, into one Word document with a title page, footnotes and your sources. Focus beside it quiets everything but the page.
Already have long pages named Chapter 1, Chapter 2, Chapter 3? A card in the sidebar offers a writing desk that uses those pages as its sections, in order. They stay where they are.
A calm window while you write
While one of your paper's pages is in front, the window is quieter, and only for as long as you are on those pages. Nothing is hidden for good and no setting changes: it is the same app, arranged for writing.
- Across the top: the paper's name with Writer desk under it, then Focus, Make Word file
and Find anything (
⌘K). Everything else, Ask your notes included, is still in the menus and in Find anything. - Formatting: the formatting bar waits behind the small Aa button next to the paper's name. Press it to show
the bar, and again to put it away. Selecting words still brings up the little bar, and
⌘B,⌘Iand the Format menu work as always. - The sidebar is your Contents. Press All pages ▸ at the bottom to unfold the ordinary list of every page under it. Press it again to fold it away.
- The page is drawn as a sheet, with the line Paper › 1 Introduction above it, whatever Page Layout you use for other pages. The side panel opens beside it with the How this desk works card; close the panel with View ▸ Side Panel.
- The bottom line shows the words in the whole paper against its goal, such as 212 words · goal 6,000, the Clean | Show symbols switch, and a reminder that your notes stay in a folder on your Mac, which iCloud or Dropbox can sync.
Open any other page and the window goes back to the way you set it up.
What the sidebar holds
- Paper. Title & summary and your five sections, each with a dot and a thin bar for how far along it is.
- Sources. The references in your wiki. While there are none, press the dashed line to bring some in from Zotero or a .bib file.
- Ideas. Your quick thoughts from the Bucket (
⇧⌘7works in any app). Press to open them.
If you already have a wiki
After an update, a small card in the corner asks whether you would like to set up for writing. Show me opens the same window, Not now hides it (it comes back on a later launch at most twice), and Don't ask again stops it for good. Your wiki opens exactly as before either way.
A paper in five minutes, step by step
Try it with a real paper. Say you are writing a short paper on snow cover and spring floods. Here is the whole thing, start to finish.
- Choose View ▸ Set Up for Writing… (
⇧⌥⌘D) and press Set up for writing (on a brand-new wiki the first screen has the same button). - You land in 1 Introduction with the cursor blinking. A short How this desk works card sits in the side panel. Read it once and press Got it, or Keep it in Contents to keep a line for it there. It never covers your writing.
- Write a paragraph in each section. The bar beside a section fills toward its 1,200 words.
- When you are done, press Make Word file in the top bar.
- Want the plain wiki back? Open Set up for writing… again and press Back to the normal layout. Every page, written in or not, is still there.
Every way to start
- Menu: View ▸ Set Up for Writing….
- Keys:
⇧⌥⌘D. - Find anything: press
⌘Kand type writing. - New wiki: the first window asks How would you like to start?
- Wiki you already have: the Set up for writing… button at the foot of the page list, and the small corner card (below) with its Show me button.
- Long chapters you already wrote: the Writing something long? card in the sidebar (below).
The cards the setup shows once
The setup explains itself a little at a time, each card once per wiki and only when it has something to point at:
- How this desk works appears when the setup is first made. If you kept it, the ✦ How this desk works line at the foot of Contents opens it again.
- Your sources don't agree appears the first time two sources give different numbers. It is joined to the comparison, and Show me how explains it in two lines.
- Five headings: the first time a page reaches five headings, a card beside the page offers Show outline.
The offer on a wiki you already have
After an update, a small card in the bottom corner asks Set up this wiki for writing? It waits; it never opens a window by itself. Show me opens the setup window, Not now hides the card (it can come back on a later launch, at most twice), and Don't ask again stops it for good on this Mac. Whichever you press, your wiki stays exactly as it was.
If your wiki already has three or more long pages named like Chapter 1, Chapter 2, Chapter 3, a card in the sidebar asks Writing something long? Try it makes a writing desk that uses those pages, in order, as its sections. Nothing is copied and nothing is moved, and its Undo goes back to the normal layout and leaves the chapters as they were. Not now is remembered on this Mac.
Tips
- The paper is made of ordinary pages and a folder. Rename a section, add a sixth one, or move a page out; the setup follows.
- Arrange the window the way you like it, then choose View ▸ Desks ▸ Save This Setup as a Desk… to keep that arrangement under a name. That is a separate, older feature (a saved arrangement of panes), not the writing setup.
- Press All pages ▸ at the foot of the sidebar when you need the ordinary list of every page.
When things are different
- No AI set up: everything above still works. Found for you finds disagreements and surprising links by reading your words; the AI only adds a one-line reason when you have one.
- Nothing to show yet: Found for you stays quiet rather than making something up. A link is only "surprising" when two notes both name one particular page and otherwise have little in common. A page that many pages mention never counts.
- A locked page is never read for Found for you, and never shows up in it.
- You already wrote in a page the setup made: going back to the normal layout keeps it, like every other page.
Going back
- Right after you set up: press Undo in the note at the foot of the window, or choose Edit ▸ Undo.
- Later: open View ▸ Set Up for Writing… and press Back to the normal layout. No page is removed, either way.
- To just get out of the way for a while, open any page that is not in the paper: the window goes back to your own layout.
- Close the side panel with View ▸ Side Panel (
⌥⌘\); it stays closed until you open it again.