# Inkwell > An easy-to-use publishing engine that turns your manuscript into beautiful finished work ready for market. --- # Features Everything you need to move from draft to publication-ready in hours. ## Cloud-Based Collaboration Platform Features **Cloud-based**: Because Inkwell is a cloud-based application, it allows seamless switching between working on projects on your laptop, desktop, or other devices as well as seamless collaboration with others. **Browser-Native Platform**: No installations or updates are required—Inkwell runs entirely in your web browser with enterprise-grade reliability. Even if your internet goes down, you can keep working, and your project will update once you are back online. **Powerful Collaboration Features**: Inkwell collaboration tools let you invite editors and co-authors to work together in real time with tracked changes while keeping final approval and manuscript control entirely in your hands. Ownership and permissions remain in your hands. **Complete Version History**: Every change, every keystroke, is tracked so you can roll back to earlier drafts or compare revisions across collaborators. ## Editing & Integration Tools **WYSIWYG Editor**: Inkwell's WYSIWYG editor makes composition and editing easy. It is also a big deal for math equations, where there's a big difference between what an equation looks like in source (e.g., \frac{x^2}{y}) and the final product. **LaTeX Features Without LaTeX Hassles**: Things like automatic bibliographies, references to equations, figures, and index entries are directly inspired by things that were available in LaTeX, but Inkwell brings them into a WYSIWYG, avoiding LaTeX hassles. **Cross-Platform Import**: Seamlessly import manuscripts between Word, Google Docs, LaTeX, HTML, ePub, and Inkwell while preserving formatting and notation. **Compatibility with Tools like Quillbot and Grammarly**: These tools typically work with integrated software packages like Word but not with text editors that you would typically use to edit Markdown/LaTeX. **AI Copyeditor**: An AI copyeditor that analyzes your text for clarity, grammar, and flow—offering multiple improved versions of each sentence with adjustable tone and review intensity. Unlike tools that simply fix your writing, every suggestion includes a clear explanation that teaches you how to write better. Edits become lessons, and your skills grow with every draft. **AI Agent**: Tell the agent what you want in your own words—carry a renamed character through every chapter, audit the manuscript for something you suspect is inconsistent, draft a first pass at the index—and it reads the book, works out what you meant, and does it. Ask it a question instead and it answers without touching a word. Everything it changes lands as a tracked edit for you to accept or revert. ## Mathematical & Scientific Notation **Flexible Math Editor**: Authors uncomfortable with LaTeX can produce precise equations using a clean point-and-click visual editor; authors comfortable with LaTeX can enter LaTeX commands directly. **Universal Math Notation Editor**: Inkwell seamlessly renders equations and formulas whether typed with its visual editor, entered in LaTeX, or pasted directly from sources like ChatGPT, Grok, or Wikipedia—making it a truly universal solution for mathematical writing. **SVG-Based STEM Notation for eBooks**: All equations and formulae render crisply and responsively in ePub readers through automatic SVG conversion (SVG = scalable vector graphics). ## Publishing & Export Capabilities **Synchronized ePub and PDF**: The same document flows neatly into both eBook and PDF formats. **Real-Time PDF Preview**: Instantly see how your book or article will look in print with a live typeset preview that updates as you write and edit. **Getting ePub Right**: Equations converted into images, print page numbers embedded into the ePub, clickable links, images compressed appropriately, fonts subsetted. **One-Click Publishing Readiness**: Generate distribution-ready files for publishing platforms such as Amazon and Ingram without manual intervention or post-processing. Inkwell ensures the compatibility of our input with the requirements of these platforms. **Multi-Format Export**: Beyond PDF and ePub, export your project to HTML, Word, and LaTeX for academic or custom publishing workflows. **Backup and Archival Format**: All projects can be downloaded in the portable .inkwell format, ensuring long-term preservation and recovery of your work. ## Document Structure & Layout **Effective Chapter Management**: Inkwell builds its interface around chapters, making it easy to manage document divisions without juggling multiple files. **Flexible Typesetting Parameters**: Support for any desired trim sizes, margins, font types, font sizes, etc., making your content adaptable for any way you wish to publish in paperback, hardcover, and digital formats. **Smart Layout Engine**: Automatically balances spacing, margins, and pagination for a clean, elegant reading experience without requiring manual tweaks. ## Intelligent Reference & Navigation Tools **AI Based Index Generation**: Inkwell uses artificial intelligence to create an index based on semantic importance of words in a text. **Index and Table of Contents Linking**: Interactive TOCs and live index entries are automatically linked to their content within a given project. In particular, the index automatically updates as pagination changes under edits, allowing for easily updated editions of a project. **Dual-Tiered Reference Notes**: Inkwell allows separate sets of reference notes, such as footnotes for an author and endnotes for a commentator. This can be especially helpful for republishing critical editions of older books. **Automated Citations and References**: Built-in citation manager allows footnotes, endnotes, and bibliographic styles to be updated automatically, supporting manual citations as well as Zotero and Mendeley. --- # Pricing ## Starter Plan **Price**: $9.95/month **Features**: - 10 Collaborators per Project - Full Feature Access - 2,000 Inkdrops per Month - AI Agent ## Standard Plan **Price**: $14.95/month **Features**: - 10 Collaborators per Project - Full Feature Access - 4,000 Inkdrops per Month - AI Agent - Use Your Own AI Key & Assistants ## Professional Plan **Price**: $19.95/month **Features**: - Unlimited Collaborators per Project - Full Feature Access - 6,000 Inkdrops per Month - AI Agent - Use Your Own AI Key & Assistants --- # FAQ ## How do I submit my manuscript to Inkwell Press? Upload your manuscript on inkwell.net and review our standards at studio.inkwell.net. When you're ready, submit it by adding one of our team as a collaborator (requires a paid account). If we accept your manuscript, we'll waive the $5,000 Studio fee and publish your book for free. ## How does the 7-day free trial and 2 months free work? For monthly subscriptions, you get a 7-day free trial to explore all features. After 7 days, your subscription begins and you'll be charged each month. For yearly subscriptions, you save 2 months—instead of paying for 12 months, you only pay for 10 months upfront and get access for the full year. ## What payment methods do you accept? We accept all major credit cards. ## Can I cancel my subscription anytime? Yes, you can cancel at any time, and your plan will remain active until the end of your billing cycle. ## What are inkdrops? Inkdrops are the allowance your plan includes for Inkwell's AI tools. Heavier work spends more of them—looking up a citation costs a fraction of an inkdrop, copyediting a chapter a few, indexing a whole book a good deal more. Your monthly inkdrops refill at the start of every month, and you can see how many are left under My Account. If you need more, you can buy extra inkdrops on any paid plan; bought inkdrops never expire and are only spent once the month's run out. If you run out altogether, the AI tools pause until your inkdrops refill, and the rest of Inkwell is unaffected. On the Standard plan and above, work run on your own OpenAI or Anthropic key is billed by that provider and spends no inkdrops at all. ## Who is eligible for the students and faculty discount? Anyone with an education or academic email address (.edu or similar academic domains) automatically qualifies for a 50% discount on the Starter plan. Standard and Professional are full price for everyone. ## How do I apply the students and faculty discount? The discount is applied automatically during checkout when you sign up for the Starter plan with your academic email. You'll see the 50% discount reflected in your final price before completing your purchase. ## What features are included in each pricing plan? All Inkwell pricing plans include access to every premium feature on the platform. The only difference between plans is how much ink they include each month—the allowance the AI tools spend. Regardless of your choice of plan, you get the complete set of writing, research, and collaboration tools. Visit our features page to explore everything Inkwell has to offer. --- # Tutorials ## Tutorial: Getting Started ### Signing In **Signing In**: The first step to using Inkwell is to sign in. Go to inkwell.net and click Get Started — or, if you are already on a page with the sign-in box, use the box directly. There is no separate "create an account" step: signing in for the first time creates your account. **Two ways to sign in**: With Google. Click Get Started or Sign In with Google to use an existing Google account. Nothing else is needed — you are signed in immediately. With an email address. Type your address into the box and click Get Started or Sign In. Inkwell does not use passwords; instead it emails you a one-time sign-in link. Open the email and click Sign In. If the button does not work in your mail client, the same link is printed underneath so you can copy and paste it. Each link can only be used once. If you sign in again, or on a different computer, just enter your address again to get a fresh link. Re-using an old link shows a message asking you to request a new one. Either one reaches the same account. The two methods are interchangeable so long as the address is the same — sign in with Google one day and the email link the next, and you land in the same place with the same projects. What matters is the address itself. Inkwell has no way to know that two different addresses belong to the same person, so signing in with a second one gives you a second, empty account rather than your projects. If your projects are not where you expect them, that is almost always the reason: sign out and sign back in with the address you first used. The first time you sign in, Inkwell asks for your name and whether you would like the newsletter, then takes you to your projects. **Finding your way around**: Once you are signed in you land on your list of projects. Two things are worth knowing straight away: A short guided tour starts automatically the first time you see the projects list, again the first time you open the editor, and once more the first time you open the Users panel. You can leave any of them at any point with Skip. To replay them, use Take the tour in the account menu — it appears there while you are on your projects list or inside a project, replays whichever tour belongs to the page you are on, and arms the Users one again for the next time you open that panel. The left rail inside a project has a Tutorial button, which opens this tutorial in a new tab, and a Provide Feedback button for reporting problems. **Light and dark**: The sun/moon button in the header switches between the light and dark themes. It works on every page of the site, including this tutorial, and your choice is remembered on that browser — pages you open later come up in the theme you picked rather than flashing white first. If you have never touched the button, Inkwell follows whatever your operating system is set to. ### Prepare Your Document for Importing into Inkwell **Prepare Your Document for Importing into Inkwell**: Your manuscript is ready to be imported into Inkwell for formatting. Congratulations! We can help to get you ready to publish your work. As authors ourselves, we know how exciting that can be. Inkwell imports Word, ODT, LaTeX, Markdown, ePub, RTF, plain text, and USFM. Word is much the most common, so this chapter walks through preparing a Word document — but the principle applies to all of them: structure the document with real styles rather than manual formatting, and the import will carry that structure across. If you are typesetting scripture, your text is probably already in USFM, the format Paratext and other translation projects use. None of the Word preparation below applies: import the .usfm files as they are. The markers already say what each piece of text is, so chapter and verse numbers, poetry lines and translator's notes all come across intact. See Chapter And Verse. **Save a New Version of Your Document in Word**: It may make sense for you to save a new version of your document in Word before proceeding with the import into Inkwell, especially if you have special formatting features, custom styles, complicated mathematical formulas, or very large images. To save a new version, click on File, Save As, rename your document, set the file format to Word Document (\.docx) if it’s not already, then click the Save button. Your original file will remain unchanged, and you will be working with a new version that you will use during the import process. Now, let’s move forward with getting your document ready for importing. **Word’s Formatting Features**: There are a few features in Word that we will enable in preparation for your import. First, let’s turn on the Navigation Panel. To do that, click view in the top menu, then make sure the option for Navigation Pane is checked. This will display a navigation menu on the left side of the screen that shows all chapter and sectizon titles within your document. This allows you to easily jump around within your document. The second feature that’s really helpful is the Show Paragraphs Mark button. To toggle this feature on, go to the Home menu, then click the Paragraphs icon, located in the Paragraphs section of the top menu. This feature allows you to see all of the formatting marks within your document. **Table of Contents**: Inkwell will automatically build a table of contents for your project that is optimized for publishing in both print copy and ePub versions, so there is no need to import a table of contents. If you have already built a table of contents, you can go ahead and delete it from the Word document. **Other Front Matter**: Inkwell will also automatically create a title page and copyright page, so there is no need to import them into Inkwell. **Chapter Breaks**: To ensure that chapters import correctly into Inkwell, it is important to make sure that chapter titles and section headers are styled correctly in Word. The preferred way to signal to Inkwell that you’re beginning a new chapter is to style the chapter title as Heading 1 in the styles menu in Word. Likewise, section headers should be styled as Heading 2, subsections should be styled as Heading 3, etc. If the only Heading 1 in the document is the book's own title, Inkwell leaves it out — the project already has a title — and starts chapters at Heading 2 instead. If your book is divided into parts, style each part title one level above its chapters — Part as Heading 1 and its chapters as Heading 2, say — and start the title with Part, Book or Volume. Each becomes a part in Inkwell, with its chapters after it. A part title worded differently comes in as an ordinary chapter, and you can turn it into a part afterwards; see Chapter Titles, Parts, and Section Headings. **Footnotes, images, and equations**: These come across on their own and do not need preparing: Footnotes made with Word's footnote feature import as Inkwell footnotes. Footnotes typed by hand as superscript numbers with text at the foot of the page do not — Inkwell has no way to tell them apart from ordinary text. Images are imported with the document. Very large images make the import slow; if the file is unwieldy, compressing the images in Word first is worth the time. Equations written with Word's equation editor import as editable mathematics. Equations pasted in as pictures stay pictures. LaTeX citations do not become Inkwell citations, because the details of each work are in a separate .bib file, or in free-form text. Each \cite comes across as its key in square brackets, with any page reference, such as [smith2001, p. 3]. If your file has its own thebibliography list, each entry starts with the same key, so you can match them up. To finish the job, replace each bracketed key with a real citation using Insert Citation; see Citations and Bibliography. **What to check afterwards**: After importing, look at the chapter list first: if chapters have not split where you expected, the headings were not styled as headings. It is usually quicker to fix the styling in Word and import again than to fix the structure inside Inkwell. That’s it — your document is ready to import. See Creating a New Project for the import itself. ### Creating a New Project **Creating a New Project**: Click New Project at the top of your projects list. (A connected AI assistant can start one for you instead — see [Letting an assistant start a project](agent.mdletting-an-assistant-start-a-project).) **Title and kind**: Give the project a Title — you can change it later — and choose a Kind: Note — a single piece of writing with no chapter structure. Article — divided into sections, for papers and essays. Book — divided into chapters, with front and back matter. The kind decides the vocabulary used throughout the editor and which structural features are available, so pick the one that matches what you are writing. **Template**: Select beside Template opens the template picker. A template supplies the page size, fonts, heading styles, and standard front and back matter — it is the difference between a manuscript that looks typeset and one that does not. You can change the template later, so this is not a decision you have to get right now. See Templates and Boilerplate. **Tags**: Type a tag into Tags and press Enter to turn it into a chip; the × on a chip removes it again. Add as many as you like. As you type, Inkwell offers the tags you have already used on other projects. Take the suggestion when it fits — tag:draft will not find a project you tagged "drafts", so tags are only useful as long as the same thing keeps the same name. You can tag a project at any time from the projects list instead, and change these tags later — see Managing Your Projects. **Starting from scratch**: To write everything in Inkwell, leave Content empty and click Start. **Starting from existing files**: If you already have a draft, Import Document brings it in. The button offers four sources: Upload File — a file from your computer: Word, ODT, LaTeX, Markdown, ePub, RTF, plain text, or an .inkwell backup. Import from Google Docs — pick a document straight from Google Drive. Import from Inkwell — copy another of your projects. See Copying a project. Import from Template — a chapter out of one of the templates. Click Import Document as many times as you need; each file becomes a chapter. If you upload a single file, Inkwell splits it into chapters at its headings and shows you what it found, so a whole book in one Word file or ePub arrives correctly divided. Headings named Part, Book or Volume that have chapters under them become parts, with their chapters after them. The red X beside a chapter removes it from the list. When the chapter list looks right, click Start. How you format the original document makes a large difference to how well this works — see Prepare Your Document for Importing into Inkwell before importing anything substantial. **Copying a project**: To start a new project as a copy of one you already have — a translation, a second edition, a version for a different publisher — click Import Document → Import from Inkwell and pick the project to copy. Its chapters arrive in the list, and when you click Start the new project also takes the original's settings: fonts, page size, styles, headers and footers, and the rest of Project Settings. The original is not changed. An .inkwell backup (see Publishing) works the same way: bring it in with Import Document → Upload File and the new project is built from it, settings included. ### Managing Your Projects **Managing Your Projects**: Everything you write in Inkwell lives in a project — a book, an article, or a note. Your projects list is the first thing you see after signing in, and you can always get back to it with the arrow at the top left of the editor or via My Projects in the account menu. Click a project's title to open it. **Starring and ordering**: The star at the far left of each row marks a project as a favourite. Starred projects sort to the top of the default view, which is otherwise ordered by how recently you opened each project. Click any column heading — Title, Author, Kind, or the date column — to sort by it instead; click again to reverse the order. The date column itself is configurable. Click the small caret in its heading to choose what it shows: Created — when the project was made Last Edit — the most recent edit by anyone My Last Edit — the most recent edit by you Last Opened — when you last opened it Your choice is remembered. **Tags**: The Tags column is editable in place. Click into it, type a tag, and press Enter — the tag becomes a chip with an × for removing it again. A project can carry as many tags as you like. Tags are a good way to group projects belonging to the same series, client, or course, and they can be searched (see below). A project's tags belong to the project, so everyone it is shared with sees the same ones. On a project shared with you to read or comment on, the tags are shown but can't be changed. You can also tag a project as you create it — see Creating a New Project. **Searching**: The search box above the list narrows it as you type. As well as plain text, it understands a small query language: Query Finds whale anything matching "whale" title:whale projects whose title matches author:melville projects whose author matches tag:draft projects carrying that tag kind:book projects of that kind (book, article, or note) These can be combined with AND, OR, and NOT — for example kind:article AND NOT tag:submitted. **Removing a project**: To remove a project from your account, click the red X at the end of its row. Inkwell first shows you everyone who currently has access, because what happens next depends on who else administers the project. If other administrators remain, the project is only removed from your account. They keep working on it as before. If you are the sole administrator, removing it deletes the project from Inkwell entirely, and everyone else listed loses access — including collaborators who are not administrators. The dialog says which of the two applies before you confirm, so read it before clicking Yes, Remove This Project. Either way, any AI assistant you had connected to the project loses it at the same moment you do — see Connecting an AI assistant. The same is true if an administrator removes you from someone else's project. **If a project won't finish opening**: Inkwell keeps a copy of your work in your browser so that projects open quickly and keep working when your connection does not. Opening a project normally takes a moment on the Loading Your Book screen while that copy is checked and brought up to date. If it stays there, the screen offers you a way out rather than leaving you to wait: After a few seconds, a Reload button appears. Most slow opens are an unhappy connection, and reloading is enough. If it is still stuck after that, a Reset local data and reload button appears. This clears Inkwell's browser-side copy and downloads everything again from scratch. Resetting is safe: your project lives on Inkwell's servers, and clearing the local copy does not touch it. The one thing that cannot be recovered is an edit you made while offline that had not yet synced — so if you have been writing without a connection, try Reload first and give it a moment to catch up before resetting. ### Your Account and Plan **Your Account and Plan**: My Account in the top-right menu is where your identity, plan, billing, and AI key settings live. **Identity**: Your Email is fixed — it is the address you sign in with. Name is editable, and it is the name collaborators see next to your edits and comments. Upload picture sets the picture shown beside your name in the top-right menu and on your comments. Any common image format works; Inkwell crops it to a square around its centre of interest. Change picture replaces it and Remove clears it. If you sign in with Google, your Google picture is used until you upload your own. **Plan and usage**: The Plan card shows which plan you are on, whether it is Active or Cancelling, and how much of it you have used. Inkdrops are the only thing a plan meters, shown as used / allowed this month. A paid plan does not cap how many projects you keep or how much you store. Inkdrops are the allowance your plan includes for the AI tools. They refill at the start of every month, and they are spent rather than occupied — a heavier job, like indexing a whole book, uses more of them than a quick citation lookup. Every plan has a monthly ceiling, including beta and trial accounts. The one exception is a free trial you signed up for without a credit card, such as the academic trial: its inkdrops are a single allowance for the whole trial, shown as used / allowed for your trial, and they do not refill. The ? beside the count explains more, and AI Tools covers what spends them and what happens when you run out. Inkwell's plans run from Free upward through Starter, Standard and Professional. Every paid plan includes the agent. Starter and Standard allow 10 collaborators on each project and Professional allows any number. Each step raises the monthly inkdrop allowance, and from Standard up you can also use your own AI key and connect an AI assistant such as Claude, ChatGPT, Grok or Gemini — which may need a plan with that assistant too; see Connecting an AI assistant. The current prices are on the pricing page. If you have credit on your account, from a referral or otherwise, the card shows how much comes off your next bill. From this card you can: Upgrade Plan — move to a plan with a larger inkdrop allowance. Buy Inkdrops — on a paid plan, buy a pack of extra inkdrops. Packs come in 1,000, 5,000 and 10,000, and checkout happens on Stripe's payment page, which returns you to the page you bought from. Bought inkdrops never expire and are only spent once the month's inkdrops are gone; the Usage section shows how many you have left once you have some. Update Payment — change the card on file. Billing History — open Stripe's billing page, which lists your past invoices and receipts, including inkdrop packs, with a PDF of each to download. Plan changes and cancellation stay on the Plan card. Cancel Plan — stop the subscription. The plan stays active until the end of the period you have paid for, and the card shows a Cancelling badge until then. Renew Plan — appears once you have cancelled, and undoes the cancellation. Projects of your own need a paid plan. On the free plan you cannot create one, and any you already own stay readable and exportable but not editable — Inkwell shows a banner on those projects with a shortcut to change your plan. A project someone else has shared with you is not affected by your plan. Your role on it is what decides what you can do there, so you can edit someone's manuscript on the free plan if they have invited you as an editor. **Free trials**: Some sign-up pages, such as the free trial and the academic trial, start you on a month of Inkwell with no credit card. Sign in from that page, with Google or with your email address, and the trial starts as your account is created. A welcome email confirms it. During the trial the Plan card shows the trial's name and the date it expires. You can create projects, use the agent, and use your own AI key or connect an AI assistant, as on Standard. The trial includes 2,000 inkdrops for the whole month, not 2,000 a month. When it expires you move to the free plan, and you can choose a plan from this page to carry on. Each account gets one free trial. Signing in from a trial page with an account that has already had one, or that is on a paid plan, leaves your plan as it is. **Coupons and discounts**: Apply Coupon takes a code and applies it to your subscription. Educational addresses also get 50% off the Starter plan — see the pricing page for how to claim it. The discount does not apply to Standard or Professional. **Referring other writers**: Refer a Writer holds your referral link, with a Copy button. Refer a writer: get a month free in the top-right menu brings you straight to it. The link opens Inkwell's home page; share it however you like. A writer who signs up through your link gets a 30-day free trial of whichever plan they choose, instead of the usual 7 days. When their trial ends and they make their first payment, you get a month of your own plan as credit, and an email saying so. The credit comes off your next bill. If you are on the free plan, it is a month of Starter, and it waits until you subscribe. The credit is never more than the writer you referred actually paid. Inviting a collaborator counts too: if the person you invite is new to Inkwell, they get the same 30-day trial and you get the same month when they subscribe. Under your link, the card counts how many writers you referred have subscribed and how many months you have earned. You can earn up to 12 months in any year. After that, referrals still count but earn no more credit. **Using your own AI key**: Inkwell's AI features can run on OpenAI, Anthropic, Google Gemini or xAI. AI Provider Keys lists all four, and each row lets you supply your own key so that AI usage is billed to that account instead of Inkwell's. By default no key is saved and the AI features use Inkwell's key. Your own key needs the Standard plan or higher. On a plan without it, the card says so and lets you remove a key saved earlier, but not add one; a saved key is kept, unused, and comes back into use if you move to a plan that includes it. Whichever key you save is the one your AI features use. Save an Anthropic key and features like citation lookup run on Anthropic's models; save a Google Gemini key and they run on Gemini's. If you save more than one, Inkwell prefers them in this order: OpenAI, then Anthropic, then Google Gemini, then xAI. The agent is the exception, and prefers Anthropic. Not every provider covers every tool. OpenAI, Anthropic and Google Gemini cover all of them, the Agent included — which matters, since everything on the AI menu runs through the Agent. xAI covers the Agent too, but has no model cheap enough for the small, high-volume jobs, so citation lookup and equation conversion keep running on Inkwell's key. Cover art is covered by OpenAI alone: with any other key, the art in the cover designer is painted on Inkwell's key. Whatever still runs on Inkwell's key still spends inkdrops. Each row shows the last four characters of the saved key so you can tell which one is in place. Your key is encrypted and is never shown back to you in full, so replacing a key means pasting the whole new one. Remove deletes it and returns you to Inkwell's key. Supplying a key changes only who pays for AI usage. That work is billed to your provider account rather than drawn from your inkdrops, so a saved key leaves most of your monthly allowance untouched — and the tools it covers keep working once your inkdrops run out. **Publisher submission links**: If you take submissions from other writers, Submit Links lets you create a public link that opens a pre-configured new project on the submitter's account: you choose the kind, name, logo, message, template, tags, and the role the author gets, and can mark a link as single-use. Submissions arrive back in your own projects list. ## Tutorial: Writing ### Book and Article Titles **Book and Article Titles**: Every project has a Book Details page (Article Details for articles), reached from the top of the chapter list under Front Matter. This is where the title-page information lives. Each entry here is a variable — a named piece of information that the template drops into the title page, running heads, and the ePub metadata. Which variables appear by default depends on the template you chose; a typical book starts with Title, Short Title, and Author. **Authors and editors**: Author is a list, not a single field. Click Add Author for each additional author; use the red × beside a name to remove it. If your template includes editors, an Editor list works the same way, with its own Add Editor button. The caret beside each name opens that person's detail fields, so a name can carry more than just its display form where the template needs it. **Adding your own variables**: Click Add Variable, give it a name, and click Create. The new variable appears in the list with its own text box. This page is where a variable comes into being. A name that is not here yet cannot be dropped into the text, so start here and then go and use it. Custom variables are useful for anything the template does not already cover — a series name, a volume number, an ISBN, a dedication, an epigraph. Once defined, a variable can be dropped anywhere in the text with Insert → Variable on the toolbar — switch on Tools → Boilerplate if you do not see it — or into headers and footers when you edit the header template, so you only have to type the value once. Inkwell will not let you reuse a name it already fills in itself. Book Title, Chapter Title, Part Title and Page Number belong to running heads and margin marks, and the author fields come from the Author list above rather than from a variable. **Variables in the text**: A variable in the text is a chip: a single object with a dashed border, not editable text. Click it and it is selected whole — type to replace it with your own words, or press Backspace to remove it. Its name is not something you can edit where it sits; to use a different variable, click the chip and pick one from Insert → Variable. That is deliberate. The chip shows the variable's name, which sits where the reader will eventually see its value, and typing over a name rather than replacing the chip is an easy mistake to make and a quiet one to live with — the renamed variable simply has no value, and whatever you typed never reaches the page. **Formatting a variable's value**: A variable's text box takes bold, italic, and other inline formatting, and Shift+Enter starts a new line within it — useful for a Keywords or Abstract field where each entry should sit on its own line, since a plain Enter cannot split the box into paragraphs. Paragraph-level style — alignment, spacing, indent — is not part of the variable's value, so it cannot be set from this page: whatever a variable is dropped into elsewhere in the template controls that. To change how the Abstract prints, for example, click into the paragraph holding its chip in the Abstract chapter and set the style there; it will apply to every article built from this template, not just the current one. **Removing a variable**: Each variable has an X button beside its label. It is disabled while the variable is still used somewhere — in a chapter, or in a running head or margin mark — and hovering over it tells you so ("Used in the document — remove it from the document first"). Remove the usages first, then the variable. **Where this information ends up**: Everything on this page feeds the built book: the title page as laid out by the template, running heads that reference the short title or author, and the metadata embedded in the ePub so that e-readers and stores show the right title and author. ### Managing Chapters **Managing Chapters**: The list down the left of the editor is your project's structure. Click any entry to open it. If the list is hidden, bring it back with the Chapters button on the left rail: If you are working on an article rather than a book, the same list shows sections instead of chapters. The rest of this tutorial says "chapter"; read "section" for articles. The list is divided into Front Matter, Body, Appendices, and Back Matter, with the details page (and the template page, when that is switched on) pinned at the top. The Appendices heading appears once the project has an appendix in it. Only chapters under Body (and appendices) are numbered. The table of contents can sit in Front Matter or at the top of Body; either way, the chapters below the Body heading are numbered. **Inserting a chapter**: Click Insert at the bottom of the list. The menu is in three groups. New content Blank Chapter — an empty chapter. New Part — a part divider, for grouping chapters into Part I, Part II, and so on. See Chapter Titles, Parts, and Section Headings. New Page — a standalone page, for front matter such as a dedication. New Appendix — an appendix, added to the Appendices section after the body. See Chapter Titles, Parts, and Section Headings. New content lands directly after the chapter you have open, so you add a chapter where you are working rather than at the far end of the list. If what you have open belongs somewhere else — you ask for an appendix while reading a body chapter, or have a generated section such as the table of contents open — the new chapter goes to the end of its own section instead. Import Upload File — bring in a Word, LaTeX, Markdown, ODT, ePub, RTF, or plain-text file, or chapters from an .inkwell backup. Import from Google Docs — pick a document straight from Google Drive. Import from Inkwell — copy chapters out of another of your projects. Import from Template — copy a chapter out of one of the templates. Importing from another project or a backup brings in its chapters only; this project keeps its own settings. To copy a whole project, settings and all, start a new one from it — see Copying a project. Generated sections. These build themselves from the rest of the book, so you add them once and Inkwell keeps them up to date: Index — see Index. Bibliography — every work you have cited. Notes — the endnotes section. Annotations — the second, independent family of notes; see Annotations. Table of Contents — see Table of Contents. List of Figures — every captioned figure, with its page number. At the bottom of the menu, Restore Chapter brings back a chapter you deleted earlier. **The chapter menu**: Point at a chapter in the list and a ⋯ button appears at the right of its row (on a touchscreen it is always there): Click it for that chapter's menu. Right-clicking the row opens the same menu where you clicked, and so does the context-menu key (or Shift+F10) on a row you have tabbed to: Duplicate — makes a copy titled "Copy of …", directly after the original, and opens it. Move Up / Move Down and Move to — see Reordering. Scratch — a tick here keeps the chapter out of the built book; click again to put it back. It is the same setting as Scratch in Local Settings, so the two always agree. Remove… — asks first, then takes the chapter out of the project. Undo on the message that follows puts it straight back; later, Insert → Restore Chapter does the same. Generated sections such as the table of contents or the index offer only the moves and Remove…: they build themselves from the rest of the book, so there is nothing to copy and nothing to leave out. None of the menu is offered to collaborators who can only read or comment. **Duplicating**: A copy is a new chapter with the same text, and starts out marked not started. It keeps: its footnotes and annotations; its index entries, so until you change or remove one of the two chapters the index lists both; its citations and figures; its Local Settings, including whether it is in the scratchpad, except two: a Custom Number is cleared, so the number is not printed twice, and Boilerplate is switched off, since the copy is your own text rather than the template's. A Navigation Label gets the same "Copy of" in front as the title. Cross-references are kept working: a reference in the copy to a heading, figure, table, note or callout in the same chapter points at the copy's own one, while references from the rest of the book carry on pointing at the original. A copy does not take the original's comments or its tracked-change history with it. Any changes still waiting for review are copied as they stand — insertions kept, deletions gone — and the copy arrives as a brand-new chapter of yours, the way an imported one does. **Splitting a chapter**: To break a long chapter in two — typically one that arrived from an import with several chapters run together — put the cursor where the new chapter should begin and choose Insert → Split Chapter Here from the editor toolbar. Everything from the cursor on moves into a new chapter directly after this one, titled Untitled Chapter, and Inkwell opens it so you can give it a title and carry on splitting. Where the cut falls: In the middle of a paragraph or heading, that paragraph is cut in two at the cursor. At the start of one, the whole paragraph moves; at its end, it stays. Inside a list, table, callout or quotation, the whole of it moves — half a table is not a thing. It is greyed out in the title, in the chapter's Short Title, Subtitle or Author line, and at the very end of the chapter, where there would be nothing to move. The moved text keeps its footnotes, figures, citations and index entries, and cross-references to it from anywhere in the book still find it. Comments on it do not come along. Undo on the notice that appears puts the text back on the end of the original chapter and takes the new one out of the book — including anything you have typed into it since. The ordinary undo (Ctrl+Z) does not reverse a split. **Reordering**: Drag a chapter up or down to reorder it, including across the Front Matter / Body / Appendices / Back Matter boundaries — dropping a chapter under Back Matter moves it there, and dropping one under Appendices turns it into an appendix, lettered with the rest. While you drag, the chapter follows the pointer up and down the list, and a gap opens where it will land. Press Escape (or let go outside the list) to cancel the move. The chapter menu does the same without dragging: Move Up and Move Down swap the chapter with its neighbour. They stop at the edge of its section, so they are greyed out on the first and last chapter there. Move to sends it to the end of another section — Front Matter, Body, Appendices or Back Matter (for an article, Content, Appendices or Back Matter). Moving a chapter to Appendices turns it into an appendix, just as dropping it there does, and adds the Appendices heading if the project has none yet. **Chapter markers**: Chapters carry small icons that tell you something about them at a glance: Status — a button on the right that cycles through three states as you click it: not started, done, and needs attention. Use them however suits your process — drafting progress, proofreading passes, or flagging problems. Collaborators with the Read role see the status but cannot change it. Reviewing — replaces the status button while a chapter is under review. Boilerplate — marks a chapter that came from the template and is managed by it. Scratchpad — marks a chapter excluded from the built book, useful for notes and offcuts you want to keep but not publish. Unavailable — marks a chapter Inkwell cannot find, shown greyed out and in italics. Both Boilerplate and Scratchpad are switched on per chapter in Local Settings (see Local Settings); Scratchpad can also be toggled with Scratch in the chapter's menu. **Unavailable chapters**: Very occasionally a chapter appears in the list as Unavailable, greyed out and marked with a question mark. This means the entry exists but the chapter behind it does not, which almost always comes from a new chapter that was interrupted — the page reloaded, or the browser was closed, in the moment between clicking Insert and the new chapter reaching Inkwell's servers. A chapter is created the first time something is written to it, so one that was cut off that early was never created at all. An unavailable chapter is empty and read-only, and nothing further can be recovered from it. The rest of the project is unaffected: open it and the entry is simply blank. Remove it with Remove… from the ⋯ menu on its row (see The chapter menu) and add the chapter again. If a collaborator created the chapter and their browser still holds it, it can also reappear on its own once their copy of Inkwell finishes sending it — so if you know someone else added it moments ago, it is worth waiting before deleting the entry. ### Chapter Titles, Parts, and Section Headings **Chapter Titles, Parts, and Section Headings**: Inkwell has five levels of heading: Part Title, Chapter Title, Section, Subsection, and Subsubsection. (In an article they are named for sections rather than chapters, but they work identically.) **Applying a heading**: Headings are paragraph styles. Put the cursor in the paragraph and pick the level from the style dropdown: From the keyboard, Ctrl-Alt-1, Ctrl-Alt-2, and Ctrl-Alt-3 apply Section, Subsection, and Subsubsection. Typing , , or at the start of a line does the same thing. **Parts**: A part groups chapters — Part I, Part II, and so on. Click Insert at the bottom of the chapter list and choose New Part. Give it a title. Books use various words for this division — Part, Section, Book, Act, Volume, Arc — and the template decides which one is printed. Drag it in the chapter list to sit before the chapters it covers. **Appendices**: An appendix is supporting material that follows the body — a questionnaire, a proof, a table of raw data. Click Insert at the bottom of the chapter list and choose New Appendix. It is added under Appendices, between the body and back matter. An existing chapter becomes an appendix by dragging it under Appendices in the chapter list. Appendices are lettered rather than numbered, so the first prints as "Appendix A", the next as "Appendix B". Figures, tables, and equations inside an appendix take that letter too — Figure A.1, Figure A.2, then Figure B.1 in the next one. Refer to one from your prose the way you refer to a chapter: type Appendix and pick it from the list that appears. See Keyboard Shortcuts. Project Settings → Appendices controls the lettering: whether appendices are numbered at all, the scheme (A, B, C by default, but Roman numerals and the rest are there), the word printed before the letter, the separator after it, and the word used in the table of contents. Change Label to "Annex" and that becomes the word you type to reference one, too. If you built appendices the old way — an ordinary back-matter chapter with a Custom Number of "Appendix A" typed in by hand — they still print exactly as they did. Nothing is moved for you. To pick up the automatic lettering, drag them under Appendices and clear the custom number. An existing chapter can be turned into a part instead: select it and switch on Part in Local Settings → Chapter. **Heading settings**: Click Project Settings , then Headings. Each level has its own subsection. For each level you can set: Numbered — whether the heading carries a number at all. Numbering — the format of that number: numerals, letters, roman numerals, words, and so on. Include Chapter Number Prefix — whether the number carries the number above it, so that a section reads 3.2 rather than just 2. At Chapter Title level the number it picks up is the part's, giving chapters 1.1, 1.2, then 2.1 in the next part. Balance Lines — what happens when a heading is too long for one line. With Auto, the default, a centred heading is set in as few lines as it needs, made as even as possible, so it never ends on a line holding one or two words. Where it can, the break falls after a comma, colon or dash rather than mid-phrase, and never after an initial. Always does the same for headings of any alignment; Never fills each line before starting the next. A heading you break yourself with Shift-Enter keeps your break. The chapter headings in a Notes section have the same setting, under Chapter Headings; being centred, they are balanced unless you change it. Uppercase, beside Small Caps with the font controls — prints the heading in capitals, as in 1. INTRODUCTION, while you type it as Introduction. Only the heading itself changes: the table of contents, running heads and the chapter list keep the title as you typed it. To have the contents entries in capitals as well, give the title in the contents template a style with Uppercase on — see Table of Contents. Part Title also carries Restart chapter numbering under each part, for books where each part begins again at Chapter 1. The chapter-level prefix depends on it: a chapter counter that runs straight through the parts would read 1.1, 1.2, 2.3, 2.4, so with the restart switched off the prefix is ignored and chapters number plainly. A chapter that sits before the first part, or under a part with no number of its own, also numbers plainly. Sections, figures, tables and the rest take their prefix from the chapter number as printed, so a 1.1 chapter holds section 1.1.1 and Figure 1.1.1. **Changing how a heading is laid out**: Each heading is laid out with a visual template editor. In each heading's settings you will find two buttons: Edit Template — opens an editable model of the heading, which you lay out directly. This is where you decide whether the number sits on its own line above the title or runs inline with it, what text appears around it, and how each piece is styled. Because it is a real editor, you can put anything in it, not only a fixed set of combinations. A chapter title's template can also place the chapter's Subtitle and Author (from Insert → Document Property), which the default layout leaves out; a line holding one drops out in chapters that lack it. The same goes for the number: in a chapter with no number — front or back matter, or one with Hide Number — a line holding only the number is left out, spacing and all. Revert Template — discards your customisations and restores the template's default layout for that heading. It asks for confirmation first. To style a line of the template — centre the title, say, or space it further from the number — put the cursor in that line and open the Paragraph section of Local Settings, exactly as you would for a paragraph of text. The buttons are in Project Settings → Headings for every heading of that kind, and in Local Settings, under Heading, when the cursor is in a heading — a template edited there applies to that heading alone. The same editor is used for the table of contents, the list of figures, and running heads and feet. **Per-chapter overrides**: Individual chapters can depart from the defaults through Local Settings → Chapter: Custom Number — override the automatic number. Appendices letter themselves now, so this is for the odd chapter that needs a number of its own. Hide Number — leave this chapter out of the numbering entirely; it shows no number anywhere (including the table of contents), and later chapters renumber to close the gap. Navigation Label — a shorter form of the title for the chapter list, when the real title is long. Layout at chapter openings — new page, columns, drop cap, headers and footers, headpiece and tailpiece — is under Project Settings → Chapters; see General Project Settings. **A title across two columns**: In a section set in more than one column, such as a two-column index, the title sits over the first column. To centre it across the whole page, with the columns starting underneath, turn on Full Width under Project Settings → Headings → Chapter Title. It is a setting of the style, so it applies to every chapter title in the book. In a single-column chapter the title and the text below it stay where they were. The exception is a first paragraph or heading whose top margin is larger than the space under the title: that larger margin is ignored. It only works in a section that starts a new page. ### Table of Contents **Table of Contents**: Add a table of contents with Insert → Table of Contents in the chapter list. Inkwell generates it from your headings and keeps it up to date — including the page numbers, which come from the real typeset layout rather than an estimate. You do not edit the table of contents directly. Change a chapter title and the entry changes with it. **Which levels appear**: Click Project Settings , then Table of Contents. Show Levels decides how deep the listing goes: parts and chapters only, or down through sections, subsections, and subsubsections. Keeping it shallow is usually right for a trade book; a reference work often wants more. **Changing how it looks**: The table of contents is laid out with a visual template editor. Click Edit Template in the same settings section. This opens an editable model of a single contents entry, which you lay out as you would any other content: choose fonts, set spacing, and decide where the chapter number sits relative to the title. To get the run of dots between the title and the page number, put the cursor in the title cell and set Leader to Dots in the Table Cell settings — the dots then run right up to the page number, and the template editor shows them stretching as they will print. A title too long for one line fills the first line to full width before wrapping, so the page number sits close to the end of the entry. To even out the lines instead, switch on Balance Lines in the title cell's Table Cell settings: the entry keeps its number of lines, and the break falls after a comma or a colon where one is near the middle — "In the middle of the eighth century, / the Byzantine emperor…" rather than "In the middle of the eighth century, the Byzantine / emperor…". With a leader, the dots and the page number stay on the last line. An ePub has no fixed pages, so it has no page numbers for the dots to lead to. Inkwell leaves the leader out there rather than trailing a run of dots into an empty space; the entries are links instead. The PDF is unaffected. The editor shows one row per kind of entry, labelled down the left — Front Matter, Part, Chapter, Section, and so on down to Back Matter and Appendix — and each is laid out separately. Only the rows your project actually uses are shown, so the Appendix row appears once the project has an appendix in it. Front Matter and Back Matter print no number, because those chapters have none; the Appendix row does, and carries the word from Project Settings → Appendices in front of the letter. What you build in a row is applied to every entry of that kind. The same template mechanism is used for headings, headers and footers, and the list of figures, so it is worth learning once. See Chapter Titles, Parts, and Section Headings. **Linking**: In the ePub and PDF outputs the entries are links, so readers can jump straight to a chapter. Nothing needs switching on for this. **Related listings**: List of Figures works the same way: add it from the Insert menu and configure it under Project Settings → List of Figures, which also uses an editable template. See Figures and Images. ### Writing Content **Writing Content**: Most of your work happens in the editor. Click a chapter in the list on the left to open it. The middle of the screen is where you write. It behaves much like Microsoft Word or Google Docs — just start typing. Everything you type is saved automatically; there is no Save button. In the rest of this tutorial we say "chapter", but articles use "sections" and the two are interchangeable. **The live preview**: The right-hand pane is a real typeset PDF of the page you are on, regenerated as you write. It is not an approximation — it is the same rendering that comes out when you publish. The preview typesets one chapter at a time: the one you are working in, plus, when you first open a book, the chapters before it, which decide what page it starts on. A chapter late in a long book can therefore take a little longer to appear the first time; after that, typing only retypesets the chapter you are in. Its controls let you Zoom In and Zoom Out, step to the previous or next page, and Toggle Fullscreen. Two buttons underneath switch between Show Preview in Color and Show Preview in Grayscale, which is useful when you are checking how images will look in a black-and-white print run. Drag the arrow on the divider to widen the preview when you want a closer look, and back again when you want more room to write. A widened preview also has a slider beneath it for scrolling through the book, and a box reading Page 12 of 348. Type a page number into the box to jump there — an arabic number or a roman one for the front matter. The total counts every page of the book, front matter included, so it can be larger than the number printed on the last page. It appears once every chapter of the book has loaded and been typeset; until then only the current page is shown. **Save status**: A badge above the preview tells you where your work stands: Saved — everything is stored. Saving… — a save is in flight. Having Trouble Saving… — Inkwell cannot reach the server. Your work is held locally and sent when the connection returns, so it is safe to keep writing. Read Only — you do not have edit permission on this chapter. This is what collaborators with a Read or Frozen role see. If your sign-in session expires — for instance in a tab left open after signing out elsewhere — a red banner appears here saying you are signed out, and editing pauses until you sign in again. Signing back in from any tab of the same browser resumes the tab automatically within a minute; nothing typed before the pause is lost. If the project has never been opened in this browser, there is nothing to show until you sign in, so the page says You're signed out with a Sign In button that brings you back to it. You may also see a notice that a new version of Inkwell is available. Until you click Reload (or refresh the browser), that tab works offline: you can keep writing, and your changes are kept on your device and saved once you reload. If your browser is running short of local storage, Inkwell warns you about that here too. **Statistics**: Below the preview, Current Section shows the number and title of the heading your cursor is under, numbered just as the book prints it (2.3 Methods). Above the first heading it names the chapter itself. Headings scroll out of view in a long chapter, so this tells you where you are without scrolling back up. Under that, Inkwell reports the current chapter's Grade Level — a Flesch-Kincaid estimate of reading level — along with the total Word Count and a split into body and notes word counts, so footnote-heavy chapters do not inflate the figure you care about. Remove Chapter at the bottom deletes the chapter you are viewing; it does the same as Remove… in the chapter's ⋯ menu in the chapter list (see Managing Chapters). Like the rest of the statistics, it is only there while Tools → Preview is on. If you delete one by mistake, Insert → Restore Chapter in the chapter list brings it back. **Basic formatting**: The toolbar across the top carries the usual marks: Icon Effect Bold Text Italic Text Underline Strikethrough Text Superscript Text Subscript Text Smallcaps Text Small caps use the font's own small-capital letterforms when it has them. Most fonts do not include a small-caps design — the default, Latin Modern Roman, is one of them — and those get scaled capitals instead, matching what you see while you write. Scaled capitals really are capitals, so copying that text out of the PDF gives you ORIGIN rather than Origin. If that matters for your book, pick a font that has small caps of its own. Inkwell checks each face of a font separately, because many fonts have small caps in the regular face and not in the italic or bold one. Small caps in italic or bold text use whichever face the PDF really sets that text in: real small capitals where that face has them, scaled capitals where it does not. At the far left, Undo and Redo step back and forth through your changes. Use the Link button to turn the selection into a link. Clicking it opens the link toolbar, where you type the URL: The Change Case button converts the selection to Title Case, UPPERCASE, lowercase, or Sentence case — handy for fixing a heading in one step. On the left rail sit Local Settings and Project Settings . Local Settings adjust whatever is selected right now; Project Settings apply to the whole book. Both have their own chapters. The rest of the toolbar — figures, tables, footnotes, citations, index entries, and math — is covered in the chapters that follow. ## Tutorial: Editing And Formatting ### Paragraphs and Other Content Styles **Paragraphs and Other Content Styles**: The paragraph style is the main tool for controlling how your document looks. Rather than formatting each paragraph by hand, you say what a paragraph is and let the template decide how it should appear. The style dropdown sits on the toolbar: **The built-in styles**: Chapter Title — the chapter's title. Section, Subsection, Subsubsection — the three heading levels below it. See Chapter Titles, Parts, and Section Headings. Paragraph — ordinary body text. Blockquote — an extended quotation, set apart from the body. See Block quotes below. Display Math — a paragraph holding a displayed equation. See Math. Bibliography Entry — a manually written bibliography entry, for references not managed by the citation tools. Index Entry and Index Subentry — for hand-built index material. See Index. **Block quotes**: A block quote is a container, not just a way of styling paragraphs, so it can hold more than prose. Select everything you are quoting — including any lists or other material — and choose Blockquote. The whole selection moves inside the quotation together, and a list quoted this way stays within the quote's indentation instead of breaking out of it. Anywhere inside a quotation the style dropdown reads Blockquote, whatever the paragraph would otherwise be — that is how you tell the cursor is still in the quote, and it changes as soon as you click out of it. To leave a quotation, put the cursor in it and choose another style, usually Paragraph. That takes the paragraph back out of the quote. The text straight after a quote carries on the paragraph the quote interrupted, so its first line is not indented. To start a new paragraph there instead, leave one empty paragraph between the quote and the text. It adds no space on the page, but the paragraph after it is indented like any other. **Kinds of quotation**: Because a quote is a container, it has settings of its own, under Project Settings → Block Quotes: its Inset, which narrows the quote by the same amount from the left and the right margin, the space above and below it, the space between its paragraphs, and the typography of everything inside. Two come built in. Blockquote is the ordinary extended quotation. Verse is for poetry — it leaves the lines as the poet broke them, neither justified nor indented — and is what the Insert Verse button produces. For a poem, make each stanza one paragraph and end each of its lines with Shift+Enter rather than Enter. The stanza then breaks across pages like any paragraph, with no single line left stranded, and the space between stanzas is the space between paragraphs. Give the style a Hanging Indent and a line too long for the page carries on indented beneath itself, while every line of the poem still starts at the margin. A quotation that picks a poem up partway through a line should leave that fragment where it stood, not at the margin. Type spaces in front of it until it sits where it fell in the poem. Every space you type is kept, in the PDF and the ePub alike. Remove Extra Spaces under Cleanup will offer to take them out, so pass over that one. At the bottom, (New Custom Style) creates a style of your own. Once defined it appears in the dropdown alongside the built-ins and gets its own entry in Project Settings, so it can be restyled everywhere at once. Custom text styles — which apply to a selection rather than a whole paragraph — are a separate dropdown; see Advanced Formatting Features. If what you want set apart is not a quotation but a passage of your own — a technical session, a case study, a worked example — with a heading and a number of its own, that is a callout rather than a quote. See Callouts. **Project settings for paragraph styles**: Project Settings → Paragraphs lists every style. Changing one there changes every paragraph using it, throughout the book. Each style offers: Alignment — left, right, centred, or fully justified. Font — over 1,500 available. Characters the font cannot draw, such as a line of Chinese in a Latin font, come from a matching font chosen under Other Scripts. Font Size. Line Height — increase for double spacing. Bold and Italic — applied to the whole paragraph. Weight — for a font with more than a regular and a bold face, such as a Semibold or a Medium, the exact face to use. It appears only when the style's font has such a face, lists only the weights the font has, and wins over Bold when set. Default leaves the weight to Bold. Small Caps and Uppercase — small capitals, or full capitals. Both change only how the text is printed, not what you typed, so you can type a style's text in ordinary case. Indent — indent the first line. Hanging Indent — indent every line except the first. A line break (Shift+Enter) starts a new line flush with the first, so only lines that run on are indented. Top Margin and Bottom Margin — space above and below each paragraph. Top Group Margin and Bottom Group Margin — space above and below a run of consecutive paragraphs in this style, rather than around each one. This is how you get space around a block quotation without spacing out its individual paragraphs. Keep With Next — prevent a page break between this paragraph and the next. Hyphenation — whether words may break across lines. Auto hyphenates justified text only; left-aligned, centred and right-aligned text keeps its words whole. Always and Never do what they say, whatever the alignment — choose Always for ragged-right body text with a more even right edge. Justification Tracking — how justified lines are filled out to the margin. Subtle, the default, lets a line adjust the spacing between its letters very slightly as well as between its words, so the slack is spread across the whole line instead of opening wide gaps between words. It helps most in narrow columns and around equations or long words. Strong allows more, which closes the loosest lines but makes some others look tighter. Off adjusts word spacing only. It has no effect on text that is not justified. Hang Punctuation — on by default: full stops, commas, hyphens, colons, semicolons and dashes at the end of a line sit slightly past the right margin. They carry little ink, so letting them hang makes the edge of justified text look straighter than setting them flush would. Professional typesetting software calls this optical margin alignment. Turn it off on the Paragraph style to set every line exactly to the margin throughout the book, for instance to match a house style. It affects the PDF only; the editor and EPUB books always set punctuation flush. Language — the language the paragraph is written in, which decides where its words may be hyphenated. See Passages in another language. Inset — narrow a run of paragraphs in this style, adding the same space on both sides. Like the group margins, it belongs to a style here, so you will not find it for a single paragraph, inside a quotation, or for a list's or the footnotes' paragraphs. A quotation is narrowed by its own Inset, under Block Quotes. **Passages in another language**: Words are hyphenated by the rules of the language they are in, and Inkwell takes the text to be English unless told otherwise. A quotation in German or Latin set by English rules breaks its words in the wrong places, or finds no place to break them at all, and the justified lines around them open into wide gaps. To fix it, set Language on the text that is in another language: A paragraph or a block quotation — put the cursor in it, open the Paragraph section of Local Settings, and choose the language. A few words inside a paragraph — select them and choose the language in the Text section of Local Settings. Something that recurs — give the language to a paragraph style or a text style, and every use of it follows. Default means the text is in whatever language surrounds it, so a bold or italic text style used inside a German quotation stays German. The list offers the languages Inkwell has hyphenation rules for. The setting changes only hyphenation, not the text itself: quotation marks stay as you typed them. In an ePub the passage is tagged with its language too, so a reading app can hyphenate it and read it aloud correctly. **A book written in another language**: When the whole book is in another language, set Language on the Paragraph style, under Paragraphs in Project Settings. Every other style takes its language from that one, so headings, footnotes and block quotations follow without being set one by one; a passage you mark as English or Latin still keeps its own. The book's language also: names the language of the ePub, which reading apps and stores use to list and read it; sets the words citations and the bibliography are written with — "Hrsg." and "S." rather than "ed." and "p." in a German book — for the languages a citation style has them for. A style made for one journal may insist on its own; tells your browser which dictionary to check your spelling against as you type. It does not translate anything. The labels Inkwell supplies — "Chapter 1", "Table of Contents", "Figure", "Appendix" — are settings of their own, and are in English until you change them. Changing template keeps the book's language. **Overriding one paragraph**: To change a single paragraph without touching the style, use Local Settings: click the Local Settings icon , put the cursor in the paragraph, and open the Paragraph section. The same applies to headings, block quotations, lists, and display math — put the cursor in the element and the panel offers the matching section. Any setting you override gets a Reset button that returns it to the project default, so you can always tell what you have changed and undo it. As a rule, reach for the project setting first and the local override only for genuine one-offs — that is what keeps a long manuscript consistent. ### Lists **Lists**: Inkwell has numbered lists and bullet lists . Both buttons are on the editor toolbar and turn the current paragraph, or the selected paragraphs, into a list. Lists nest. Indent pushes the current item down a level; Dedent pulls it back up. Tab and Shift-Tab do the same thing from the keyboard. Press Enter for the next item, and Enter on an empty item to leave the list. A list can sit inside a block quote. Select the quoted material, list and all, and apply the Blockquote paragraph style — the list stays inside the quotation's indentation rather than breaking out of it. See Paragraphs and Other Content Styles. **List settings**: Settings live under Project Settings → Lists, split into Numbered Lists and Bullet Lists, and can be overridden for one list at a time in Local Settings. Both kinds share the layout settings: Indent — space to the left of the whole list. Body Indent — space between the marker and the text of the item. Spacing — space between consecutive items. Top Margin and Bottom Margin — space above and below the list. Number Align — how the marker is aligned within the space reserved for it. Right alignment keeps the text of every item flush when the list runs past item 9 into double-digit numbers. **Numbering**: Numbered lists have separate numbering settings for each of the first three levels, so a nested list can run 1., then a., then i. Each level has two settings: Numbering — the sequence: numerals, letters, roman numerals, and so on. Number Format — how the marker is written, such as 1. versus (1). ### Math **Math**: Inkwell has two kinds of mathematics. Inline math sits in the run of a sentence, for things like n > 0. Display math gets a line of its own and, unless you say otherwise, is numbered. It is a paragraph style, so you can also reach it from the style dropdown or by typing \[. Select an equation and a math toolbar appears. **The math toolbar**: Icon Action Type instead Superscript ^ Subscript Fraction / Square root sqrt Summation sum Product prod Union bigcup Intersection bigcap Binomial binom Integral int Absolute value Prime ' Roman text (non-italic) Letters typed into an equation are italicized by default, the way variables are — select some and use Roman text to switch just that selection upright, the way \log and \lim already render automatically. Handy for names and labels inside an equation, like the Bob in I(Bob). Three dropdowns follow the buttons: Style — alternative letterforms: blackboard bold, calligraphic, fraktur, and so on. Accent — bars, hats, tildes, vectors and other marks over a symbol. Symbol — a browsable panel of mathematical symbols, described below. **Insert Symbol**: The Symbol dropdown holds around 180 symbols, for anything you cannot remember the name of. They are grouped into six categories: Greek Letters — the lower-case and upper-case alphabets, along with the variant letterforms: \varepsilon, \vartheta, \varphi, and the rest. Basic Operators — arithmetic and the everyday constructions: plus-minus, factorial, absolute value, floor and ceiling, roots, binomial coefficients, sums and products. Relations — equality, inequality, approximation and similarity, orderings, parallel and perpendicular, divides, and their negated forms. Set Theory — membership, subsets and supersets, union and intersection, difference, power set, cardinality, complement, and the quantifiers. Logic — negation, conjunction and disjunction, implication, turnstiles and entailment, truth constants, therefore and because. Calculus — limits, ordinary and partial derivatives to several orders, single through triple integrals, contour and surface integrals, infimum and supremum, and nabla. The buttons show the symbol itself and nothing else, so the panel is for browsing when you would recognise the symbol but could not name it. When you can name it, typing is quicker — see below. If your project already contains mathematics, a Frequently Used row appears above the categories. It is drawn from the equations across the whole project and ordered by how often each symbol appears there, so it settles on the notation your book actually uses. It is not a list of what you inserted most recently, and it holds at most 35 symbols. There is a second, unrelated Insert → Symbol… on the main editor toolbar, for dashes and unusual spaces in ordinary text — see Advanced Formatting Features. **Typing rather than clicking**: The editor understands mathematical names as you type them: sin, cos, tan, epsilon, gamma, omega, pi, sup, sub, in, and many more. Full LaTeX syntax also works, so if you already know LaTeX you can simply type it. Typing $x^2$ in ordinary text converts it into inline math automatically. **Turning what you have written into an equation**: If the maths is already sitting in your paragraph, select it and press the inline or display math button (or Ctrl+4). Straightforward expressions — E = mc^2, α ≤ β, sin x, anything already written as LaTeX — become equations immediately. Anything described in words, like the absolute value of the inverse of ψ at T, is worked out for you instead, which takes a moment longer. **Numbering and references**: Display equations are numbered unless you turn that off. To refer to one, type Equation and a picker appears listing the equations in your project; choose one and Inkwell inserts a reference that keeps its number correct if equations are added, removed, or moved. The number sits at the right margin. An equation too wide to be centred clear of it moves left to make room, and one too wide even for that gets its number on a line of its own beneath. **Settings**: Project Settings → Math: Font — mathematics needs a font with the right glyph coverage, so ordinary text fonts cannot be used here. Inkwell supplies a range of maths fonts to choose from. Number Equations — whether display equations are numbered unless they say otherwise. Numbered By — whether numbering restarts in each chapter or runs continuously through the book. In Local Settings, a display equation has a single setting, Numbered, which overrides Number Equations for that one equation: turn it off to drop the number from one equation, or turn Number Equations off and this on to number only the handful of equations you refer to. ### Figures and Images **Figures and Images**: **Figures**: Click the Insert Figure button and choose a file from your computer. As well as image files, Inkwell accepts PDFs as figures — useful for vector diagrams from drawing or plotting software, which stay sharp at any size. Once uploaded, it appears as a figure with a label beneath it: Click the caption below the figure to write one. Selecting a figure brings up its own toolbar: Crop trims, turns or mirrors the picture, Replace Image swaps the file while keeping the caption, numbering and settings, and Remove Figure deletes it. To refer to a figure from the text, type Figure and pick it from the list that appears. Inkwell keeps the number correct as figures are added, removed, or moved. By default a figure is numbered within its chapter — Figure 2.1 is the first figure of Chapter 2. In an appendix it takes the appendix letter instead, so Figure A.1. In a chapter that carries no number of its own, such as a preface, figures simply count 1, 2, 3. If your figures are generated by a program, it can upload them to Inkwell directly and replace the picture each time it runs. See Updating Figures from a Script. **Cropping**: Select a figure and press Crop to open the crop window. Drag the box to move it, drag its corners or edges to resize it, or drag anywhere on the picture to start a fresh box. The area outside the box is dimmed, so what you see is what will print. Aspect ratio — leave it on Free to frame by eye, or lock the box to Original, Square, 4:3, 3:2 or 16:9. Original follows the shape of the picture, so it keeps up when you turn it. Rotate left and Rotate right turn the picture a quarter turn at a time — the quick fix for a photo that came off the camera on its side. The box comes round with the picture rather than jumping somewhere else. Flip horizontal and Flip vertical mirror it. The numbers in the corner are the pixel size of the picture you will end up with. Press Crop to apply it. Inkwell makes a new picture rather than remembering the rectangle, so the printed book and every export simply see an ordinary image. The picture you started from is kept, so reopening the crop window puts the box back exactly where you left it and lets you widen the crop again — you are never cropping a crop. Reset to original puts the whole picture back. Cropping throws pixels away, so a heavily cropped figure may start showing the low-resolution warning. That is the warning doing its job: there really is less detail left to print with. Crop less, or start from a larger file. SVG and PDF figures cannot be cropped. They are drawings rather than grids of pixels, so there is nothing to cut — which is also why they stay sharp at any size. The Crop button is greyed out for them. Trim them in the program that drew them, or use Replace Image to swap in an image file. **Per-figure settings**: With a figure selected, Local Settings offers: Width — as a percentage of the text width. This is an upper limit rather than an exact size: a figure whose picture and caption together come to more than a page is scaled down until the two fit, so a long caption can never run off the bottom of the page. Shorten the caption if you would rather keep the picture large. Bleed — how far past the text the figure reaches. See Bleed below. Full Width — in a chapter set in two or more columns, run the figure across all of them, caption included. See Full width figures below. Hide caption — keep the figure numbered but without caption text. Hide label — drop the "Figure 3" label while keeping the caption. Caption Position — above or below, overriding the project default. Automatic Placement — let Inkwell move this figure to where it fits, or pin it exactly where it sits in the text. **Bleed**: By default a figure sits inside the text column. Bleed lets it reach further: Inline — the figure spans the full width of the paper, margin to margin, while the text carries on above and below it. Full page — the figure takes a page of its own, filling it edge to edge. Two-page spread — the figure runs across a facing pair of pages. Inkwell splits the image down the middle: the left half prints on the left-hand page, the right half on the right-hand page, and the two meet at the fold. The top, bottom and outer margins are kept, and the figure prints its caption and number as usual. Two-page spread, full bleed — the same, but filling both pages right off all four edges. There is no margin left to put a caption in, so it prints none. Set Width below 100% to hold the image back from the edges; it stays centred in whatever area the bleed mode gives it. Bleed changes only how the figure prints. It is still numbered, still referred to by number from the text, and — as long as you have written a caption — still listed in the List of Figures, even in the modes that do not print the caption. **Full width figures**: In a chapter set in columns (the chapter's Columns setting), a figure normally sits in one column. Turn on Full Width and it spans every column instead, from the left edge of the text to the right, with its caption under it at the same width — the way a journal sets a wide chart across a two-column page. The figure moves to the top or bottom of the page it falls on, or the next one if there is no room, and the columns of text flow around it. It does this in an article too, where chapters run on without starting a new page. A full-width figure always moves to the top or bottom of a page, even with Automatic Placement off; with it off, the figure goes to the top. Width still applies, now as a share of the whole text width. In a one-column chapter there is nothing to span and the setting does nothing. Full Width is offered only while Bleed is None: a bleed already runs past the columns. The editor shows a single column, so it marks the figure's caption as full width rather than widening it, and the ePub leaves the figure where it is. **Where a spread lands**: A spread has to start on a left-hand page, or a reader turning the page would meet the right half first. Rather than break the text where the figure sits — which would leave a short page and often a blank one — Inkwell lets the text run on to fill the next right-hand page and puts the spread on the opening after it. The text picks up again on the page after the spread. That is what Automatic Placement does for a spread, and it is on by default. Several spreads close together follow one another, each on its own opening, with no blank pages between them. Turn Automatic Placement off to pin the spread where it sits instead. Inkwell still moves it to a left-hand page, so expect a short page, and about half the time a blank one, before it. **Project settings**: Project Settings → Figures has three groups: Layout, Caption, and Label. **The Layout settings include:**: Numbered By: Determine whether the figures’ numbering should be per-chapter or per-project. Numbering: Displays the numbering format, which includes: Numeric (Figure 1.1) Alphabetic (Figure 1.a) Roman Lowercase (Figure 1.I) Roman Uppercase (Figure 1.I) Greek (Figure 1.α) Star and Dagger (Figure 1.\) English Words (Figure 1.One) Choose whether to display the Chapter Number as a prefix in the Numbering scheme Top and Bottom Margin: Determine the amount of extra whitespace before and after the figure. Gap: Amount of space between the figure and the label Automatic Placement: If enabled, Figures will be moved to the top or bottom of the page so as not to interrupt the text. **The Captions settings include:**: Alignment: Determines whether the caption is left-aligned, right-aligned, centered, or fully justified Position: Moves the caption to either above or below the figure Font: Over 1500 fonts available Font Size: Determines the size of the font Line Height: Determine the distance between lines, increase to produce double spacing Bold or Italic **The Labels settings include:**: Font: Over 1500 fonts available Font Size: Determines the size of the font Line Height: Determine the distance between lines, increase to produce double spacing Bold or Italic **Images**: Any figure can be converted to an image, which can appear independently or as an inline image. To convert a figure to an image, click on the figure to select it, then click on the Local Settings icon along the left side of your screen. Click on the Figure menu: Next, click on Convert to Inline Image: The figure becomes an image that can be resized if needed. To resize the image, click on it to select it, then click on the Image menu: From here, you can resize the image by adjusting the point size either up or down accordingly. Click outside the size field to make the change. To go back the other way, select the image, open the Image section of Local Settings, and click Convert to Figure. Inline images crop exactly like figures — select one and press Crop on the toolbar. A crop survives converting between a figure and an inline image, in either direction. **List of Figures**: Every captioned figure can be collected into a generated listing. Add it with Insert → List of Figures in the chapter list, and it fills itself in with each figure's caption and page number, staying up to date as the book changes. Its formatting is under Project Settings → List of Figures. ### Tables **Tables**: Insert a table with the Insert Table button on the toolbar. Inkwell asks how many Rows and Columns you want — type the numbers rather than dragging out a grid — and inserts the table. Books Author The Old Man and the Sea Hemingway The Iliad Homer Fahrenheit 451 Ray Bradbury Anna Karenina Leo Tolstoy An example table **What goes in a cell**: A cell holds ordinary content, not just a line of text. Press Enter in a cell and you get a second paragraph in that same cell rather than moving to the next row — use Tab to move on. Bulleted and numbered lists and block quotes work in a cell too, and so do footnotes, links and every character style. The up and down arrows move between the paragraphs of a cell first, and only step to the next row from the top or bottom of one. Two things still belong outside a table: figures and nested tables. An image in a cell goes in as an inline image, sized with the text, rather than a captioned figure. A cell's settings — its font and alignment, under Table Cell in Local Settings — apply to everything in it, so setting a cell centred centres all of its paragraphs. Give one paragraph something different and that paragraph keeps it. The cell's margins are the space between its edges and its contents; they do not space its paragraphs apart, so set a paragraph's own top or bottom margin for that. A list inside a cell is the exception: it keeps the list's own typography, in the book as well as on screen. **The table toolbar**: Put the cursor in a table and a toolbar appears with the structural operations: Add Column, Add Row, Remove Column, Remove Row, Remove Table. Merge Cells — join the selected cells into one, for a heading that spans several columns. Split Cells — undo a merge. Caption — wrap the table in a captioned, floating table, so it gets a number, a caption, and can be placed automatically like a figure. A style preset dropdown, for switching the table's whole look in one step. Move between cells with Tab and Shift-Tab, and between rows with the up and down arrow keys. **Table settings**: Tables are set up in two places, and the two do not hold the same things. Project Settings → Tables carries what applies to every table in the project: a Default Style Preset, a Default Position, and the numbering, caption and label settings that captioned tables use — those are described under Numbering and captions below, and they are only ever set here. These reach the tables you put in a chapter, and only those. The table of contents, the list of figures, a two-column bibliography and the running heads are laid out as tables too, but they run the full width of the page by design and are left alone by both defaults. Everything else belongs to one table, and is set with the cursor inside it in Local Settings. The Table section there covers the table as a whole: Style Preset — the named look. Left alone it follows the project default; set it and this table stops following. Position — Left, Center or Right, for where the table sits across the page. It follows the project default the same way. Full Width — float the table to the top of the page and, where the chapter runs in more than one column, let it span them all instead of sitting inside one. A table with a caption spans together with its caption, and moves to the top or bottom of the page like any captioned table. In a chapter set in columns this works anywhere in the chapter, including in an article, whose chapters run on without a new page. A one-column chapter has no columns to span: a captioned table floats as it always does, and one without a caption floats to the top only when the chapter starts a page of its own. This is about the page, not the table: it will not stretch a narrow table. Only the PDF has pages to float to, so the editor and the ePub leave the table where it is. Borders (all cells) and Shading (all cells) — change every cell at once, without having to select them. Alongside it, three finer-grained sections take whatever the cursor is in: Table Row — settings for the row, including Rotation (see Rotated labels), which is where you set a whole header row at once. Table Column — Width (see Column widths), Alignment, Vertical Alignment, Rotation, Balance Lines, and the four margins. Table Cell — Leader, Alignment, Vertical Alignment, Rotation, Balance Lines, and margins for one cell. Balance Lines evens out the lines of any paragraph in the cell that runs to more than one, instead of filling each line before starting the next, so a cell never ends on a line holding one or two words. It keeps the same number of lines, prefers to break after a comma, colon or dash, and never breaks after an initial. It is off unless you switch it on, including in the table of contents, whose entries are table cells. All three take a range of cells as readily as a single one. Drag across the cells you want and Table Cell changes every one of them, Table Row every row you touched, and Table Column every column — so squaring up three columns of figures is one drag and one click, not one click per column. The boxes show the values of the cell you finished the drag on. **Column widths**: There is no dragging a column edge. Width is the Width box under Table Column, and it offers three things: Expand — the column takes up the slack. Fit contents — the column is only as wide as what you put in it. Fixed — the column is exactly the width you type, in em. One em is the size of the body text, so 6em is about six characters wide and stays that way if you change the type size later. Every column starts out expanding, which is why a fresh table fills the text width in equal columns. Set the ones holding short things — a year, a price, a single word — to Fit contents and they shrink, while the columns still expanding divide up the room that frees, in equal shares. Set them all to Fit contents and the table ends up only as wide as its contents — in the editor as well as in the book, so what you see is the width that prints. So there are two ways to give a column of prose the space it needs: expand it and narrow its neighbours, or put a Fixed width on the neighbours and let the prose take everything left over. A fixed column takes no share of the slack, so the expanding ones divide what is left after it. Width applies to the whole column even though you set it with the cursor in a single cell — which is why it lives under Table Column rather than Table Cell. Setting it anywhere in a column sets the whole column. Two things to know: A centred or right-positioned table has to shrink to its contents, or there would be no space left to move it into. Those tables ignore Expand — it only shows in a table positioned Left. A Fixed width is not ignored: it is a width you asked for, and the table still has room to move. A cell with a Leader needs slack to stretch into, so leave that column on Expand, or give it a Fixed width for the dots to run across. That is how a contents line is built: the title column expands, the number and page-number columns do not. **Rotated labels**: A table of narrow columns under long header words is mostly wasted paper: every column ends up as wide as its label. Rotation turns a cell's contents on their side so the label stops setting the width. None — upright, as every cell starts out. Vertical (bottom to top) — the label reads upwards. The usual choice for a header row. Vertical (top to bottom) — the same turn the other way. Angled 45° — the label rises to the right on the diagonal. Set it on the Table Row to turn a whole header row at once, on the Table Column for row labels down the left, or on the Table Cell for a single one. Two things make the difference between a rotated label and a useful rotated label: Rotating does not narrow the column. The column keeps whatever width policy it had, so set the columns under the labels to Fit contents or a Fixed width (see Column widths) and the table shrinks to the numbers rather than to the words above them. Alignment still means the cell's directions, not the label's. A vertical label in a cell set to Middle floats in the row; set the header row's Vertical Alignment to Bottom and the labels sit on the line above the numbers, which is what a rotated header is supposed to look like. An angled label leans out over the columns to its right rather than making room for itself — that is what the angle is for, and it is why the column under it can be as narrow as the numbers in it. The last label leans past the edge of the table, so leave it a little room there. The editor and the ePub draw the same arrangement, with every label standing on its own column, but they are approximate about the space it takes: a browser has no way to reserve exactly what a 45° label needs, so the header row comes out taller than it prints and the column a hair wider. The PDF measures it exactly. Read the preview for which column a label belongs to, and the PDF for how much room it takes. **Leaders**: Leader fills the space between a cell's content and the next column: Dots for the run of dots you see in a contents list, Blank for the same stretch without them, None to leave it alone. It follows the cell's last paragraph, and it is meant for a cell holding a single line — a leader on a cell with a list or several paragraphs in it stops at the column edge instead of carrying across. Whatever room is left in the cell, the leader takes, which is what makes Chapter One .......... 17 line up. See Table of Contents, which is built this way. In the PDF and the ePub the cell joins with the one to its right, so the dots carry on past the column edge and run right up to what follows. The editor cannot do that — those are cells you are still editing, and they have to stay separate — so on screen the dots stop at the edge of their own cell. The stretch is the same; only that last step is missing. **Numbering and captions**: A captioned table is numbered and labelled like a figure, with the same three groups of settings: Layout Numbered By — numbering per chapter or continuous through the project. Numbering — the format: Numeric (Table 1.1), Alphabetic (Table 1.a), Roman lower or upper case, Greek (Table 1.α), Star and Dagger (Table 1.\), or English Words (Table 1.One). Whether to prefix the chapter number. Top Margin and Bottom Margin — space around the table. Gap — space between the table and its label. Automatic Placement — let Inkwell float the table to the top or bottom of a page so it does not interrupt the text mid-paragraph. Caption — Alignment, Position (above or below), Font, Font Size, Line Height, Bold, Italic. Label — Font, Font Size, Line Height, Bold, Italic. To refer to a table from the text, type Table and pick it from the list; the number stays correct if tables are added or moved. Numbered per chapter, a table in an appendix takes the appendix letter — Table A.1 — and one in a chapter with no number of its own, such as a preface, counts plainly: 1, 2, 3. ### Callouts **Callouts**: A callout is a passage set off from the rest of the text and numbered on its own — a technical session, a case study, a note to the reader, a worked example. It behaves like a block quote, in that it is a container holding whatever you put in it, but it also carries a heading of its own, gets a number, can be cross-referenced, and can be collected into a list at the back of the book. **Defining a kind**: Callouts come in kinds, and you define them. A textbook might have Technical Session and Case Study; a devotional might have just For Reflection. Nothing is defined to begin with, so the first step is always to make a kind. Callouts live in the paragraph style dropdown, alongside Blockquote — they are chosen the same way. Open it and pick (New Callout Kind…) at the bottom. Give the kind a name in the singular — "Technical Session", not "Technical Sessions" — because the name is what appears in front of the number: Technical Session 3. Inkwell works out the plural on its own for the list page. Whatever you had selected becomes a callout of the new kind straight away. You can also add and edit kinds under Callouts in Project Settings. **Inserting one**: Select the paragraphs you want set off and pick the kind from the style dropdown. The whole selection is wrapped, so you can take in a run of paragraphs, a list, a table — anything. With the cursor inside a callout the dropdown shows its kind rather than the style of the paragraph you are in. Pick a different kind to change what it is, or pick Paragraph to take the callout apart — exactly as choosing a style inside a block quote takes you out of the quotation. The content stays; only the callout around it goes, and a title becomes an ordinary paragraph. **Giving it a title**: A new callout starts with an empty title line at the top, marked Title (optional), and the cursor waiting in it — so you can name the thing as you make it. The title is what appears in the callout's heading and in the list at the back. It really is optional. Press Enter to leave it empty and move down into the body, and a callout with no title simply shows its label and number. Press Backspace on the empty title line to take it off altogether. To carry on writing after a callout — including one that ends the chapter, with nothing below it yet — press Enter on an empty last line, or click just beneath it. **Adjusting one callout**: A kind's settings apply to every callout of that kind. To change just one, put the cursor inside it and open the Callout section of Local Settings. Its spacing and paragraph settings start out as the kind's; change one and only this callout follows. Like the kind's paragraph settings, these apply to the callout's content only; the lines the template draws keep their own formatting. **The template**: Everything a reader sees around a callout's content comes from a template you can edit, rather than from a row of settings. Open Project Settings, find your kind under Callouts, and click Edit Template. The template is ordinary document content with variables in it: Label — the kind's name, "Technical Session" Number — the number, "3" or "1.4" Title — the title you typed on the callout's first line Body — where the callout's own content goes Body is the important one. Give it a line of its own, with nothing else on that line. Whatever you put above it becomes the callout's header, and whatever you put below it becomes its footer. So a rule above and below, a bold label line, a closing "— end of session" — all of it is just content you type into the template, in the order you want it. The kind's paragraph settings — its font, size, alignment, background — are for the callout's content. The template's own lines are not part of the content, so they keep the formatting you give them in the template: to set the title in a different font or size, select it in the template and format it there. The default template is one bold line reading Label Number: Title, followed by the body. If a callout has no title, the colon disappears with it; if the kind is not numbered, the number disappears and the colon stays to separate the label from the title: "Technical Session: Measuring Drag". You never end up with a stray "Technical Session 3: " and nothing after it. **Boxes and frames**: The template can hold anything a page can hold, and tables are how you draw boxes. A table cell's shading, borders and padding are what the box looks like — set them the way you would for any table. A shaded title band. Put Label Number: Title in a one-cell table above Body. The band sits over the content, and the content runs on below it. A framed callout. Put Body inside a table cell. The cell's shading and borders now surround the callout's content itself. A Title line in the same cell, above Body, sits inside the frame with it. A header over a frame. Make a one-column table with two rows: Label Number: Title in the top cell, Body in the bottom one. Shade them differently for a coloured header bar over a lighter box. The header never ends a page on its own: if the content can't start below it, both move to the next page. Body can also go inside a block quote, which indents the content. Whatever frames it, the content keeps the callout's own text style, set under the kind's settings, rather than the cell's or the quote's. A title in a shaded cell shows on the cell's shading, even when the kind gives its paragraphs a background of their own. The editor draws all of these the way the page will, with the content still editable inside the frame. That works because Title and Body are placed where the editor can follow them: Body at the top of the template, in a table cell or in a block quote — not in a list — and Title above Body, either in the same cell or quote, in a one-cell table, or in the cell directly above Body's. The template editor marks a Title or Body anywhere else in red; hover over it to see what will happen instead. A Title that can't stay where it is goes on its own line just above the content, and a Body that can't stay puts the content after the whole template. **Numbering**: Each kind is numbered independently, so Case Study 1 and Technical Session 1 can sit on the same page without either looking wrong. Under the kind's settings: Numbered By — Chapter restarts in every chapter, Book runs straight through from beginning to end, and Not Numbered leaves the callout without a number at all. Numbering — numerals, letters, roman numerals and the rest. Include Chapter Number Prefix — whether a chapter-numbered callout reads "3" or "1.3". Numbers are worked out as you write. Insert a callout in chapter two and every later callout of that kind renumbers itself immediately, in the editor as well as in the PDF. **Referring to one**: Type the kind's name followed by a space — Technical Session — and a list of that kind's callouts appears; pick one and Inkwell inserts a live cross-reference to it. The reference shows the callout's number and follows it if the numbering changes. Each kind has its own trigger, so typing Case Study offers only the case studies. Rename a kind and the trigger changes with it. **The list at the back**: Each kind can have its own list page, the way figures have a List of Figures. Open the + menu at the top of the chapter list and choose List of Technical Sessions — one entry appears there for every kind you have defined. The page lists that kind alone, in the order the callouts appear in the book, with the page each one starts on. Its layout is a template too: open it from the kind's settings to change what the rows hold. Its title starts out as "List of …" and you can rename it by editing the heading on the page itself. **Callouts and comments**: Callouts are part of the book: they are printed, numbered and listed. They are not the same thing as the comments you leave for a collaborator, which sit in the text between one paragraph and the next and never appear in the finished book — those are covered in Collaboration. ### Footnotes/Endnotes **Footnotes/Endnotes**: To enter a footnote or endnote, place your cursor where you want to add the footnote and click on the Insert Footnote icon . A box will pop up. Put your cursor inside the box and type your footnote, then click anywhere outside the box to insert your footnote. Inkwell automatically adds the numbering and reorders any other footnotes if applicable. A note holds text and quotations, not figures. An image inserted into a note goes in as an inline image, sized with the text, rather than a captioned figure. To edit a footnote, click on the footnote number in the body text. The pop-up editing window will appear. Make your changes inside the text box. If you would rather see your notes as you write instead of one at a time, turn on Inline Notes in the Tools menu. Every note's text is then shown in the chapter, in a card in a break under the paragraph its number sits in — the same way a comment is shown — and you edit it there. If a quotation, a list or a display equation interrupts that paragraph, the card waits until the paragraph has finished, after the text that carries on beyond it. In this mode clicking a note number does not open the pop-up box, since the note's text is already in front of you. Press Escape to put your cursor back in the body text. The setting is yours rather than the project's, so it follows you between books and your collaborators are unaffected. To move a footnote, drag its number to the new place in the text and let go. The note's text, and any comments on it, go with it, and the notes are renumbered to match. To delete a footnote altogether, place your cursor in the body text immediately before the footnote number. Use your delete key to delete the footnote number reference. Likewise, you can place your cursor immediately after the footnote reference number and use your backspace key to delete the footnote. Two footnotes can sit at the same place in the text: insert a second one right next to an existing footnote and you get two numbers, not one merged note. Inkwell separates the numbers with a comma so they do not read as a single number. If you would rather separate them yourself — with a semicolon, or a comma and a space — type that punctuation between the two numbers and it stays where you put it, and Inkwell adds nothing of its own. To access Project Settings for Footnotes/Endnotes, click on Notes. Here you can choose: Placement: Where footnotes are placed, including four options: Footnote: at the bottom of the page Chapter Endnote: at the end of the chapter Book Endnote: In a separate section or chapter at the end of the book or article Hidden: nowhere; see Hiding notes Numbered By: Numbering can restart with each chapter, or continue through the entire book Numbering: Displays the numbering format, which includes: Numeric (1) Alphabetic (a) Roman Lowercase (i) Roman Uppercase (I) Greek (α) Star and Dagger (\) English Words (One) Name: Title of your choosing for an Endnotes section. Indent: Amount of whitespace indenting each footnote Body Indent: Amount of whitespace between the footnote number and the footnote text Spacing: Amount of line spacing between footnotes Top and Bottom Margin: Amount of extra whitespace before and after the footnote section Marker Size and Marker Baseline: The size of the reference marker and how it sits against the surrounding text The Format section provides the same settings as a paragraph and determines the format of the content of the footnote. When Placement is Footnote, a Paragraph section appears with the same typography controls an ordinary paragraph style has — Line Height included, so you can set the notes looser or tighter than the body text without touching the body text. **Hiding notes**: Set Placement to Hidden to take every note in the family out of the built book at once without deleting any of them. The markers and the note text disappear from PDF, EPUB, and Word output. Choose any other Placement to bring them all back, renumbered as they were. While hidden, the notes are still in your project: each shows as a small grey dot in the text, and you can still open and edit it. Inside the book, they no longer count for anything: Sources cited only in hidden notes leave the bibliography, and hidden citations are not counted for "ibid." or for numbered citation styles. The citations shown in the editor are still worked out with the hidden notes included, so they may read differently from the built book. Index entries inside hidden notes leave the index. A cross-reference to a hidden note prints nothing, so reword any sentence that relies on one. If the book has a Notes section at the back, choosing Hidden removes it. Choosing Book Endnote adds it again, with its title and settings as you left them. **How endnote numbers are laid out**: With Placement set to Chapter Endnote or Book Endnote, the Layout section adds two settings that decide where the number sits relative to the note. Number Style picks the shape: Column — the number sits in a slot of its own and the note text lines up in a column beside it, with every note's text starting at the same place. Run-in — there is no slot. The first line is indented like a body paragraph, the number runs straight into the text, and the following lines return to the left margin. This is the layout the Chicago Manual of Style specifies for endnotes. A run-in note can also hang from its number instead. Set Hanging Indent in the endnote list's Paragraph section and every line after the first moves in by that much, leaving the number standing out at the left. Set Indent to zero as well and the number sits right at the margin, the way many publishers set their notes. A line after a line break, and any later paragraph of the same note, starts at that hanging indent too, so only the number stands out. Leave Hanging Indent at zero for the Chicago layout. Number Width sets how wide that slot is, and applies to Column only. It is a fixed measure that you choose, rather than something Inkwell works out from the numbers themselves — which matters most with Roman numerals, where a chapter that reaches xxxviii has far wider numbers than one that stops at viii. A number too wide for its slot reaches back into the indent rather than pushing the note text across, so the text column stays put throughout the section. If you would rather not think about the width at all, choose Run-in: with no slot, there is nothing to size. **Pasting notes from Word**: Copying a passage out of Word and pasting it into a chapter brings its footnotes and endnotes with it: each one arrives as an Inkwell footnote attached to the same place in the sentence, numbered by Inkwell rather than by Word. Endnotes come in as footnotes too — where a note is printed is a project setting in Inkwell, not something each note carries, so set the placement you want under Notes in Project Settings. Notes typed by hand as superscript numbers, rather than made with Word's footnote feature, paste as ordinary text; Inkwell has no way to tell them apart from the rest of the sentence. **Endnotes**: There is no difference in the way that endnotes are inserted into a book or article. An Open dropdown always sits at the bottom of the Chapters list, next to Insert, with a Notes item in it. Click it for a single page listing every footnote in the book, however it is placed, with a jump button that takes you to the place in the text it belongs to and an editor to change it right there. Navigate to the Chapters view along the left menu bar. Opening Notes this way is only for reviewing and editing your footnotes — it doesn't change where they appear in the built book. To make endnotes appear as their own section at the back of the book or article, click on the Insert button at the bottom of the Chapters List, then click Notes. Inkwell will automatically configure your Notes section based on the settings that you have already defined, and set Placement to Book Endnote. Once that section exists, it also gets its own permanent entry directly in the Chapters list — the Open dropdown's Notes item is always there too, and opens the same page either way. **Chapter headings in the Notes section**: The Notes section groups its notes by chapter, each group under a heading carrying that chapter's title. Those headings are styled under Chapter Headings, which you will find in two places: in Project Settings under Notes (once Placement is Book Endnote), and in Local Settings while the Notes section is open. Chapter Headings has the same controls as any other heading — font, size, small caps, alignment, margins, numbering, Balance Lines, and the heading template. Until you change them, every one follows your Section heading style (Project Settings, under Headings), so the notes headings match the section headings in your chapters. A book whose sections are unnumbered therefore gets unnumbered notes headings; tick Numbered here to head each group "1. The Chapter's Title" without numbering the sections themselves. A chapter that has no number of its own, such as a preface in the front matter, keeps an unnumbered heading either way. A control you have changed shows a reset button beside it, labelled with the Section value it would go back to; click it to follow the Section style again. The button at the top of the panel, next to Back, takes you to the Section heading settings themselves. A change made there reaches every notes heading you have not changed here. **A second family of notes**: Everything above describes one set of notes. Inkwell keeps a second, independent set called annotations, numbered and placed separately, so a scholarly edition can run author's notes at the foot of the page and editorial notes at the back of the book without the two sequences colliding. Clicking a note's marker moves it between the two families. See Annotations. ### Annotations **Annotations**: Inkwell keeps two independent families of notes. The first is the ordinary one covered in Footnotes/Endnotes. The second is called annotations, and it is numbered, placed, and styled entirely separately. This is what scholarly editions need. It lets you run, say, author's notes at the foot of the page while textual or editorial notes collect at the back of the book, without the two sequences interfering with each other. **Turning a note into an annotation**: Annotations are not inserted with a separate button. Create the note as usual with Insert Footnote , then click the note's marker — the small number or symbol in the text. Clicking it moves the note between the two families; click again to move it back. With Inline Notes on in the Tools menu, the number shown beside the note's text in the chapter does the same thing, so you can move a note between the families while looking at what it says. Because the two families are numbered separately, a note will change its number as it switches sides. **The annotations section**: The Open dropdown at the bottom of the chapter list (next to Insert) always has an Annotations item. Click it for a single page listing every annotation in the book, grouped by chapter, which is a convenient way to read through them all. Each entry has a jump button that takes you to the place in the text it belongs to. This is available regardless of the Placement setting below or whether the book has any annotations yet. To make annotations appear as their own section in the built book, add the section: Insert → Annotations in the chapter list. It works exactly like the Notes section — Inkwell fills it in, keeps it up to date, and sets Placement to Book Endnote for you. Once that section exists, it also gets its own permanent entry directly in the chapter list — the Open dropdown's Annotations item is always there too, and opens the same page either way. **Settings**: Project Settings → Annotations carries the same controls as Notes, applied to this family only: Placement — Footnote (at the bottom of the page), Chapter Endnote (collected at the end of each chapter), or Book Endnote (collected at the back of the book). This is set for annotations alone: annotations start at the bottom of the page and stay there when you move the ordinary notes elsewhere. To collect them at the back of the book, choose Book Endnote here, which adds the Annotations section for you. Hidden takes every annotation out of the built book without deleting any; see Hiding notes. Marker — the numbering scheme, plus Marker Size and Marker Baseline for how the marker sits against the surrounding text. Name — what the section is called in the built book. Layout of the note text itself: Clearance, Gap, Indent, and Font Size. Setting the two families to different placements and different marker schemes — numbers for one, symbols for the other — is what makes them readable side by side. **The section's own title**: The Annotations section is titled independently of the Notes section. Click its entry in the chapter list and edit the title there, exactly as you would for Notes — a book can head one "Notes (Original)" and the other "Annotations (2026)" and the built book will honour both. Everything else the section carries is its own as well: its headpiece and tailpiece, how many columns it sets in, and whether the title prints at all. The headings over each chapter's group of annotations are styled under the Annotations section's own Chapter Headings, apart from the Notes section's; both start out following your Section heading style, as described under Footnotes/Endnotes. The same is true of the note layout itself. Number Style and Number Width — described under Footnotes/Endnotes — are set here for annotations alone, which matters when the two families number differently. A chapter with several dozen annotations in lowercase Roman numerals produces much wider numbers than the ordinary notes ever will. ### General Project Settings **General Project Settings**: Project Settings on the left rail holds the defaults for the whole book. Anything set here applies everywhere unless a Local Setting overrides it for one particular paragraph, table, or figure. The panel is a list of sections; several have their own chapter in this tutorial. **Template**: Change Template swaps the book's design, and the Sections list below it lets you leave out individual parts the template supplies. See Templates and Boilerplate. **General**: Project-wide document settings: Watermark — text stamped across every page, for drafts. Cover and Back Cover — cover pictures, for a book without a cover design. A design made in the cover designer takes their place in every export. Template — turn this project into a publishable template. **Page Layout**: The physical shape of the book: Page Width and Page Height Top Margin and Bottom Margin Inside Margin and Outside Margin — inside is the binding edge, so these swap over between left- and right-hand pages Header Ascent and Footer Descent — how far the running head and foot sit into the margin Bleed — extra area beyond the trim edge for images that run off the page; your printer will tell you what they need Font Size — the base size everything else is measured against **Paragraphs**: Every built-in paragraph style, each with its own settings, plus any custom styles you have created. See Paragraphs and Other Content Styles. The Language of the Paragraph style is the language of the whole book: it decides how words are hyphenated, the language the ePub declares, and the words citations are written with. See [A book written in another language](paragraphs-and-other-content-styles.mda-book-written-in-another-language). **Custom Text Styles**: Character-level styles you define yourself and apply to selected text — a font for quotations, a colour, a highlight. Each can be renamed and given a full font treatment. Useful when the same treatment recurs throughout a book, because changing the style updates every use of it. **Links**: How hyperlinks are rendered in the built book: colour, font, size, underline. Bibliography DOIs and URLs use it too, when Link DOIs and URLs is on. **Table of Contents and List of Figures**: Layout and formatting for the two generated listings. See Table of Contents. **Headings**: One subsection per heading level — Part Title, Chapter Title, Section, Subsection, and Subsubsection — each with its own numbering, fonts, spacing, and layout. There is also a setting to restart chapter numbering under each part. See Chapter Titles, Parts, and Section Headings. **Appendices**: How the appendices after the body are lettered. An appendix is styled like a chapter — the fonts and spacing come from Chapter Title above — so only the counting is set here: Numbered — whether appendices are lettered at all. Numbering — the scheme. Alphabetic (Uppercase) by default, which gives A, B, C. Label — the word printed before the letter, "Appendix". This is also what you type to reference one, so renaming it to "Annex" changes both. Separator — what comes after the letter, before the title. ". " by default. Label in Contents — the word used in the table of contents entry, which can differ from the one on the page. See Chapter Titles, Parts, and Section Headings. **Page Numbers**: Enabled — whether page numbers appear at all. Roman Numerals for Front Matter — numbers the front matter i, ii, iii and restarts at 1 for the body, which is the usual convention for books. Start At — the number on the first numbered page, any whole number from 0 up, for a volume that continues the paging of an earlier one, or a section printed on its own. With Roman Numerals for Front Matter on it is the body that starts here instead, and the front matter still runs from i. Left- and right-hand pages follow the number, so starting on an even one puts the wide binding margin where that page expects it. Position — where on the page they sit. **Margin Mark**: A mark running up the outside of every page — a journal abbreviation, a series name, a small logo. Edit Template opens the same editor the running heads use, so the mark can be literal text, a variable such as the book title or the page number, an image, or a mix. Edge — Outer keeps the mark on the outside of the page, so it swaps sides between left- and right-hand pages the way the running head does. Inner puts it on the binding side instead, and Always Left / Always Right pin it to one physical side. Vertical Position and Distance From Top — where along the edge it sits. With the position set to Top or Bottom the distance runs from that edge; with Center it runs from the middle of the page, and 0 leaves the mark centred. Reading Direction — whether the text reads downwards or upwards. Distance From Edge — how far in from the trimmed edge of the paper. Both distances are measured from the trim, which is the edge the reader sees, so a book with a bleed needs no arithmetic of its own. The mark prints on every page, including full-page images, but not on the cover. It is a printed-page feature: an EPUB has no margins to put it in, so it appears in the PDF only. **Replacing the variable in the template**: The template opens with the book's title already in it, as a variable — a chip with a dashed border rather than ordinary text. A chip is a single object: click it and it is selected whole, and the next thing you type replaces it. So to put your own words in the margin, click the chip and type. To swap it for a different variable, click it and pick one from Insert → Variable in the toolbar. A margin mark can hold the book title, the chapter title, the part title, the page number, and any variable you have defined on the details page — an ISSN, a series name. A variable you have defined but not yet filled in prints nothing, rather than an error. A chip naming something the template cannot fill in is underlined in red in the editor and prints as [Invalid variable: …] on the page; that happens when the variable it names has been deleted. **Headers and Footers**: Running heads and feet are laid out in a template. Edit Template opens a small editor showing the header and footer as they will appear, and you lay them out directly — typing fixed text and dropping in variables such as the chapter title, the book title, or the page number. This is why it is worth defining variables on the details page: they can be placed into the running head here rather than retyped. A running head takes the same variables a margin mark does, and warns about a chip it cannot fill in the same way — see [Replacing the variable in the template](replacing-the-variable-in-the-template) above, which applies to this editor too. The template is laid out in three slots across the page: one at each edge and one in the middle. The middle one sits on the centre line of the page and stays there, so a running head placed in it lines up with itself on left- and right-hand pages no matter how wide the page number beside it grows. The two edge slots share whatever is left over. Even and odd pages each have their own row, for the header and again for the footer, and the two are always separate: a book title on the left-hand page and a chapter title on the right is just a different variable in each row. There is no switch for turning running heads on or off. A row prints whatever its slots hold, so to turn a running head on, put something in a slot; to turn it off, empty the slots. Articles and notes start with the header slots empty, which is why a new article has no running head until you add one here. The Headers and Footers settings under Chapters decide whether a chapter prints the template at all, so a chapter with Headers off stays bare however full the template is. A chapter's opening page has no running head unless Header on Opening Page is on. **Chapters**: What happens at a chapter boundary: Show Chapter Title — whether the title is printed. New Page — run straight on, start on a new page, or start on the next even or odd page. An article's chapters run straight on whatever this says, so that a paper cannot be restyled into a book. Appendices and the generated pages — bibliography, contents, notes, indexes and lists — honour it in an article too. A generated page starts at No New Page there, so give the bibliography New Page in its own settings when a journal starts its references on a fresh page. Columns — the number of text columns. The title sits over the first of them unless Full Width is on in its heading style; see A title across two columns. Column Gap — the space between columns, in em (the size of the body text). Left empty, it is 4% of the width of the text block. Like Balance Columns, a change takes effect at the next page break or change in the number of columns, so a chapter that runs straight on from the last one keeps the gap it started the page with. Balance Columns — where the text runs out partway down a page, share what is left evenly between the columns instead of filling the first and leaving the others short. It evens out the last page before a page break or a change in the number of columns, so in a chapter that runs straight on from the last one with the same columns, it waits for the next such break. Flush Bottom — when a heading, an equation or a figure kept in the text doesn't fit at the foot of a column and moves on to the next, stretch the space between that column's paragraphs, headings and equations so its last line still reaches the bottom of the page, as journals typeset in LaTeX do. The space between lines is never stretched, and no gap is stretched to more than twice its usual size: a column that would need more than that is left short. A column that ends with the chapter, at a page or column break, or on a page evened out by Balance Columns is never stretched. Like Balance Columns, it takes effect at the next page break or change in the number of columns. Drop Cap — an enlarged opening capital, two lines deep: its top lines up with the tops of the capitals in the first line and it sits on the second line's baseline. Every letter is set at the same size, so an O or an A is no smaller than a T, and a Q or J may dip below the line as it does in running text. It takes the weight and slant of the words it opens, so a chapter that begins in bold or italic drops a bold or italic letter. Generated pages — the contents, notes, bibliography, indexes and lists — don't take it; each has its own Drop Cap setting if you want one there. A chapter that opens in a script without capitals — Arabic, Hebrew, Chinese and the like — is set without one. Headers and Footers — whether running heads and feet appear on a chapter's pages. Header on Opening Page — print the running head on the page a chapter or section opens too, instead of leaving that page without one as books do. A journal carries its head on every page after the first, so its references, starting a page of their own, need it on. Headpiece and Tailpiece — decorative images at the start and end of a chapter. Once set, they appear faded in the editor above the title and after the last paragraph, so you can see at a glance which chapters carry one. Click either to open that chapter's own settings for it, where you can change or remove it for just that chapter. When a chapter ends in an ordinary paragraph, its tailpiece never sits alone at the top of a page in the PDF: the paragraph's last line moves over with it. A headpiece's Placement is Block (above the title) or Background (across the whole page behind the title). On a chapter that starts its own page, a Block headpiece's Space Above is measured from the top edge of the page, not from the top margin, so a value smaller than the margin puts the image up in it, like a journal's label and logo on an article's first page. Space Below is the gap between the image and the title, which can then start above the margin too; left at 0, the gap is the usual 1.5em. Both placements work the same in a two-column chapter. With no image, a headpiece can be a Rule instead: a horizontal line of the thickness you give, in points, across Width of the text block. It is placed like an image, so on a page of its own a two-column section gets one line spanning both columns, Space Above from the top edge of the page — the line a journal draws over its references. **Notes, Annotations**: The two independent note families, each with its own placement, markers, and layout. See Footnotes/Endnotes and Annotations. **Citations**: Citation Style — the CSL style used for citations and the bibliography. Condense Subsequent Citations — after the first full citation of a work, use the shortened form. See Citations and Bibliography. **Other Scripts**: Most fonts cover a handful of alphabets at most. When your book quotes something its fonts cannot draw — a line of Chinese, a word of Greek or Hebrew, an Arabic title — Inkwell sets those characters in a font made for them, chosen to suit the font around them: a serif font gets a serif companion (Noto Serif SC for Chinese, Noto Naskh Arabic for Arabic), a sans-serif font a sans-serif one. Where a font family has its own version for that alphabet, such as IBM Plex Sans Arabic beside IBM Plex Sans, that version is used. Only the characters the font is missing are affected; everything it can draw stays in your chosen font. Chinese characters are drawn differently in different regions. Inkwell uses Japanese forms if your book contains Japanese kana, Korean forms if it contains Korean hangul, and Simplified Chinese otherwise. This section lists each alphabet your book uses that its main font cannot draw, with the font Inkwell picks for it. To choose a different one — Traditional Chinese, say, or a particular Hebrew face — click ... next to it and pick a font; the reset button beside your choice goes back to automatic. A font chosen here is used for that alphabet throughout the book, in every style. **Math, Figures, Tables, Lists**: Defaults for each kind of content: equation numbering; figure captions, labels, and float behaviour; the default table style preset and float settings; and the numbering and alignment of Numbered Lists and Bullet Lists. Each has its own chapter. ### Local Settings **Local Settings**: Local Settings on the left rail changes whatever is selected right now, overriding the project-wide default for that one thing. The panel is context-sensitive: put the cursor in a paragraph and you get paragraph settings; select a table cell and you get cell settings. If nothing looks relevant, check what you have actually selected. **Overrides, defaults, and Reset**: Every setting here starts out inheriting from Project Settings. Changing one makes it a local override for this element only. Two affordances go with that: A Reset button appears beside any setting you have overridden. It drops the override and returns the element to the project default, showing that default next to the button so you can see what you are reverting to. Each section links through to the corresponding section of Project Settings, so if you find yourself making the same override repeatedly you can go and change the default instead. That is usually the right move — local overrides are for exceptions. **Chapter**: Selected when the cursor is in a chapter but not in anything more specific: Scratch — exclude this chapter from the built book. It stays in the project as a scratchpad and is marked in the chapter list. The chapter's ⋯ menu in the list has the same Scratch switch; see Managing Chapters. Part — make this chapter a part divider rather than a chapter. Boilerplate — mark it as template-supplied. Preserve in Template — keep it when the template changes. Custom Number — override the automatic chapter number. Appendices letter themselves, so this is for the odd chapter that needs a number of its own; see Chapter Titles, Parts, and Section Headings. Navigation Label — a shorter title for the chapter list, when the real title is long. **Paragraph**: The most-used section. Available for paragraphs, headings, blockquotes, lists, and display math: Alignment — left, right, centred, or fully justified. Font, Font Size, Line Height — increase line height for double spacing. Bold and Italic — applied to the whole paragraph. Indent — indent the first line. Hanging Indent — indent every line except the first. A line break (Shift+Enter) starts a new line flush with the first, so only lines that run on are indented. Top Margin / Bottom Margin — space before and after this paragraph. Top Group Margin / Bottom Group Margin — space before and after a run of consecutive paragraphs sharing the style, rather than around each one. Inset — narrow the paragraph, adding space on both sides. Keep With Next — prevent a page break between this paragraph and the one after, which is how you stop a heading being stranded at the foot of a page. Hyphenation — Never keeps this paragraph's words whole, Always lets them break whatever the alignment, and Auto hyphenates it only when it is justified, as described in Paragraphs and Other Content Styles. Language — the language the paragraph is written in, for a quotation in German or Latin in an English book. See Passages in another language. **Headings**: Headings get the paragraph settings above plus their own numbering options, labelled by level so you can see which one you are changing. **Tables**: Selecting inside a table offers four separate sections: Table Row, Table Column, and Table Cell — font, alignment, vertical alignment, rotation, margins and borders at each level, plus the column's Width and the cell's Leader. Select a range of cells and each section applies to all of them: every cell, every row you touched, every column you touched. Table — the style preset, plus Borders (all cells) and Shading (all cells) for changing the whole table at once. See Tables. **Equation**: Numbered — whether this particular equation gets a number, regardless of Number Equations in Project Settings → Math. **Image and Figure**: For an inline image, a Size setting. For a figure: Width — as a percentage of the text width. Bleed — let the figure run into the margin, off the page edge, onto a page of its own, or across a two-page spread. Hide caption and Hide label — suppress the caption text or the "Figure 3" label. Caption Position — above or below. Automatic Placement — let Inkwell move the figure to where it fits best, rather than pinning it exactly where it sits in the text. This is also what decides where a two-page spread lands. Both panels also offer conversion between the two: Convert to Figure and Convert to Inline Image. See Figures and Images. Cropping, rotating and flipping are not here — they live on the toolbar that appears when a picture is selected. See Cropping. **Lists**: Ordered List and Bullet List sections carry the numbering format, markers, and alignment for the selected list. **Text**: With text selected — rather than just a cursor in it — a Text section appears with the full font panel, applying to the selection only. This is the escape hatch for one-off character formatting that no style covers. Its Language marks a few words as being in another language, so they are hyphenated by that language's rules. ## Tutorial: Advanced Features ### Citations and Bibliography **Citations and Bibliography**: **Citations**: Inkwell offers citation functionality. It can format your citations according to a wide variety of styles and build out your bibliography. Citation information can be entered automatically, fetched from external databases, or pulled from your citation manager. To insert a citation, place your cursor after the text the citation will refer to, then click on the Insert Citation button in the menu bar. A pop-up appears. Search for citations by: DOI Web address Search terms If you enter search terms, Inkwell will search the database from your citation manager. For best result, we recommend integrating with a citation manager. We support both Zotero and Mendeley. If you do not have an account with either provider, click on the Zotero and Mendeley links to sign up for the appropriate account. Once you have the account, click the appropriate link button. If you click the Zotero button a new window will open, requesting that you create a New Private Key. Inkwell will show in the Description box. Click the Accept Defaults link. If you click the Mendeley button, you will be prompted to sign into your Mendeley or Elsevier account. Once you have signed it, you will be redirected back to Inkwell. Once you see the success message, close the window and return to your document. To insert a citation from your citation database, simply search for the paper: Click the desired paper, the save button, or push enter to insert the citation into your document. If the resource that you want to cite is unavailable from any of your sources, you can insert it manually using the “Manual Citation” button. The citation will be inserted as a footnote in the editor. For citation styles that do not call for the use of footnotes, it will still be shown as a footnote in the editor, but not in the preview and output. To see the details of the citation click on the footnote number. If there is already a footnote where you are inserting the citation — the cursor sits right before or right after an existing footnote number — the citation is added to that footnote rather than creating a second one beside it. Changing to a citation style that calls for footnotes does the same: a citation standing next to a footnote moves into it. Several citations in the same place are always one footnote, and the citation style supplies the punctuation between them. Copying text with a citation in it copies the citation as it is shown, so pasting into Word or an email gives the formatted citation, such as "(Smith 2020, 12)". Pasting it back into Inkwell gives you the citation itself, which keeps following your citation style. To copy just the words of a citation, drag across them, or double-click to select them all. In order to modify the details of a citation, click the “Edit Citation” button: . There is a blank space between the citation text and the period. This is to enter in a specific location in the book, such as a page number. Once a citation manager is linked, Inkwell says Currently integrated with… in the citation dialog, and a Disconnect button lets you unlink it again. The library is refreshed in the background while you work, so citations you add in Zotero or Mendeley become available without reloading Inkwell. Items you move to the trash or delete there drop out of the search as well; citations already in your book keep their details. For a whole chapter's worth of this at once, The Agent reaches the same sources — your library, a DOI or web address — and can find and insert citations, or check the ones already in the book, as tracked edits you review afterwards. **Citation style**: The style used for both citations and the bibliography is set under Project Settings → Citations: Citation Style — pick from the CSL styles. Changing it re-formats every citation and the whole bibliography at once. Condense Subsequent Citations — after a work's first full citation, use the shortened form for later references to it. Link DOIs and URLs — make each entry's DOI and web address a link, the DOI to doi.org. They take the colour, font and size of the Links style, so a journal's orange DOIs are set there. A doi: label in front of the DOI is linked with it. **Bibliography**: Add a bibliography with Insert → Bibliography in the chapter list. It collects every citation in the project automatically and keeps itself up to date. Its heading starts out as "Bibliography". To call it something else — "References", "Works Cited" — click the heading on the bibliography page and type the new one. The bibliography page also gives you per-entry controls: Edit Citation — correct or complete an entry's details. Replace Citation — re-source the entry from your citation manager or Semantic Scholar, which is the fix when an automatically fetched record turns out to be wrong. A link out to the entry's original source, when it has one. **Project settings for bibliography formatting**: The appearance of bibliography entries is a paragraph style: Click the Project Settings button Click Paragraphs Click Bibliography Entry A hanging indent, set here, is what most styles expect. Some numbered styles put each entry's number in a column of its own, with the entry's lines lined up beside it. There the numbers are right-aligned, and the hanging indent is not used: the number column does that job. The rest of the style — font, size, line spacing — applies to the numbers and the entries alike. **Entering a Manual Citation**: To insert a citation, place your cursor after the text the citation will refer to, then click on the Insert Citation button in the menu bar. Click the Manual Citation button in the pop-up. A citation entry screen will pop up. Click the dropdown next to Type to choose the correct entry type. Complete all necessary fields for your entry, then click the Save button in the bottom right corner of the pop-up. ### Index **Index**: Add an index with Insert → Index in the chapter list. Opening it gives you the index management page. This is the general, topical index, and its entries are the ones you choose. A book can have more than one index — see More than one index below. Scripture references are handled separately and automatically — see Scripture Index. Across the top is a row of tabs: a + tab for adding entries, and then one tab per initial letter once you have entries, plus a % tab for anything that does not start with a letter. The letter tabs are how you review a large index without scrolling through all of it. **Building an index with AI**: If the book has no entries yet, the page offers Build index using AI. There are options for whether to index front matter, back matter and footnotes. Reading a whole book takes a while, so the build runs in the agent panel where you can watch it and stop it at any point; see AI Tools. **Adding entries by hand**: The + tab has an Add Index Entry box. Type a word or phrase and Inkwell searches the book for it. An apostrophe or quotation mark in a term matches either the straight or the curly form, so O'Brien finds O’Brien in the text and you need not worry which one the prose has. What you do with the matches is then up to you: Create new index entry files them all under that phrase, Create new index subentry puts them under a subheading of an entry you already have, and Merge into existing entry adds them to one. Nothing is indexed until you choose. Add Multiple Entries takes a list — one entry per line — and adds them all at once, which is much faster than typing them one at a time when you are working from a prepared list. **Working with an entry**: An entry is one line with two buttons on the right: Show Entries — every place in the book the entry occurs. Show Actions — everything you can do to the entry. They are alternatives: opening one closes the other, so neither list ever buries the other and the entry you are working on stays in view. **Where it occurs**: Show Entries lists the chapters the entry appears in, and opening a chapter lists the occurrences inside it, each with a checkbox. Clear a checkbox to drop that occurrence from this entry — this is how you deal with a word that appears in passing in places that are not worth indexing. If the same phrase is also indexed under another entry, that one stays. A long list runs off the bottom of the screen, so there is a second Hide Entries button at the foot of it as well as the one in the entry's own row. Either one closes the list and leaves the entry where you can see it. **What you can do to it**: Modify index entry holds the entry's name — change it and every occurrence follows — and a Note field for a cross-reference such as see also. The name can be formatted; see Italics and subscripts in entries below. Move to new index subentry files everything the entry holds under a subheading of another entry, so one entry can be broken down by topic. Merge into another entry and Split off occurrences are below. Remove index entry takes it off the whole book. **Italics and subscripts in entries**: Latin phrases, species names and titles of works are usually printed in italics in an index, and a chemical formula such as C₅₀H₁₀₂ needs its subscripts. An entry prints plainly unless it has been formatted. Italics in your text are not carried into the index, because a word that is italic in a quotation or for emphasis should usually be plain there. To format an entry, open Modify index entry and select part of the Name. Then use Italic, Subscript or Superscript on the toolbar at the top, as you would in a chapter, and press Update. The name keeps only those three; any other formatting is dropped. Formatting a name formats it everywhere in that index: as an entry, and as a subentry under another entry. Build index using AI formats the names it creates. It italicizes titles, species and foreign terms, and gives formulas their subscripts. Check its choices here and change any you disagree with. The formatting shows on the index page as well, so you can check it without building the book. **More than one entry on the same phrase**: A phrase can belong to more than one entry. Adding "Philosophers, Greek" to a passage already indexed under "Socrates" adds a second entry rather than replacing the first, and the passage turns up under both in the printed index. Entries on one phrase have to differ, though — adding an entry that is already there changes nothing. When the cursor is inside a phrase carrying several entries, the index toolbar shows an Entry and Subentry row for each one, so you can edit them separately. **Merging entries**: Merge into another entry moves everything an entry holds onto an entry you pick. Useful for singular and plural forms, or different spellings of the same name, that should share a single index entry. **Splitting an entry**: The opposite job: one entry has collected passages that belong under two different headings — "hell" filed in among "judgment", say. Split off occurrences divides it. It lists the entry's occurrences with the sentence around each one, and you tick the ones to move. Name the entry they should move to — an existing one or a new one — and press Split. Everything you did not tick stays where it is. Reading the passage is the point: a word on its own rarely tells you which occurrences belong together, and the ones you want to move often say exactly the same thing as the ones you do not. **Starting over**: Clear Index, on the + tab, removes every entry — the way to begin again after an AI build that did not suit you. **The title above two columns**: An index in two columns prints its title over the first column. To centre the title across the page with both columns starting below it, see A title across two columns. **More than one index**: Some books print a separate Index of Names beside the general index, or an Index of Places. Once the book has an index, Insert → Additional Index… in the chapter list adds another. Give it a name, such as Index of Names; that name becomes the section's title. Each index has its own entry in the chapter list, and clicking one opens that index's page. Everything on the page — adding entries, the letter tabs, Build index using AI, Clear Index — works on that index alone. Each index also has its own title, columns and other section settings. The indexes are independent. A passage can be in two of them at once: Augustine in the Index of Names and in the general index under grace. The same name can also be an entry in both, and each index keeps its own page numbers, italics and notes for it. An entry filed in the wrong index can be moved with Move to another index in its actions. Every occurrence goes with it, along with its subentries, italics and note. Removing an index from the chapter list keeps its entries. It then appears in the Insert menu under its own name, and inserting it there brings it back as it was. **Index entries in the text**: Index markers can be shown or hidden in the editor with Tools → Index Entries. You can also mark a specific piece of text as an index entry directly with the Index Entry button on the toolbar, rather than matching on a word throughout the book. Pressing that button on a phrase that is already indexed clears every entry from it. To remove just one of several, use that entry's occurrence checkbox on the index page. The Entry and Subentry boxes that appear suggest the entries already in the book as you type, so a passage lands under the entry you meant rather than a near-miss spelling of it. They are not a closed list, though — type something new and it becomes a new entry. Left empty, Entry files the passage under the marked words themselves, which is what the box's grey text is showing you. In a book with more than one index, an Index box comes first and says which index the passage is filed in. A new mark goes into the general index. Choose another index from the box and the Entry suggestions switch to that index's entries. ### Scripture Index **Scripture Index**: Add an index of scripture references with Insert → Scripture Index in the chapter list. It goes in the back matter, alongside the Index rather than inside it. Unlike the general index, there is nothing to build and nothing to tag. Inkwell reads the references out of your prose every time it renders the book, so the index is complete the moment you insert it, and it stays correct as you write — add a citation to a chapter and it appears; delete the sentence and it goes away. Inkwell only looks for references once you have added the section. Adding it nudges the typesetting a little: each reference becomes a marker in the text, and the spacing on lines that contain one is adjusted very slightly to absorb it. Lines break in the same places and words move by well under a hundredth of an inch, so you are unlikely to see it — but it is a real change to the printed pages, which is why nothing happens until you ask for the index. Opening the section shows you what the index currently contains. Page numbers appear once the book has been rendered, since that is the only way to know what page anything landed on. **How it is arranged**: Entries are grouped by book of the Bible and ordered by the canon — Genesis through Revelation — not alphabetically. Within a book, references are in scriptural order, so 3:1 comes before 3:15, and a reference to the whole of chapter 3 comes before both. The reference and its page numbers sit in two columns, with the page numbers of every entry in the index starting at the same place. Both are runs of numbers, and a reader who met them as one list — 1:1, 45, 67 — would have to work out where the verse ended and the pages began. A reference cited many times is one entry with many page numbers. References inside footnotes are indexed too, and are listed by the page the note is on. They carry no 56n1 note marker: unlike a topical entry, a scripture reference is already a pair of numbers, and a third pair beside it reads as more reference. A verse you cite in the text and again in a note on the same page therefore appears once. **What Inkwell recognises**: Full book names and the common abbreviations, with or without a trailing period: John 3:16 Gen. 3:15 1 Cor 13:4–7 — ranges, whether you typed a hyphen or an en dash Genesis 1:1–2:4 — ranges that cross a chapter Psalm 23 — a whole chapter, with no verse Mark 3:1ff — indexed as 3:1 John 3:16a — verse sections are kept Romans 6:6; 7:24; 8:13 — a list that names the book once indexes every reference in it Acts 17:18, 32 — a number after a comma is another verse in the same chapter, and after a semicolon, as in Isaiah 2:2–4; 60, another chapter Matching is case-sensitive, which is what keeps ordinary sentences like "the genesis of the idea" out of your index. **What it will miss**: A few things are worth knowing before you rely on it: References broken up by formatting. If the book name is italic and the numbers are not, Inkwell sees two separate pieces of text and finds nothing. Format the whole reference the same way. References without a book name of their own. A bare (8:57) that relies on the book under discussion is not indexed; only references that follow a named book in the same list are. Neither is a number followed by a word, as in John 3:16, 17 NRSV — the 17 could as easily be prose. Unusual abbreviations. 1 Jn, Mt and similar short forms are not in the list Inkwell matches against. Spell the book out, or use the longer abbreviation. **Watch for over-matching**: Because a chapter number alone is enough, an ordinary sentence that pairs a book name with a number will be indexed: "Numbers 3 was fine", "Job 1 of the series", "Mark 3 items". If your book uses those words in that way, check the index before you publish. ### Chapter And Verse **Chapter And Verse**: Inkwell can typeset scripture: chapter numbers set as large dropped numerals, and verse numbers as small raised figures through the text. This is what you want if you are producing a Bible, a New Testament, a lectionary, or any edition that quotes scripture at length with its numbering intact. This is a different feature from the Scripture Index, which finds references like "John 3:16" in ordinary prose and collects them into a back-matter index. This chapter is about setting the scripture itself. **Quoting a passage**: To quote a passage in any project, press Ctrl-E where you want it. Type a reference, such as John 3:16, Ps 23 or Gen 1:31-2:2, and pick a translation. The passage appears as you type. Press Enter or click Insert to add it as a Verse quotation, with the reference and translation in brackets after it. The translations are all public domain: World English Bible, King James Version, American Standard Version and Darby Translation. The World English Bible and the King James Version also include the apocrypha. Brenton English Septuagint, Brenton's 1851 English translation of the Septuagint, and Greek Septuagint, the Greek text he translated. These two contain the Old Testament and apocrypha only. The Septuagint versions use the Septuagint's own numbering, which is how the Septuagint is usually cited. Several references therefore differ from an English Bible: Psalms are mostly one number lower: the shepherd psalm is Psalm 22, not 23. A psalm's title counts as its first verse. Jeremiah has chapters 25 to 51 in a different order. Esther and Daniel are the longer Greek books. The Song of the Three Holy Children is part of Daniel 3. You can also cite Samuel and Kings by their Septuagint names, 1 to 4 Kingdoms: 3 Kingdoms 2:1 is 1 Kings 2:1. The Letter of Jeremiah is Baruch 6, as it is in the King James Version. **Turning it on**: Chapter and verse support is off by default, because almost no project needs it. Switch on Chapters and Verses under General in Project Settings — beside Template — and the toolbar buttons, the shortcuts, the \v/\c typing rules and a Chapters and Verses settings section all appear. Importing USFM switches it on for you. While it is off none of it is in your way — \v 3 is just text in an ordinary manuscript, and that is what it stays. Markers already in a document keep printing either way; the switch governs how you add them, not whether they appear on the page. **How a Bible is arranged**: One book of the Bible is one Inkwell chapter. Genesis is a single chapter in your project, containing all fifty of its chapter markers. Bible chapters are markers inside the text, not Inkwell chapters of their own — a Bible chapter runs on down the page where an Inkwell chapter starts a new one. So a complete Bible is a project of sixty-six chapters, one per book, with Genesis, Exodus and the rest listed in the chapter sidebar. **Importing from USFM**: If your text comes from Paratext or any other translation project, it is already in USFM, and you should import it rather than retype it. Choose Upload File from the import menu and select your .usfm or .sfm files. You can select all of them at once. You can do this either way round: into a project you already have, or from the New Project dialog, which offers the same import menu and starts the project from the files you pick. Inkwell reads the \id code in each file and puts the books in biblical order, so it does not matter what order the file picker hands them over in. Each file becomes one chapter, named from the book's \h or \toc1 line. The import brings across: chapter and verse markers (\c, \v), exactly as numbered in your text paragraphs (\p, \m, \pi) and poetry lines (\q1 through \q4) section headings (\s1, \s2) and major section headings (\ms) psalm descriptive titles (\d) and speaker labels (\sp) translator's footnotes (\f), and cross-references (\x) as annotations the divine name (\nd) in small caps, supplied words (\add) in italics, quoted scripture (\qt) and transliterations (\tl) the words of Christ (\wj), emphasis (\em), Selah (\qs) and an epistle's signature (\sig), each as a text style you can restyle word-level tagging (\w ... \w), whose Strong's numbers are dropped and whose words are kept Poetry, lists, psalm titles and speaker labels arrive as paragraph styles named Poetry 1, Scripture List 1, Psalm Title and so on. They are ordinary styles: change their indents and type in Project Settings and every line using them changes with it. Re-importing a revised book keeps your changes rather than resetting them. Four markers work the same way one level down, arriving as text styles named Words of Christ, Emphasis, Selah and Signature. They start out italic and are listed with your own under Project Settings → Custom Text Styles, so restyling one changes every span that uses it across the whole book. That is how you make a red-letter edition: import the New Testament, set Words of Christ to the red you want and turn its italics off. A plain edition and a red-letter one are the same import and one setting apart, so you can try it and change your mind. The rest keep their conventional look as direct formatting rather than as styles — the divine name in small caps, supplied words in italics. Those spans sit inside a \wj speech all the time, and direct formatting layers over the style around it where a second style would replace it: in \wj the \nd Lord\nd your God\wj, the divine name comes out in small caps and stays red with the rest of the sentence. Markers Inkwell does not handle are skipped and the rest of the file imports normally. **Marking chapter and verse by hand**: You can also add markers yourself, which you will want for a passage typed or pasted in. The toolbar's Insert menu gains Chapter Number and Verse Number, or use the keyboard: Ctrl+Alt+V inserts a verse number. It continues from the previous verse marker, so marking up a passage is one keypress per verse rather than typing each number. Verses are counted within their chapter, so the first verse after a chapter marker is 1 again. Ctrl+Alt+C inserts a chapter number, continuing from the previous chapter marker. Chapters run on through the book rather than restarting. Either way the cursor ends up just after the marker, so you can carry straight on typing the verse. If you are used to Paratext, you can also type the markers directly: \v 3 followed by a space becomes a verse marker, and \c 12 followed by a space becomes a chapter marker. Verse numbers are kept exactly as you enter them and are never renumbered. That matters for merged and split verses — 3-4 and 5a are both legitimate, and both survive untouched. A marker is deleted like any other single character: put your cursor just after it and press backspace. **Settings**: The Chapters and Verses section appears once the switch under General is on. For chapter numbers: Style: Dropped sets the number large, sunk into the opening lines of its paragraph, as most printed Bibles do. Raised and Inline set it in the run of text instead. Hidden omits it, for an edition that prints verse numbers only. Height (lines): how many lines of body text a dropped number spans. Two is conventional. The number is set in lining figures at the size a drop cap of that height would be — a capital as tall as the space from the top of the first line's capitals to the last line's baseline — so every chapter number is the same size, whatever its digits. Gap: the space between the number and the text beside it. Font, size, weight and colour, as for any other text. For verse numbers: Raise: how far the number sits above the baseline. Gap: the space between the number and the first word of its verse. Hide verse 1 after a chapter number: on by default. The chapter number already says where verse 1 begins, and the two numerals set side by side tend to read as a single number. Font, size, weight and colour. A chapter number can only be dropped when it begins its paragraph, since a drop needs lines to sink into. One that falls in the middle of a paragraph is set raised instead. A verse number always stays on the same line as the first word of its verse, so a number is never left stranded at the end of a line. You don't need to mark it as non-breaking yourself. **Two columns**: Most Bibles set two columns to the page. That is a per-chapter setting rather than part of this feature — see Columns under chapter settings in General Project Settings. Turn on Balance Columns beside it so that a book ending partway down a page, before the next one starts on a new page, ends with its columns level rather than a full left column and a short right one. ### Advanced Formatting Features **Advanced Formatting Features**: The toolbar carries a number of tools that do not come up every day but solve specific typesetting problems. The rarest of them are gathered in the Insert menu, so they are there when you need them without crowding the toolbar the rest of the time. **The Insert menu**: The Insert button, at the far right of the toolbar, opens a menu of things to put at the cursor: Symbol… — dashes and unusual spaces; see Insert Symbol below. Page Break and Vertical Spacer — see below. Chapter Number and Verse Number — only in a scripture edition; see Chapter and Verse. Document Property — see below. Variable — shown when Tools → Boilerplate is on; see below. Split Chapter Here — moves everything from the cursor on into a new chapter; see Managing Chapters. **Clear Formatting**: Strips character formatting — bold, italic, custom text styles — from the selection, leaving the text and its paragraph style alone. The quickest way to normalise text pasted in from somewhere else. **Text styles**: Beside the paragraph-style dropdown is a text style dropdown. Where a paragraph style governs a whole paragraph, a text style is a named character style you apply to a selection — a font for quotations, a colour, a highlight. Choose (New Text Style) at the bottom of the dropdown to define one. Defining a style rather than formatting by hand means you can restyle every use of it later from Project Settings → Custom Text Styles. A text style has the same font controls as a paragraph style, Weight included. Weight appears for a font with faces between Regular and Bold — a Semibold or a Medium — and lists only the weights the font has; an uploaded font counts, once its Semibold file is uploaded alongside the others. The Text section of Local Settings offers it too, which is how a running head sets its page number in Semibold: open the header template, select the Page Number, and pick the weight there. **Document Property**: Insert → Document Property gives the chapter a Short Title, Subtitle or Author line, placed under its title. The short title is what the running heads print in place of a full title too long for them. The subtitle and author print wherever the chapter-title template places the Subtitle and Author variables — useful for an edited collection where each chapter has its own contributor. The default template shows only the number and title, so add them to it first (see Changing how a heading is laid out); until then the lines are kept but not printed. Each can be added once, so an entry is greyed out when the chapter already has it. To remove one, delete the line. **Variable**: Insert → Variable, shown when Tools → Boilerplate is on, drops in one of the book's variables — the ones you define on the details page, plus the author fields. Add a variable… at the bottom takes you to the details page to define a new one. Variables are what make running heads and repeated title-page information maintainable — see Book and Article Titles. **Insert Comment**: Adds a comment anchored to the selection. Comments annotate the text without changing it, and can be marked with an emoji once dealt with. See Collaboration. **Vertical Spacer**: Insert → Vertical Spacer inserts an expanding vertical space. It grows to fill whatever room is left on the page, so it is the tool for centring an element vertically or pushing content to the bottom of a page. It only ever takes the room that is left over. On a page whose text already fills it there is no room left, so the spacer collapses to nothing — and if several spacers share a page they divide the leftover room between them. If what you want is a fixed, reliable amount of blank space — a write-in line, a form area, room to take notes — use empty paragraphs instead, since each one occupies a line height whether the page is full or not. Note too that the editor draws every spacer as a fixed-size icon, no matter how much space it will actually take in the built book. Check the built PDF rather than the editor to see what you really got. **Page Break**: Insert → Page Break forces the following content onto a new page. A page break only works in a chapter set to a single column, and outside lists. If the chapter's columns setting is more than one, or the break sits inside a bulleted or numbered list, it is dropped when the book is built — the editor still shows it, and nothing warns you. **Prevent Breaking**: Marks the selection as unbreakable, so Inkwell will not split it across a line or page boundary. Use it on things that must stay together: a number and its unit, a scripture reference. Initials need no marking. In headings, the table of contents and running heads, a name with initials stays whole: T. S. Eliot is never split across lines. In body text and notes, Inkwell follows the Chicago Manual of Style: a line never breaks between two initials or before a middle initial, so T. S. and John F. stay together, but it may break before the surname, which keeps justified lines from stretching to hold the name. The editor itself still wraps names freely; only the PDF and EPUB keep them together. **Insert Symbol**: Insert → Symbol… opens a table of characters that are awkward to type. Clicking one drops it in at the cursor. The first two are ordinary punctuation: En Dash (–) — number ranges, 1914–18. Em Dash (—) — the parenthetical dash. Typing -- produces one without opening this dialog; see Keyboard Shortcuts. The rest are spaces and invisible controls, listed here in the order the dialog shows them. The middle column is the label on the button, and it is also what you will see in the editor once the character is in your text — an invisible character would otherwise be impossible to find again. Character Button What it is for No-Break Space NBSP A space that will never break across a line: Mrs Dalloway, 10 km. Soft Hyphen SHY An invisible hint that a word may be hyphenated here. The hyphen appears only if the line actually breaks there. Zero Width Space ZWSP Allows a break with no visible space — a long URL, or a compound word. Zero Width Non-Joiner ZWNJ Stops two letters joining or forming a ligature. Zero Width Joiner ZWJ Forces a join where the script would not otherwise make one. En Quad ENQ Half an em wide. Em Quad EMQ One em wide. En Space ENSP Half an em wide. Em Space EMSP One em wide. Three-Per-Em Space 3EMSP A third of an em, the traditional thick space. Four-Per-Em Space 4EMSP A quarter of an em, the mid space. Six-Per-Em Space 6EMSP A sixth of an em. Figure Space FIGSP Exactly as wide as a digit, so columns of figures line up. Punctuation Space PUNSP As wide as a full stop. Thin Space THSP A fifth of an em — between nested quotation marks, or before a unit. Hair Space HRSP The narrowest space there is. Narrow No-Break Space NNBSP Thin and unbreakable: 20 000, or inside French guillemets. Medium Mathematical Space MMSP The spacing used around mathematical operators. Ideographic Space IDSP Full width, to match Chinese, Japanese, and Korean characters. Any of these characters that arrives by paste is shown the same way, so text brought in from elsewhere does not hide them. To get rid of them wholesale rather than one at a time, see Remove Soft Hyphens and Eliminate Unusual Spaces under Cleanup in Tools. Mathematics has its own Insert Symbol, which is a different dialog holding mathematical symbols rather than these. **Change Case**: Converts the selection to Title Case, UPPERCASE, lowercase, or Sentence case. ### Reviewing Changes **Reviewing Changes**: Whose writing the project marks as tracked changes is decided in the Users panel, a person at a time: anybody whose Changes there are Track or Suggest has their edits marked. There is one answer for the whole project: everybody on it sees the same changes marked, and accepting one settles it for all of them. **The review bar**: Working through the changes happens in the bar along the bottom of the editor. The left arrow and right arrow move to the previous and next change, crossing into other chapters when this one has no more. The green checkmark accepts the change the cursor is in, and the red cross rejects it. Beside them the bar counts the changes waiting across the book, with a chip for each person whose changes they are, in the colour their changes are highlighted in — or says No changes waiting. Changes your own AI agent made are counted separately — 3 changes waiting (1 from your AI), or 1 AI change to review when they are all there is — because reviewing them is between you and your agent, whatever the project tracks. While a book is still opening, the bar says Checking for changes… until it knows. On the right, a button says how many people's edits the project is tracking — 2 users tracked, say, or No users tracked. No users tracked means whatever your collaborators write goes straight into the text. If you are an administrator, clicking it opens the Track Changes wizard, which asks whose changes to track and sets it up for you. Anybody else gets the Users panel, to see who is tracked. **Settling one person's changes at once**: Click a person's chip to settle all of their changes together instead of one at a time. The menu offers Accept in this chapter and Reject in this chapter, for the chapter you have open, and Accept all and Reject all, for every chapter in the book. Each one says how many changes it covers. When their changes are in more than one chapter, Accept all and Reject all ask before going ahead. Undo works one chapter at a time, so you can't take back the whole book in one step. The menu settles only what you could settle with the checkmark and cross. If your role doesn't let you accept or reject someone's changes, its items are greyed out. A passage moved in from another chapter that can no longer go back where it came from is left waiting, as it is for the cross. The bar is always there, even with nothing to review, so you can tell at a glance whether anybody's edits are being marked. Comments are not part of this: they have their own icon in the left rail, with its own count and its own filters for narrowing which of them the manuscript shows. See Collaboration, where adding, replying to, approving and deleting comments is covered. **Seeing the edits**: Everything marked is shown as a tracked change, in the colour of the hand that made it; hover over a change to see who that was. Chapters that contain changes nobody has dealt with are marked in the chapter list. Your own AI agent is the exception to all of this. Its work is always pending for you, whatever the project has decided, and it is labelled as your AI rather than your own typing and shown in its own colour — so a passage you wrote and a passage your agent rewrote are never confused for one another. A collaborator's agent is not told apart from the collaborator, because from where you are sitting the two are one hand. See the agent panel. Not everything that changes a document is an edit to the text. Adding or removing an index entry marks a phrase for the index without altering a word of it, so it is not offered as a pending rewrite of that phrase. Formatting a passage, or changing a figure's settings, is shown as the change it is rather than as the passage being deleted and retyped — and accepting or rejecting one leaves any other edit made inside it alone. ### Tools **Tools**: The Tools menu in the top bar gathers everything that acts on the project as a whole rather than on the text under your cursor. From the top: Preview, Insert from my projects, Find & Replace, Cleanup and History; then four display toggles; then Users and API Keys. **Preview**: Preview toggles the typeset PDF pane on the right of the editor. It is on by default. Widen it with the arrow on the divider, or use the fullscreen button in its own toolbar. The preview and its controls are covered in Writing Content. **Insert from my projects**: Searches the text of every chapter in all of your projects and inserts a copy of a passage at your cursor. Useful for reusing a standard acknowledgement, an author biography, or a passage you are moving between books. Type a few words from the passage you want. Each matching paragraph is listed with the project and chapter it comes from. The jump button beside a result opens that chapter with the paragraph selected; adjust the selection to take more or less, then click Insert. Only what you selected is copied, and the original is left as it was. **Find & Replace**: Find & Replace has three modes, chosen at the top of the dialog: Find — find text. Replace — find text and substitute something else, one match at a time or all at once. Format — find text by its formatting rather than its content: everything bold, everything italic. This is how you track down inconsistent emphasis across a long manuscript. Each mode can be scoped to the current chapter or the whole Project. Results are listed by chapter, and a match inside a footnote carries a Note tag beside the chapter name. The jump button beside a result takes you to the matched text and selects it, opening the note first if that is where the match is. Typing next replaces the selected word, just as it would anywhere else in the editor. Ctrl/Cmd-F opens Find & Replace from anywhere in the editor, and Ctrl-H (Cmd-Shift-H on a Mac) opens it straight in Replace mode; pressed with the dialog already open, either one switches it to that mode. Ctrl/Cmd-Shift-F clears the current search. In Replace and Format mode, each match shows what it would become, with a button to accept the change and another to reject it. Rejecting leaves the text alone and drops the match from the list. To go through them from the keyboard, Alt-A accepts and Alt-R rejects the suggestion highlighted in yellow, then the highlight moves on to the next one (Option-A and Option-R on a Mac). The buttons' tooltips show the same shortcuts. Quotes and apostrophes you type into the Find and Replace boxes become curly, exactly as they do in the manuscript, so searching for don't finds don’t and replacing with it's writes it’s. To look for a straight quote instead — the sort that arrives with pasted text — paste it into the box rather than typing it, and it stays as it is. Cleanup, below, finds them throughout the manuscript. **Numbers and equations**: Find also looks at what Inkwell numbers for you. Searching for 16.4 finds equation 16.4 itself and every cross-reference that points to it, so you can track down each place the book mentions it. The same goes for section numbers and for figure and table labels such as Figure 3.2. A search can run across a reference and the words you typed around it, so Equation (16.4) finds the phrase as it reads on the page. Search goes by the numbers as they stand now: if equations are renumbered, the results follow. Find also searches the source of every equation, so \frac or \theta finds the equations that use them. Replace leaves numbers and equation source alone. Inkwell works out each number from where the item sits in the book, and you change an equation by opening it. In Replace and Format mode these matches have a dashed outline and no accept or reject buttons, and Replace All and Alt-A skip over them. **Commenting on a result**: The comment button beside the jump button leaves a comment on the match without leaving Find & Replace. The comment box opens under the result. Once you send it, the thread is there, numbered and highlighted, exactly as if you had made it in the chapter. To comment on something other than the match, select those words in the result first, or press Ctrl-Alt-M there, just as in the editor. A result that already has comments on it shows them underneath, so you can reply as you go. If you close Find & Replace before sending, an empty comment is dropped. One you have started typing stays open in the chapter so you can finish it. **Cleanup**: Cleanup scans the whole manuscript for the small typographic problems that creep in when text is pasted from elsewhere, and offers to fix each one: Remove Soft Hyphens — invisible hyphenation hints that survive a copy-paste and break words in the wrong places. Remove Extra Spaces — doubled spaces between words and sentences. Eliminate Unusual Spaces — non-breaking and other exotic space characters where an ordinary space belongs. Quotation Mark at Beginning of Blockquote — a leftover opening quote on text that is already set as a block quotation. Use Curly Quotes — straight " and ' converted to typographic quotes. Each issue can be jumped to and fixed individually, so you stay in control of anything ambiguous. **History**: Inkwell records the project as it changes, and History opens that record in a panel down the right-hand side of the editor. Choosing History again closes it, as does turning Preview on; opening History turns Preview off. The panel lists Current at the top, then any versions you have named, then the days you worked on the book, most recent first. Each day is broken into the separate stretches of writing it held — a morning and an evening at the same desk are two entries, not one — and each stretch shows when it ran, how long it lasted, roughly how much changed, and who was writing — you first, then anybody else who was in the book with you. Work the AI agent did is marked AI. A stretch appears as soon as you finish it. Everybody working on the project sees the same history; see Collaboration. The panel opens showing your recent weeks and loads further back as you scroll, so a project with years behind it opens as quickly as one started yesterday. Show earlier sessions at the foot of the list does the same thing on demand, and is there for reaching the end of a long history without scrolling through it. **Reading an earlier version**: Click an entry and the whole project switches to the book exactly as it stood at the moment that stretch of writing ended. The chapter list, the text and the preview all show that version, and you can move between chapters and read them exactly as usual. While you are looking at the past the book is read-only: the toolbar and the chapter list stop accepting changes, and the AI agent refuses to run, because everything it read or wrote would belong to the old version rather than to your manuscript. Click Current at the top of the panel, or close the panel, to come back to the live book. Nothing you do in this view can harm the manuscript, so it is safe to browse. If you only want one paragraph back rather than a whole rollback, select it in the old version, copy it, return to Current, and paste. **Naming a version**: The Name Version button at the bottom of the panel gives whatever you have selected a name — "first draft", "sent to copyeditor" — and named versions are then listed in their own group at the top of the panel, where they stay as the day-by-day entries scroll away beneath them. Naming while Current is selected records the book exactly as it is at that moment and names that. This is the usual way to mark a milestone before starting a big change. When the selected entry is a named version the button becomes Remove Name, which deletes the name only. The entry and the history behind it are untouched. **Reverting**: The Revert dropdown, next to the Name Version button at the bottom of the panel, rolls the project back to whichever entry you have selected: Revert Chapter returns the chapter you have open to the way it was then — its text, its formatting and its comments. If the chapter has been deleted since, it comes back, in as close to its old position in the chapter list as Inkwell can work out. It is unavailable while Current is selected, and when no chapter is open. Revert Book does the same for every chapter at once, together with the chapter order and the project settings. Both ask for confirmation first. A revert is recorded like any other edit, so it appears in the history as work done today, and it can itself be reverted: if you roll back to the wrong point, the version you left behind is still in the panel. **Index Entries, Inline Notes and Boilerplate**: Three display toggles: Index Entries shows or hides the index-entry markers in the text. See Index. Inline Notes shows each footnote's text in the chapter, under the paragraph its number sits in (after the text that carries on beyond it, if a quotation or list interrupts the paragraph), and lets you edit it there. The page stops for it the way it stops for a comment, and the note lies in a card in the break. With it off — which is how it starts — a note's text lives in the pop-up box that opens when you click its number; with it on, that box does not open, because the text is already on the page. It covers annotations as well as ordinary notes, and the number beside a note moves it between the two families, exactly as the number in the pop-up does. See Footnotes and Endnotes. Boilerplate shows or hides the template-managed chapters in the chapter list, so you can concentrate on your own writing. It also adds Variable to the toolbar's Insert menu, since variables are mostly a boilerplate concern. See Templates and Boilerplate. These three are yours, not the project's: they follow you between books and your collaborators do not see them. Hiding Insert → Variable changes nothing about the book — variables already in the text keep displaying, typesetting and editing as before; you simply cannot insert a new one until you switch it back on. **Users**: Opens the Users panel, where you see who is on the project, invite people, set what each of them may do, and choose whose writing is tracked. It takes the place of the manuscript while it is open, and the Users icon in the left rail opens and closes the same panel. See Collaboration. **API Keys**: Generates a key and secret pair for programmatic access to this project. The secret is shown only once, when the key is created, so copy it then; you can revoke a key at any time from the same dialog. A key made by a connected AI assistant shows the assistant's name under the date it was created. A key lets a script upload pictures into the project's figures; see Updating Figures from a Script. ### Publishing **Publishing**: The Publish menu turns your project into a finished file. Everything is generated from the same typeset document you have been watching in the preview, so what you download is what you saw. **PDF**: The two settings most people care about are at the top: Watermark — text stamped across every page, for circulating drafts. Options opens the appearance settings for it. Include Cover — whether the cover is included in the file: the front before the first page and the back after the last. A book with a cover design uses its front and back panels (see Covers); otherwise the Cover and Back Cover pictures from Project Settings. Then the print-quality settings: Resolution — Screen, Print, or High-Res Print. Higher settings embed images at greater detail and produce larger files. Use Screen for review copies and High-Res Print for anything going to a printer. A photo you uploaded as a JPEG keeps the quality you saved it at, and is only scaled down when it has well over the detail the setting needs. Color Mode — RGB (optimised for screen), Grayscale (optimised for black and white printing), or Full Color (optimised for colour printing). Choosing Grayscale converts the images rather than leaving that to the print shop, so you can see the result before you commit. Line Numbers — numbers every line in the left margin, for a manuscript a journal or a reviewer wants to refer to by line. Restart each page starts at 1 on every page, Restart each chapter at the top of every chapter (and of anything else that begins a new page, such as the contents), and Continuous counts through the whole file. The numbers sit outside the text and change nothing about the layout. They appear only in the exported PDF, not in the preview. Display equations are not numbered; everything else that sets lines, including headings, captions, tables and notes, is. Portion — Entire Project or just the current chapter. Exporting one chapter is much quicker when you are chasing a single layout problem: Inkwell lays out only the chapters before it, to know where it starts, and none after it. A table of contents or an index is the exception, since it lists the pages of the whole book. With continuous line numbers, a chapter exported on its own keeps the numbers it has in the whole book. Finish with Print, which opens the browser's print dialog, or Download, which saves the PDF. A bar shows how far Inkwell has got laying out the book's pages, followed by a short wait while it assembles them into one file. **ePub**: The ePub export has a single option, Include External Links, which controls whether links out to the web are preserved in the ebook. Click Export to build and download it. The ebook's cover image is the front of the cover design, or the Cover picture when the book has no design. Inkwell's ePub is generated from the same source as the PDF, so the two stay in step. Page numbers are embedded, fonts are subsetted, images are compressed, and mathematics is included as SVG so it renders properly on e-readers rather than being flattened to bitmaps. **The printed cover**: A printer wants the cover as a file of its own: back, spine and front in one piece, sized to the book's page count. That file comes from the cover designer's Download cover PDF; see Covers. **Other formats**: Html — the book as a web page. LaTeX — a .tex project with a basic article document, for journals or publishers who want LaTeX sources. Customizing the document class or packages is up to you once it's downloaded. Microsoft Word — a .docx, for collaborators and publishers who work in Word. Pictures larger than print resolution (300 dpi) are scaled down to it, and PDF figures become pictures, since Word cannot show a PDF. Markdown — plain Markdown. Inkwell Backup (.inkwell) — a complete archive of the project: text, images, files, and settings. This is the format to keep for your own records, and the one to use when moving a project between accounts. To restore it as a project of its own, settings included, use New Project → Import Document → Upload File (see [Copying a project](creating-a-new-project.mdcopying-a-project)); Insert → Upload File brings its chapters into a project you already have. **Export issues**: Every export runs a check first. If anything could not be carried across into the chosen format, Inkwell shows a report headed "Export finished with warnings", listing each problem. Where the problem is a piece of your manuscript, clicking the entry jumps straight to the place that caused it. This matters most for the lossier formats: Word and Markdown cannot represent everything that PDF and ePub can, so the report is where you find out what was dropped, rather than discovering it later in the finished file. A PDF export also checks that every character in the book can be printed. A character that no font in the book has — not even the ones Inkwell adds for other scripts — would come out as an empty box, so the report lists it, and clicking the entry takes you to where it first appears. Choose a font that has it for that text, or one for its script under Other Scripts. The report covers the book's details as well as its content. An author listed in the book settings but left without a name cannot go into an ePub — the format will not accept an empty author, and shops that check the file reject it — so that author is left out and the report says so. If none of the authors has a name, the ePub lists no author at all. ### Covers **Covers**: The Cover button on the left of the editor opens the cover designer. It also opens from the AI menu under Cover. The designer lays out the whole printed cover as one piece: the back, the spine and the front, plus the bleed a printer trims away. That is the file print-on-demand services such as Amazon KDP and IngramSpark ask for. The type on a designed cover is typeset by Inkwell, not painted. The title, subtitle and author come from the book, so if you rename the book, the cover follows. The spine widens with the manuscript, too. **Designing a cover with AI**: A book without a cover opens on a blank wrap. Design with AI… walks you through making one in four steps. It is also on the designer's AI tab, as New cover with AI… once the book has a cover. The book's cover does not change until the last step, so you can close it part way and the cover stays as it was. Once you have started, clicking outside the steps does not close them; use the close button. 1. The brief. Say what you have in mind, if anything: a medium, a mood, an image you want. Then Read my book. The AI reads the start of the book and writes a brief: its genre, its mood, an art direction and a palette. Change anything it got wrong, and choose how many directions to paint. 2. Directions. Paint directions turns the brief into several covers, each with its own art, typefaces, colours and arrangement. They are painted at the same time, and each appears as soon as it is ready. Pick the one you want to carry forward. None of them right? Say what to change in the box underneath — "warmer colours", "try one without the lighthouse" — and Suggest others. The next set is written with what you saw and what you said about it. 3. Back cover. The AI drafts a tagline and a blurb; rewrite them as you like. In the blurb, leave a blank line between paragraphs and use asterisks for italics. Add an author bio or an endorsement if you want them on the back. Choose whether to leave a space for the printer's barcode or print one from your ISBN. The preview beside the fields shows the result as you type. 4. Printing. Choose your printer and paper. The spine is sized from the book's own page count (see Printer and spine). Use this cover makes it the book's cover and opens it in the designer for any finishing touches. You can also build a cover by hand with Add (see below), or describe what you want to the agent in Ask the agent. Reading the book and painting directions spend inkdrops; see below. **Past designs**: Every cover the AI paints for a book is kept: each direction, art from New art on the Elements tab, and art the agent paints. Past designs…, on the AI tab and on a book with no cover yet, shows them newest first. Use makes one the book's cover, keeping the book's printer and paper, and you can change it in the designer like any other. Remove takes one off the list. **The designer**: The large picture is the cover exactly as it will print. It is typeset from the same design the download comes from, not a sketch of it. Guides marks the trim and the spine folds in magenta, and the safe area, inside which text is never at risk of being cut, in blue. Turn them off to see the cover clean. Below the picture are the wrap's full size, the spine width and the bleed, and a list of anything a printer would object to. Click an item in that list to select the part it is about. Click anything on the cover to select it. Drag it to move it. The column beside the cover has three tabs: Elements, for what is on the cover; AI, for designing a new cover or asking the agent to change this one; and Print, for the printer, the spine and the download. **Elements**: A cover is built from elements, listed on the Elements tab from the topmost down. Selecting one shows its settings underneath the list: Text: the title, subtitle and author, a tagline, the blurb, an author bio, endorsements. A text element can show the book's title, subtitle or author, which is how the cover keeps up with the book. Otherwise it shows its own text. In a blurb, leave a blank line between paragraphs and wrap words in asterisks for italics or double asterisks for bold. Shrink to fit makes text smaller rather than letting it spill out of its box. Art: the picture behind a design. New art paints a fresh one from the prompt above it. Edit the prompt first to change what it shows. Upload… uses your own picture instead. Focus chooses which part of the picture survives when it is cropped to fit. Picture: an author photo or a publisher's logo. Rounding turns a photo into a circle. Shape: boxes, ellipses and lines. Use one to give text a patch of colour to sit on. Fade turns a box into a gradient, the usual way to darken the top of a picture so a light title reads over it. Barcode: either a white space where the printer puts its own barcode (KDP does this for you), or a real EAN-13 barcode printed from the book's ISBN. Where the printer puts it keeps it at the printer's standard size and position; drag it and it stays where you put it. Art and pictures both have Brightness, Contrast, Colour and Sharpen sliders under Upload…, for touching up a picture you supplied that came out dull or soft. A change is made when you let go of a slider, so give it a moment. Each change starts from your original picture, and Reset puts the original back. The buttons beside each element hide it (it stays in the design, ready to come back), move it up or down the stack, or delete it. Add puts a new element on the front, ready to move into place. Every element sits on a Panel: front, spine, back, or the whole wrap. Its position and size are percentages of that panel. Fill panel stretches it over the whole panel and into the bleed, which is what a background wants. Art and shapes that reach the outer edge of the cover carry on into the bleed by themselves, so nothing pale shows after the trim. **Printer and spine**: Choose your Printer and Paper. Inkwell then works out the spine from the page count using the printer's own figures. Interior paper varies in thickness, so a 300-page book on cream paper has a wider spine than the same book on white. The spine is always sized for the book as it is now. Inkwell counts its pages (without the cover pages) while the designer is open, and counts again a few seconds after the chapters or the book's settings change. The Print tab shows the result, for example "Spine 0.721" for 320 pages". The download counts once more, so the file you send a printer is never stale. Spine width from your printer overrides the calculation when your printer has given you a figure of its own. For a printer Inkwell does not know, choose Another printer and type in the thickness of one page from their specifications. Printers refuse text on a very thin spine; KDP needs more than 79 pages. When the spine is too thin for it, the designer says so, and the spine text should be hidden. **Print resolution**: AI art is painted at a size that looks fine on screen and soft in print. When you choose a cover, Inkwell enlarges its art to print resolution (300 ppi) in the background. The list under the cover says when a picture is still below that. Use Prepare for print on a piece of art to enlarge it after painting a new one. Your own uploads are used as they are, so upload the largest version you have. Sharpen can crisp up a soft one, but it can't add detail that isn't in the picture. **Downloading**: Download cover PDF saves the whole wrap, sized to the printer's specification, as the file to upload alongside your interior PDF. It uses the Resolution and Color Mode chosen in Publishing. The same design is used everywhere else a cover appears: Include Cover on the PDF export puts the front panel before the first page and the back panel after the last. The ePub's cover image is the front panel. Remove design deletes the design. The book goes back to the Cover and Back Cover pictures in Project Settings, if it has any. **Working with the agent**: Ask the agent on the AI tab sends a request to the agent, for example "make the title larger and warmer" or "try a version with a pine forest". The agent edits the same design you are looking at. It checks each change by looking at the cover itself, and it asks before preparing art for print. Its changes arrive as edits you can keep or revert, like any other. **What the AI costs**: Painting art and reading the book for a brief spend inkdrops (see AI Tools). Painting four directions costs a few hundred. Preparing art for print costs a little each time. On your own OpenAI key the art is billed by OpenAI and spends no inkdrops. Anthropic and xAI make no pictures, and Gemini keys are not used for art yet, so with one of those keys the art still runs on inkdrops. When you upload a cover with AI-generated art, KDP asks whether it contains AI-generated content. Answer yes. ### The Agent **The Agent**: The Agent is an assistant that works on the book itself. The other AI Tools each do one job to one chapter; the agent takes an instruction in your own words, looks around the manuscript to work out what you meant, and does it. It can answer questions too — "which chapters never mention the narrator's sister?" is a fair request, and nothing changes when you ask one. It is good at bounded, checkable work — a rename carried through the whole book, an audit of something you suspect is inconsistent, a first pass at an index — and it is capable of being confidently wrong. Everything it changes is kept together so you can look it over and undo it, so the way to use it is to ask, then read what came back. **Opening it**: The Agent button sits in the strip down the right-hand side of the editor, below Project Settings. It opens a panel beside your chapter, and the button pulses while a request is running, so you can carry on writing in another chapter and come back to it. AI → Open Agent does the same thing, and the other entries on that menu open it with a request already sent — see AI Tools. Type into the box at the bottom and press Send — or just Enter, with Shift+Enter for a new line. **Attaching a file**: You can show the agent a picture or a document. Use the paperclip beside Send, paste straight into the box, or drag a file onto the panel — all three do the same thing, and a message can carry up to five files of 25 MB each. There are two quite different reasons to do it, and both work: A picture you want in the book. "Here's the cover — put it at the front of chapter three." The agent inserts it as a figure, and you review that insertion like any other change it makes. A picture you want it to work from. "Match this layout in the project settings", or "the chapter openers in this book — can you get close?" Nothing is added to the book; the agent looks at the image and changes settings. Inkwell accepts images, PDFs and text documents (.md, .txt, .html, .tex, .docx, .odt, .rtf). A PDF is shown to the agent as its first page and its text, so it works either as a design to copy or as something to read. A document is read as text — the agent can quote it and write from it, but there is nothing to insert. A file is only stored in your book if the agent actually uses it. Attaching a picture and then deciding against it leaves nothing behind. Because storing one is a change to the book, it needs Read-write — in Read-only or Comment the agent can look at your picture and tell you what it would do with it, but not put it in. You don't have to attach a picture at all if it is already on the web: give the agent the address instead — "put the map at https://example.com/map.png at the top of chapter two" — and it fetches and stores it for you. It can also draw one itself, which is worth asking for when what you want is a diagram rather than a photograph. Either way it arrives as a figure and is reviewed like any other change. **Read-only, Comment, Read-write**: The dropdown next to Send decides how much the agent may touch: Read-only — it can look at the manuscript but cannot change anything. The safe way to ask questions. Comment — it may take a full part in the conversation without touching your text: start a thread, reply to yours, mark one with an emoji, and rewrite or withdraw what it left. Useful for a critique you want alongside the writing rather than in it. Read-write — it may edit, comment, and create chapters. The setting applies to the next thing you ask, so you can drop to Read-only for a question and raise it again for the work. A request from the AI menu can raise it for you — the Copyeditor cannot work in Read-only — and Inkwell says so when it does. That lasts until the next request from the menu; the setting you chose yourself is what that one starts from. **Watching it work**: While it runs, the panel shows Working… and a row of small icons — one per thing the agent did: a chapter it read, a search it ran, a page it rendered to look at. Click any of them for the detail behind it. A rendered page shows up as a thumbnail of the page itself, so you can see what it saw. Stop ends the run; work already done stays in the book, under that reply's chip. Sometimes it produces something for you to read rather than an edit — a summary, an audit, a list. Those appear as a full-width entry in the log with an Open button. **Citations**: The agent reaches the same sources as the Insert Citation button: the citation manager you have linked under Citations and Bibliography, a DOI or a web address, and every source the book already cites. So "find a source for this claim and cite it", "check that every citation in chapter 4 still resolves", or "this work is cited twice under two different records — merge them" are all fair requests. It prefers a source the book already uses over a fresh lookup, which is what keeps one work from appearing twice in the bibliography. Citations it inserts are reviewed like any other change it makes. The same is true of an assistant connected from outside — see Connecting an AI assistant below. **Reviewing what it changed**: The agent's edits go straight into the book. Nothing waits for your approval, and you never have to review anything — but you can, one reply at a time. Every reply that changed the book ends with a chip: a line in the log saying what that reply did, and how many of its changes you have not looked at yet. Click a chip to open it. While a chip is open, the passages it changed are marked in the text as tracked edits, in your AI's colour, and the chip lists the chapters it touched — click a chapter's name to jump to its first change. Only one chip is open at a time, and the agent's other edits stay out of your way in the text until you open theirs. With a chip open, review its changes the way you would a collaborator's: put the cursor in one and use Accept or Reject on the review toolbar — see Collaboration. When you have dealt with the ones you care about, Accept the rest or Reject the rest on the chip settles whatever of it is left. Changes to the book's settings or chapter order have nowhere in the text to point at, so the chip lists them with their own Accept and Reject. The newest chip opens on its own, so the last thing the agent did is what you see marked. Click an open chip again to close it. Accepting here is private: it means you have read the change and it is your writing now, and it settles nothing for anybody else. Your collaborators see the agent's changes as your edits rather than your AI's, marked for them only if the project marks your writing. If it does — you are on Track or Suggest in the Users panel — an accepted change goes on showing as your own tracked change, and is settled the way the rest of your writing is. See Edits the AI made. **One continuing conversation**: The panel holds one conversation with the agent for each book, and it just keeps going: everything you and the agent have said about the book is still there when you come back tomorrow. **Topics, and what the agent can see**: The conversation is divided into topics. The current one fills the panel; everything before it is folded under Earlier, which says whether the agent can see it: The agent sees a summary — Earlier is open. The agent is given a short summary of the earlier topics: what you asked, what it answered, and which chips it made. If it needs an earlier exchange word for word, it looks it up, so "undo what you did to the epigraph last week" is a fair thing to ask. Hidden from the agent — Earlier is closed. The agent knows only the current topic. Ask it about something from before and it will say it has no record of it; open Earlier and ask again. Click Earlier to open or close it. The change applies from your next message, and the panel remembers it for that book. While it is closed, any chip still waiting for you to review stays in view below it. Open it and use Show earlier messages to read further back. A new topic starts when: you click New topic at the top of the panel, to put the discussion so far behind you; you send a request from the AI menu, which says everything it needs to on its own; you open the panel more than an hour after your last message. Earlier then starts out closed, since coming back to a book later is rarely carrying on where you left off — open it if you are. Within a topic, the agent does not reread every message each time, which would make each one cost more than the last. After a pause of a few minutes it works from a short summary of the topic so far instead, and looks up anything it needs word for word. **Inkdrops**: The agent spends inkdrops, and spends them faster than anything else on the AI menu — it is doing more work, over more of the book. The composer shows how many you have left, with a ? beside the count that explains what they are. When you run out, the run stops and the panel offers the ways to carry on: Upgrade Plan, Buy Inkdrops on a paid plan, and — on the Standard plan and above — Use Your Own AI Key or Connect an AI Assistant. A free plan includes no inkdrops, so the agent needs a paid plan, or your own API key saved under My Account on Standard or above. Flag sends the conversation to us when a run goes wrong, which is the most useful thing you can do with a bad answer. The agent can also tell us itself. When it runs into something Inkwell can't do, or a tool of ours lets it down, it sends a short description of the problem — not the conversation — and the panel shows Reported a problem to Inkwell among its steps. It still tells you what it couldn't do; the report is so we can fix it for next time. An assistant you connect does the same. **Connecting an AI assistant**: If you would rather work in an assistant of your own than in this panel, you can connect one to the book directly, with the same three modes and the same way of reviewing what it did. Its edits appear in the book's agent panel as chips, like the agent's own, marked with a plug instead of a sparkle; a run of changes it makes within a few minutes of each other shares one chip. The connection uses MCP, the Model Context Protocol. Inkwell runs the server; your assistant is the client. That means two plans are involved: Inkwell's, and the assistant's own. Not every assistant lets every plan add a server of your own, so check the line for yours before you start. Assistant Plan you need with that assistant Claude Any plan, Free included Claude Code Any Claude plan, or an Anthropic API key ChatGPT Business, Enterprise or Edu Grok Any plan, Free included Gemini app Google AI Pro or Ultra, on a personal account, in the US Gemini CLI Any Google account On Inkwell's side, connecting an assistant needs the Standard plan or higher; on a plan without it, the dialog offers to change plan instead. An assistant you connected on a qualifying plan stops working if you move to one without it, and picks up again when you move back — there is no need to reconnect. Open AI → Connect AI Assistant to set it up. A fresh agent panel offers the same thing before you have asked it anything. An assistant reaches only the books you choose, and you choose them when you approve it: the approval page lists every book you have, each with a checkbox and a Mode — Read-only, Comment, or Read-write, the same three modes as the panel. If you opened Connect AI Assistant from a book shortly before, that book comes already ticked. Different books can be set to different modes; an assistant that can freely edit one book might only be allowed to leave comments on another. Tick All my books instead and every book you have is reachable, including the ones you start or are given later, at the mode beside it. You can still set any one book to a different mode. You can change your choice whenever you like, and it takes effect immediately for every assistant you have already connected — no need to reconnect. In the dialog, the checkbox under AI access to this book turns the open book on or off, with its Mode below. While All my books is on, that checkbox is ticked and locked. All books… beside it opens the AI Access page, which has the same list as the approval page; save it there. An assistant asked about a book it cannot reach gives you a link to that page too. Losing a project turns its access off with it. Whether you removed it yourself or an administrator removed you from it, your connected assistants stop reaching it from their next request, and turning it back on means being given the project again. The Connector URL at the top of the dialog is what your assistant needs — https://inkwell.net/api/mcp. It is the same URL for every book and every connection, and it is not a secret: it grants nothing on its own, and an assistant reaches only the books you have turned on, at the mode you set for each. Copy it with the button beside it and add it in your assistant as below. Every assistant ends the same way: it sends you to an Inkwell page asking whether to let it in, you choose its books, and you approve. **Claude**: Plan you need: any Claude plan, though Free allows only one custom connector. On Team and Enterprise, an Owner of your Claude organisation has to add Inkwell first. On claude.ai or in Claude Desktop: Open Customize → Connectors. Click +, then Add custom connector. Name it Inkwell, paste the connector URL, and click Add. Claude sends you to Inkwell; approve access. On Team and Enterprise, the Owner does steps 1–3 under Organization settings → Connectors → Add → Custom → Web instead. Each member then finds Inkwell under Customize → Connectors, clicks Connect, and approves access in Inkwell. To use it in a conversation, click + in the message box, choose Connectors, and turn Inkwell on. Claude asks before it uses each tool; Allow always stops it asking. Once it is added on the web or desktop, the Claude apps for iPhone and Android can use it too. **Claude Code**: Plan you need: any Claude plan, or an Anthropic API key. If you added Inkwell on claude.ai and you sign in to Claude Code with that account, it is already there. Otherwise, add it from a terminal: claude mcp add --transport http inkwell https://inkwell.net/api/mcp Then start Claude Code, type /mcp, choose inkwell, and authenticate; your browser opens Inkwell's approval page. **ChatGPT**: Plan you need: ChatGPT Business, Enterprise or Edu, on chatgpt.com in a browser. On Business, only a workspace owner or admin can set it up, and members use what they publish: A workspace owner turns on developer mode for the workspace, under Workspace settings → Permissions & roles. The admin turns it on for themselves: Settings → Security and login → Developer mode. The admin opens Settings → Plugins (Apps in some versions), clicks + or Create, names it Inkwell, pastes the connector URL, chooses OAuth for authentication, and creates it. ChatGPT sends them to Inkwell; they approve access. To share it with the workspace, the admin publishes it from Workspace settings → Apps. Each person who uses it approves access in Inkwell for themselves, the first time they do. To use it in a conversation, open the + menu in the message box, choose Developer mode, and select Inkwell. ChatGPT asks you to confirm each change before it makes it. **Grok**: Plan you need: any Grok plan, Free included. On Grok Business and Enterprise, a team admin has to add Inkwell first. Go to grok.com/connectors. Click New Connector, then Custom. Paste the connector URL and continue. Grok sends you to Inkwell; approve access. On Business and Enterprise, the admin adds it in the xAI console instead — Grok Business → Connectors → Add Connector → Other — and each member then connects it at grok.com/connectors and approves access in Inkwell. Connectors work on grok.com and in the Grok apps for iPhone and Android. **Gemini**: Plan you need: Google AI Pro or Ultra, signed in with a personal Google account, in the US, aged 18 or over, with Gemini's Keep Activity setting on. Work and school Google accounts — Google Workspace — cannot add one, and Google lists no free-tier access. On a computer, go to gemini.google.com. Open Settings → Connected Apps. Under Custom apps, click Add a custom app. Paste the connector URL and click Next. Gemini sends you to Inkwell; approve access. After that it works in the Gemini phone apps too. Type @ in a prompt to call on Inkwell by name. Gemini asks you to confirm each change before it makes it. **Gemini CLI**: Plan you need: any Google account Gemini CLI accepts. gemini mcp add --transport http inkwell https://inkwell.net/api/mcp Then start Gemini CLI and run /mcp auth inkwell; your browser opens Inkwell's approval page. **Other MCP clients**: Anything that speaks MCP over HTTP with OAuth — a coding agent, an editor, a desktop client — takes the same URL wherever it asks for a remote MCP server. Its own documentation will say where that is; Inkwell's side of the setup is the same either way, ending in the approval screen. **Revoking a connection**: Connected assistants at the bottom of the dialog lists everything currently connected, with a button to revoke any of them. Each app appears once, even if you have connected it from more than one place (two Claude accounts, say), and revoking it disconnects it everywhere. A connection lasts until you revoke it, or until a year after you approved it, whichever comes first. The list only shows connections that still work, so if an assistant disappears from it, approve it again the same way you set it up. **Letting an assistant start a project**: A connected assistant can also create a new project for you, without you opening Inkwell to do it. Ask for one and it picks the kind — note, article, or book — and, if you have templates, one of those; you can say which if you care. What arrives is what New Project would have given you, and no more. A note comes with one chapter, titled the way you named the project. An article or a book comes with the template's front matter — title page, copyright, and the rest — and no chapters yet, so ask for the chapters you want and the assistant will add them. The new project appears in your projects list straight away, and it is turned on for AI access at Read-write so the assistant can go on to write in it. That is the same checkbox and the same Mode dropdown as any other book, in the dialog above, so you can turn it off, drop it to Comment, or delete the project outright. One thing to expect: the starting content is not marked for review the way the assistant's later edits are. It came from the template, not from the assistant, so there is nothing to accept — everything it writes after that arrives under a chip as usual. **Pictures, and why an attached one may not arrive**: A connected assistant can put a picture in your book: from a web address, from a file it can read itself (a coding agent working on your machine, say), or one it draws — a diagram, a chart, a title-page ornament. Ask for it in the ordinary way and it arrives as a figure, stored in the book and reviewed like any other edit. A file you attach in your own chat app is the one case that does not work. Claude and ChatGPT show their model a picture of what you attached, and never send the file itself anywhere Inkwell can see, so the assistant has your photograph in front of it and no way to hand it over. It should tell you so rather than quietly inventing something similar. When it happens you have two ways round it: put the picture somewhere with a web address and give it that, or attach it in the book's own Agent panel, which is holding the actual file. A file on the assistant's own computer is different. An assistant that can run programs — a coding agent working on your machine — can send a picture straight into the book without you putting it anywhere public first. That is also what makes the next section possible. **Turning a document into a project**: If the assistant runs on your computer, it can convert a document you already have — a PDF, a Word file, a folder of notes — into chapters, pictures and all. Ask for it in the ordinary way. What happens behind the scenes is worth knowing, because it explains the one thing you have to do first: the assistant writes a small program, runs it on your file, and sends the result to Inkwell directly. Your document's words and pictures never pass through the conversation with the assistant, which is what makes converting a whole book practical rather than ruinously slow. The book has to be set to Read-write for this, in the dialog above. There is nothing else to set up and nothing new to see there: the assistant asks Inkwell for permission to send files each time, and that permission lasts an hour and covers only the one book. If you switch the book to Read-only or Comment part way through, the transfer stops there. A converted document arrives as one large change under a single chip, like everything else the assistant writes. It is a lot to read through paragraph by paragraph, and it doesn't need to be: you never have to review a chip, and reading the chapters as you work on them is easier than reviewing them as a wall of edits. Two things to expect. A conversion is an interpretation, not a photocopy — headings, block quotes and captions are the assistant's reading of your document's layout, and complicated page design (multiple columns, text wrapped around pictures, tables inside tables) is where it will be roughest. And an assistant that runs only in a chat window, with no way to run programs, cannot do this at all; it should say so rather than attempting it slowly. **Keep the book open when the assistant needs to see a page**: An assistant can ask what the typeset book looks like — which page a chapter starts on, how long it runs, or for a picture of a page. Inkwell answers those from the same typeset preview your own window is showing, which is why the answer comes back almost immediately. The catch is that it needs your window. If the book isn't open in Inkwell, the assistant can't measure or picture a page, and it will tell you so rather than guess, with a link that opens the book. Everything else — reading, editing, commenting — works whether or not you have the book open. So if you've asked an assistant to tidy up your page breaks, leave the book open in a tab while it works. A window that has the book open can still occasionally miss a request — when it is busy typesetting a large book, say. The assistant is then told no window answered, which is not the same as the book being closed; ask it to try again. A very long book takes your window a minute or two to lay out in full after you open it, or after an edit that moves the pages of everything behind it. The assistant doesn't have to wait for all of it: it can look at a chapter as soon as the window has laid out that chapter and the ones before it. Asked about a chapter the window hasn't reached yet, it is told how far along the window is and when to try again. An assistant's edits save as it makes them, so they appear in your window as it works rather than all at once when it finishes. That is also how it measures its own work: when it changes a chapter and then asks how long the chapter now runs, it is asking about the version your window has just been sent, so the answer accounts for the change it has only just made. One case surprises people. While you are looking at an earlier version of the book in History, your window does not count as having the book open — it is showing the book as it was, not as it is, so it cannot answer a question about the book as it is. An assistant that asks will be told no window answered. Come back to the current version and it can measure again. ### Updating Figures from a Script **Updating Figures from a Script**: If your figures come out of a program — charts drawn from data, diagrams generated from source files, plots from an analysis — you can have that program send them straight to Inkwell. Each upload replaces the picture in its figure and leaves the caption, number, size and position alone. Run the script again whenever the data changes and the book stays current. **What you need**: An API key for the project. An assistant can set one up for you (see below), or open Tools → API Keys and click Generate Key. You get a key and a secret; the secret is shown only this once, so copy both somewhere safe — an environment variable or a file your script reads, never the script itself. A key belongs to one project, and you can revoke it from the same dialog. See Tools. A figure key for each picture. Every figure has a hidden key that the API uses to find it. A figure you insert from the toolbar gets a random one, so it is easiest to choose your own names, like sales-by-region, using letters, digits, hyphens and underscores. The next two sections describe two ways to set them up. **Sending a picture**: Send the file's bytes with a POST to https://inkwell.net/api/v0/figures/. Sign in with HTTP Basic authentication, using the key as the username and the secret as the password: bash curl --fail -u "$INKWELLKEY:$INKWELLSECRET" \ --data-binary @charts/sales-by-region.png \ https://inkwell.net/api/v0/figures/sales-by-region Inkwell works out the file's format from its contents. PNG, JPEG, SVG and PDF are stored as they are, and SVG and PDF stay sharp at any size. Other image formats, such as WebP, GIF and TIFF, are converted to PNG. A successful upload returns an empty 200 response. A wrong key or secret returns 403, a file Inkwell can't read returns 400, and so does a figure key with characters other than letters, digits, hyphens and underscores. **Where the picture goes**: If a figure in the project already has that key, its picture is replaced, everywhere the key appears. Anyone with the project open sees the new picture. If no figure has that key yet, the picture waits as a pending figure. While any are waiting, the Insert Figure button opens a list of them instead of the file chooser. Click a picture to place it at your cursor, or remove the ones you don't want. That figure takes the key, so later uploads replace it in place. The file chooser returns once the list is empty. Moving a figure keeps its key, whether you drag it or cut and paste it. A copy gets a new key, so uploads won't reach the copy. Each upload is saved as a new picture and recorded as a change in the project's history, even if the file hasn't changed. Have your script send only the files that changed. **With an AI assistant**: If your figures are made by code in a project folder and you use an assistant connected to Inkwell, such as Claude Code, the assistant can do the setup for you. Ask it something like: Set up a script that uploads the charts in figures/ to my book and puts each one where it belongs. The assistant reads the book to decide where each picture goes. It reuses the keys of figures that are already there, and for new pictures it adds empty figures with captions and keys named after the files. Those additions arrive as suggested edits for you to review. It then writes a script in your folder that uploads every file to its key. The assistant also sets up the API key. It creates the key and writes it straight into a .env file in your folder that git ignores, without the secret ever appearing in the conversation. The key is listed under Tools → API Keys with the assistant's name, and you can revoke it there like any other. This only works when the assistant can edit the project. ### AI Tools **AI Tools**: The AI menu is the way in to the agent. Every entry on it but Cover opens the agent panel; most of them also send the agent a request for you, with the instructions already written. All of them produce suggestions that you accept or reject — nothing rewrites your manuscript on its own. And none of them do anything you could not ask for yourself: an entry here is a saved request, not a separate tool, so if the result is not quite what you wanted, say so in the same panel and the agent will adjust. These run on inkdrops, the monthly allowance your plan includes for them. The free plan includes none, so the entries offer a link to change plan instead. On the Standard plan and above you can also have AI usage billed to your own account by saving a key under My Account — that work spends no inkdrops. See Your Account and Plan. **Inkdrops**: Running these tools costs real money, so your plan includes an allowance for them, counted in inkdrops. Every tool on this menu spends inkdrops, and they do not all spend them at the same rate. Looking up a citation costs a fraction of an inkdrop; a Copyeditor pass over one chapter costs a few; building an index for a whole book costs a good deal more. The rule of thumb is simply how much work you asked for — the longer the text and the more thorough the job, the more inkdrops it takes. The agent panel shows how many you have left as you work; the ? beside the count brings you back to this page. Your plan's inkdrops refill at the start of each month. You can see how many you have used in the Usage section of Your Account and Plan, shown as used / allowed. **Buying more**: On any paid plan you can buy extra inkdrops with Buy Inkdrops on the My Account page. They come in packs of 1,000, 5,000 and 10,000, with the larger packs cheaper per inkdrop. Bought inkdrops never expire, and they are only spent once the month's inkdrops are gone — so a pack you buy today is still there next month if you never needed it. **Running out**: If you run out, the AI tools stop, and Inkwell shows what you can do about it — in the agent panel, or in a window when you used a tool from elsewhere, such as converting an equation: Upgrade Plan — move to a plan with a larger monthly allowance. Buy Inkdrops — top up straight away, on a paid plan. Use Your Own AI Key or Connect an AI Assistant — on the Standard plan and above, work on your own key, or in an assistant you connect, spends no inkdrops. Otherwise the tools wait until your inkdrops refill at the start of your next month. Nothing else is affected — writing, editing, formatting, exporting and publishing carry on exactly as before. It is only these tools that pause. Typing an equation's LaTeX yourself still works, and adding a citation by hand still opens its form, just without the details filled in for you. Inkdrops pay for AI run on Inkwell's account. If you have saved your own OpenAI, Anthropic or Google Gemini key, that work is billed to you by the provider directly and spends no inkdrops at all. An xAI key covers the heavier tools only, so the small jobs — citation lookup and equation conversion — still run on Inkwell's key and still spend inkdrops. Cover art is painted only on an OpenAI key; with any other, it runs on Inkwell's key too. **Open Agent**: Opens the panel without starting anything, so you can ask your own question. Everything the agent can do is reachable from here. **Copyeditor**: Copyeditor goes through the current chapter and commits the changes an editor would make. If you have a range selected it copyedits only that; otherwise the whole chapter. Two settings, both remembered between runs: Tone — Neutral, Academic, Professional, Concise, Conversational, Friendly or Creative. What the prose should sound like. Level — how far to go. This is the one that matters most, because the difference between a pass you barely notice and one that rewrites half your sentences is entirely here: Proofread — typos, spelling, punctuation, plainly wrong grammar. Nothing else, however tempting. Clumsy phrasing is not an error at this level and is left alone. Light — the above, plus agreement errors and sentences that are genuinely confusing. Word choice and rhythm are left alone. Standard — the above, plus wordiness, repetition, weak constructions and sentences harder to follow than they need to be. This is the default. Thorough — the above, plus rephrasing for clarity and rhythm, and splitting or merging sentences. No level changes what a sentence means, adds information, or restructures your argument, and none of them touch your equations, citations, cross-references or footnote markers. Quoted material is left alone as well — it is not yours to correct. Where the agent thinks something is worth changing but your level does not cover it, it leaves a comment saying so instead. The request runs in read-write mode, so the suggestions go into the chapter under the reply's chip. Open the chip to see them marked, and accept or reject them in the text or all at once — see the agent. **Feedback**: Where the Copyeditor edits sentences, Feedback reads the chapter for its ideas: whether the central claim is clear and sustained, whether the sections earn each step, where a claim is unsupported or overstated, where it would be stronger for being cut. It will raise spelling, punctuation and awkward phrasing where it sees them, but in passing — it is asked to keep them in proportion rather than list every one, since the Copyeditor is the tool for that. It leaves each point as a comment on the passage it is about, and posts one report. The report opens with a grade — the letter a university professor would put on the chapter if it were handed in — then the overall assessment, what is working, and what to fix first in priority order. It runs in comment mode, so it cannot change your text while doing it. **Book Index**: Book Index builds an index for the whole book: it reads the manuscript, decides the entries, and marks up every occurrence that genuinely belongs to one. Three options control the scope: Index Front Matter — include front matter. Index Back Matter — include back matter. Include Footnotes — index the notes as well as the body. Indexing a whole book is a long job. It runs in the panel where you can watch it and stop it at any point, and it reports what it indexed and what it decided to leave out. Editing the result is covered in Index. **Cover**: Cover opens the cover designer rather than the agent panel. There you can design a cover with the AI step by step, or ask the agent to design and refine the printed cover with you. **What the AI sees**: The agent reads the actual documents your book is made of, not a flattened copy of the text, so it can see more than the words: which paragraph style something is in, whether a heading is a chapter or a section, what the book's settings are, and where things land once the book is typeset. Equations, citations, cross-references and footnotes are all visible to it as what they are rather than as loose text, which is how it can tell whether a sentence agrees with the equation beside it or matches the work it cites. It will not rewrite any of them. Your comments are visible to it — that is what lets it answer a note you left yourself, and what lets Feedback avoid repeating a point you have already made. In comment and read-write mode it can start a thread, reply to one and mark it with an emoji, whichever of you began it — but it can rewrite or withdraw only what it wrote itself; it will not touch your words. **Connect AI Assistant**: The last item on the menu is the one thing here that does nothing to your book by itself. It opens the settings that decide whether an assistant of your own — Claude, ChatGPT, Grok, Gemini, or anything else that accepts a remote MCP connector — may reach this project, and how much it may do when it does. Each of those assistants has its own rules about which of its plans can connect; see Connecting an AI assistant for the plan each one needs and the steps. ### Templates and Boilerplate **Templates and Boilerplate**: A template is the design of a book: its page size and margins, its fonts and heading styles, and the front and back matter that comes as standard. You pick one when you create a project, and you can change it later. **Changing the template**: Open Project Settings → Template, then click Change Template and choose a new one. The design settings are replaced; your writing is not touched. Beneath the button is a Sections list — every part the template supplies, each with a checkbox. Clearing one leaves that section out of your book. This is how you drop the parts of a standard structure you do not want, such as an acknowledgements page, without abandoning the template. **Boilerplate chapters**: Chapters that come from the template are marked as boilerplate. They appear in the chapter list with their own icon, and they are managed by the template rather than by you. Two switches in Local Settings → Chapter control this per chapter: Boilerplate — mark this chapter as template-supplied. Preserve in Template — keep this chapter when the template changes, instead of letting the new template replace it. If the boilerplate clutters your view while you are writing, Tools → Boilerplate hides it from the chapter list. The same switch controls Variable in the editor toolbar's Insert menu, since variables are mostly something you reach for while building boilerplate — see Advanced Formatting Features. **Publishing your own template**: Any project can become a template. This is worth doing if you produce a series, or if you run an imprint with a house style. First switch it on: Project Settings → General → Template. A Template entry appears at the top of the chapter list. On that page you give the template a Title and a Description — these are what other people see when choosing it — and click Publish. Inkwell renders a page of the book to produce the thumbnail shown in the template picker, so make sure the book is in a presentable state before you publish. Publishing again updates the template. **Reusing template content**: Chapters can also be pulled out of a template one at a time, without adopting the whole design: Insert → Import from Template in the chapter list. That is the quick route to a standard copyright page or a boilerplate disclaimer. ### Keyboard Shortcuts **Keyboard Shortcuts**: Everything in Inkwell can be done with the mouse, but these shortcuts save a lot of round-trips to the toolbar. Mod means Ctrl on Windows and Linux, Cmd on a Mac. You don't have to remember the table: hover over a toolbar button, or an item in the Insert menu, and its tooltip ends with its shortcut, written the way your computer writes them — Ctrl+B on Windows and Linux, ⌘B on a Mac. **Formatting**: Shortcut Effect Mod-B Bold Mod-I Italic Mod-U Underline Ctrl-Alt-1 Section heading Ctrl-Alt-2 Subsection heading Ctrl-Alt-3 Subsubsection heading Heading levels nest, so a level is only available where it makes sense — you cannot make a Subsection without a Section above it. If a shortcut appears to do nothing, check the style dropdown: the level you asked for is probably greyed out. **Inserting**: Shortcut Effect Ctrl-4 Inline math Ctrl-E Quote a Bible passage Ctrl-Alt-F Footnote Ctrl-Alt-M Comment Ctrl-Alt-V Verse number† Ctrl-Alt-C Scripture chapter number† Mod-Enter or Shift-Enter Line break within a paragraph **Editing**: Shortcut Effect Mod-Z Undo Mod-Y or Mod-Shift-Z Redo Mod-F Open Find & Replace Ctrl-H (Cmd-Shift-H on a Mac) Open it in Replace mode Mod-Shift-F Clear the current search Replace mode is not Mod-H on a Mac because Cmd-H hides the browser. Either shortcut also works with Find & Replace already open, switching it to that mode. **In Find & Replace**: In Replace and Format mode, one suggestion at a time is highlighted in yellow. These act on it and move the highlight on to the next, wherever the cursor is in the dialog — even while you are still typing in the Find or Replace box: Shortcut Effect Alt-A Accept the highlighted suggestion Alt-R Reject it, leaving that match as it is On a Mac, Alt is the Option key. See Tools. **In a comment**: Shortcut Effect Mod-Enter Send the comment or reply Escape Close the box, keeping what is in it Mod-B / Mod-I / Mod-U Bold / italic / underline @ Name a collaborator Enter inside a comment starts a new line rather than sending it, so a comment can offer two possible fixes on two lines. **Tab**: Tab and Shift-Tab do whichever is appropriate to where you are: In a table, move to the next or previous cell. In a list, indent or outdent the item. Inside a table, Arrow Up and Arrow Down move between rows. **Typing shortcuts**: Some things are easier to type than to insert. Inkwell rewrites these as you go: Type this Get this -- An em dash — ... An ellipsis … " and ' Curly quotes, opening or closing to match the context at the start of a line Section heading / Subsection / Subsubsection heading $x^2$ Inline math \[ A display-math paragraph, with the cursor in it \v 3 A verse number, as in USFM† \c 12 A scripture chapter number, as in USFM† † Only in a scripture edition — switch on Chapters and Verses under General in Project Settings, and see Chapter And Verse. In an ordinary project these do nothing, and \v stays the text you typed. If a substitution is not what you wanted, Mod-Z immediately afterwards reverts just the substitution and leaves what you typed. The quote substitution also applies in the Search and Replace boxes, so that what you type there matches the quotes in your manuscript. There, paste a straight quote rather than typing one when you want to search for straight quotes; see Tools. **Cross-references**: Typing one of these words followed by a space opens a reference picker, so you can point at a chapter, appendix, heading, equation, figure, or table and let Inkwell keep the number correct: Chapter Appendix Section Equation Figure Table Choose from the list with the arrow keys and Enter. The reference updates itself if things move around later, which is why it is worth using instead of typing the number. Appendix follows the Label you set in Project Settings → Appendices — rename it to "Annex" and "Annex " is what opens the picker. Each of your callout kinds is a trigger of its own as well, under the kind's own name. ### Collaboration **Collaboration**: More than one person can work on a project at the same time. Everyone's changes are recorded, attributed, and reversible, so you can hand a manuscript to an editor without losing track of what they did to it. The Users icon in the left rail opens the panel where all of it lives: who is on the project, what they may do, and whose writing has to be approved. It takes the place of the manuscript while it is open; click the icon again to get back to your writing. It is also in Tools → Users, and for anybody but an administrator, the users tracked button on the review bar under the editor opens it too. A short tour walks through the panel the first time you open it. **Roles**: Three questions, asked separately on each person's row. Admin is the checkbox: can this person control access to the project — invite, remove, change what everybody else may do. It is on its own because it is independent of the rest. Role is what they may do to the manuscript. Role What it allows Approve Edit any part of the book, and settle other people's tracked changes Edit Edit any part of the book, but settle nobody else's changes Read Read and comment, but not edit Frozen Read a fixed version of the book — new changes are not shown Approve is the one to reach for when you are bringing in help. Somebody on Edit can write anything they like but cannot settle somebody else's tracked change, which is what you want from a copy-editor: their work is answered by whoever commissioned it, not by the next person to open the chapter. Changes is whether what they write is tracked — see Tracking changes below. A collaborator does not need a paid plan of their own. Their role on the project is what decides what they can do with it — see Your Account and Plan. Frozen is the unusual one. It pins a collaborator to the version of the book as it stood, so they can keep reading and referring to it while you carry on editing. It is useful during final proofing, when you do not want a proofreader's page references shifting under them. Only an administrator can change any of this. To change somebody, pick from the dropdowns in their row or tick Admin — it takes effect immediately. Administration is only ever removed by unticking the box. Because an administrator can already do everything Edit, Read and Frozen allow, those three are greyed out in their row: picking one would be a demotion the dropdown has no business making. The last dropdown in a row limits somebody to specific chapters, the same way an invitation link can; everything else in the book is hidden from them. It is greyed out for administrators, who always see the whole project. **Tracking changes**: The Changes dropdown on each row says whether the book marks what that person writes: Changes What happens to their writing As written It goes straight in Track It is marked as a tracked change — theirs to accept Suggest It is marked as a tracked change — for somebody else Marked edits appear as tracked changes until somebody accepts them — for everybody on the project, not just for whoever set it. There is no private version of this and no second opinion to keep in step: one person works through a round of changes and it is worked through. Going through what your own AI wrote is a separate, private review — see Edits the AI made. The difference between Track and Suggest is who has the last word over the person's own changes. Track is for an author who wants their changes visible to their co-authors as they go — you can see what they did this week, and they tidy up after themselves. Suggest is the editorial one: neither the green checkmark nor the red cross is theirs to press over their own changes, because withdrawing a proposal is as much a decision about it as accepting one. They can still rewrite or delete the passage like any other editing; what they cannot do is settle it. Settling other people's changes is the role's business, not this one's. Somebody can be on Approve and on Suggest at once — a co-author who reviews the copy-editor's work while their own still goes past somebody else. **Setting it up for everyone**: Track Changes… at the top of the Users panel walks you through it and fills in everybody's rows: Whose changes are tracked? Tick the people, or start from Everyone, Everyone but me, Only me or Nobody and adjust. Collaborators who can only read are greyed out, since there is nothing of theirs to mark. Who can approve changes? For each person, whether they may approve other people's changes (which puts them on Approve; administrators always can), and — for the people being tracked — whether they approve their own (Track) or leave that to somebody else (Suggest). When does the tracking start? Now, from the beginning, or from a date you pick. If some of them are already tracked, you can keep their current start. The last page lists everything that is about to change, person by person, and warns you if somebody's changes would have nobody else to approve them. Nothing is changed until you press Apply, and you can go Back to any step first. Afterwards, each row can still be adjusted on its own. The wizard opens on how the project is set up now, so it is also a quick way to see that. Once applied, the rows in the panel say the same thing: **From when**: Tracking runs from a date, shown under the dropdown and set to the moment you chose it. That is almost always what you want: a chapter your editor wrote with you last month was not a suggestion, and marking them today should not reopen it. When you do want it reopened, move the date back — or use Everything they have written, which makes it retroactive over everything of theirs in the project. Nothing is lost either way. Every edit is in the record whatever the date says, so moving it is a change of mind you can change back; and an accept somebody made before the project started marking them still stands. **Inviting by email**: Click Invite by Email, enter the address, choose a role, add a message if you like, and send. The invitation arrives by email. The recipient clicks Accept Invite in that email, after which the project appears in their own projects list. Someone new to Inkwell who signs up to accept gets a 30-day free trial when they pick a plan, and you get a month of credit once they pay — see Referring other writers. If they are signed in to Inkwell under a different address from the one you invited — a work address rather than a personal one, say — Inkwell stops to check first, showing both addresses. They can accept as the account they are already in, or sign out and switch to the invited one. Either way the invitation is used up once it is accepted. Opening a link to the project itself — rather than the one in the invitation — does not grant anything. Until the invitation is accepted they see You don't have access to this project, naming the address they are signed in with, so a link sent to the wrong address diagnoses itself. Invitations that have been sent but not yet accepted are listed separately, with a Cancel Invite button if you change your mind. **Inviting by link**: Invite by Link produces a URL that grants access to whoever opens it. Choose the Role the link should confer, and — this is the useful part — optionally restrict it to specific chapters. Anyone using the link gets access to only those chapters. That makes it practical to send a subject-matter expert the two chapters they need to check without exposing the rest of the manuscript. The link updates as you change the role or the chapter selection; use the copy button to put it on the clipboard. **Removing a collaborator**: Remove in a person's row revokes their access, after a confirmation. Their past edits and comments stay in the document and in the history — removing someone does not unpick their work. The project disappears from their projects list straight away, and a tab they still have open on it says You don't have access to this project. Their local copy is discarded with it, so an old link or bookmark will not open the manuscript again. Any AI assistant they had connected loses the project too — see Connecting an AI assistant. **Working with other people's edits**: Chapters containing edits are marked in the chapter list: Inside a chapter, each collaborator's changes are highlighted in their own colour. Hover over a change to see who made it and when — "Jane Doe · Sep 14, 3:02 pm". Consecutive edits by the same person show as one change, so if they came back to it later its time is a span from the first edit to the last, such as "Sep 14, 3:02 – 3:40 pm". Times are to the minute, in your own time zone. To work through them, put the cursor in a change and use the review bar along the bottom of the editor: the green checkmark accepts, the red cross rejects, and the arrows move to the previous or next change. If a collaborator's edits are not marked at all, nobody has set their Changes to Track or Suggest — the bar says No users tracked, and that button opens the Track Changes wizard. Deleted text stays readable until the deletion is accepted, and you can copy it out: drag across the struck-through words to select some of them, or double-click to select the whole deletion, then copy. Clicking a deletion without dragging puts the cursor there, as before. **Moved passages**: Text that is moved rather than rewritten is marked as one move. That is what happens when you drag a selection to somewhere else in the chapter, when you cut it and paste it elsewhere in the same chapter, and when your AI rearranges a chapter for you — its paragraphs, or the items of a list, the rows of a table, or the paragraphs inside a callout or quote. A paragraph your AI moves and rewords a little on the way is a move too, with only the words it changed marked as its edit. A moved paragraph has a bar down its side in the colour of whoever moved it, under a line saying Moved here from above ↑ or Moved here from below ↓. Where it used to be there is a single line, Moved down ↓ or Moved up ↑. A phrase moved within a paragraph, or from one paragraph into another, is underlined twice in that colour instead, with a small moved from marker before it and a moved marker in the line it came from. Click either marker to jump to the other end of the move. Accept keeps the text where it is now; Reject puts it back where it was. The words themselves are not marked as new, because they are not: any edits inside the moved text, by anyone, keep their own marking and are accepted or rejected on their own, and comments on it travel with it. Cutting text in one chapter and pasting it into another is a move too. Above the text where it arrives there is a line, Moved from “…”, naming the chapter it came from, and where it was cut there is a line Moved to “…” → instead of the struck-through text a deletion leaves. Click either line to go to the other chapter. The edits inside the text come with it, still marked as whoever made them, and so do the comments on it, replies and all. Accept and Reject work from either chapter, and settle the move in both. Reject puts the text back where it was cut, with anything written inside it since; undoing the paste does the same. To act on the move from the chapter it left, put the cursor beside the Moved to line, or use the arrows on the review bar to reach it. Text moves this way when you paste it in the same window you cut it in, within a day, and it is either whole paragraphs or words from within one paragraph. Otherwise — a cut that ran from the middle of one paragraph into the next, a paste in another window, or a place it was cut from that has since been written in — it arrives as new text, as any paste does, and its comments still go with it. Copying and pasting is not a move — the original stays where it was. **Edits the AI made**: What your AI agent changes is yours to look over before it counts as your writing. Until you have, it is labelled as your AI rather than your own typing and shown in its own colour — so a passage you wrote and a passage your agent rewrote are never confused for one another — and you go through it with the same toolbar. The Agent starts in Read-only mode by default: it can look at your manuscript but cannot change it, comment on it, or add chapters — asking it to edit just gets you a note saying it can't. Comment mode lets it leave and resolve comments — useful for a review pass where you want its opinion without it touching your prose — but still refuses to edit text or add chapters. Read-write lifts every restriction. Switch modes with the dropdown in the panel's header when you want something different; Inkwell remembers your choice for next time. Your own agent's edits are shown one reply at a time: the ones under the chip you have open in the agent panel appear whatever the project has decided, and the rest stay out of the way until you open theirs. See Reviewing what it changed. That review is between you and your AI, and nobody else's business. No role or standing gates it, and accepting there settles nothing for anybody else: it says you have read the change and it is yours now. Reject takes the change back out of the book, for everyone. To your collaborators your agent is simply you. Its work reaches them as your edits, in your colour, and is marked for them exactly when your own typing would be — whether or not you have looked at it yet. So on Edit or Approve, nobody else is shown it at all. On Track or Suggest, they see it as your tracked change from the moment the agent makes it, and once you have accepted it from your AI it turns into your tracked change for you too, to be settled the way the rest of your writing is: by you on Track, by somebody else on Suggest. The reverse holds as well: a colleague's agent's rewrites arrive here as theirs. An assistant you have connected from outside Inkwell — Claude, ChatGPT, Grok, Gemini, or another — leaves its work here in exactly the same form; see The Agent for how to connect one. Changes with nowhere in the text to point at are listed on the chip instead: Book settings for anything to do with the book's properties, and Book order for chapters added, removed, or reordered — each with its own Accept and Reject. The chip also lists each chapter with changes still pending; click its title to jump to the first one. Accept the rest / Reject the rest settles everything the chip still has. **Comments**: Comments are separate from edits: they annotate the text without changing it. Select the passage and press Ctrl-Alt-M, or use the Insert Comment button on the toolbar. To comment on every place a phrase turns up, look for it in Find & Replace and comment on each result from there. A comment is a conversation, and it appears in the text itself — between the paragraph it is about and the next one, the way a review comment sits under the line it is about. The page breaks for it: the conversation sits on the workspace background rather than on the page, so the manuscript visibly stops where a comment interrupts it and picks up again below. The passage is highlighted and marked with a small numbered bubble, and the thread below carries the same number, so a paragraph with three comments on it never leaves you guessing which is which. Hovering over a thread brightens the passage it belongs to. A paragraph that a quotation, a list or a display equation interrupts is still one paragraph, so the conversation waits until it has finished: it goes after the text that carries on beyond the quotation, rather than between the paragraph and the quotation. **Writing one**: The comment box is a proper editor, and it borrows the one toolbar you already use: put the cursor in a comment and the main toolbar above the page acts on the comment instead of the manuscript. Bold, italic, underline, strikethrough, bulleted and numbered lists, links, Clear Formatting and Undo all work there; everything a comment cannot hold — tables, figures, footnotes, index entries — greys out until you click back into the text. Enter starts a new line, so a comment can lay out two possible fixes on two lines rather than running them together. Ctrl-Enter sends it; Escape closes the box and keeps what you had written for later. Nothing is recorded until you send, so a comment you think better of leaves no trace. **Replying**: Reply adds to the thread. Anybody who can comment can reply to anybody's thread, including a reader whose role is Read — reading a manuscript and saying what is wrong with it is most of what an editor does. You can edit and delete your own messages; an administrator can remove anybody's. Deleting the opening message deletes the whole conversation, replies and all — so that is yours to do only while the thread is still untouched. Once somebody else has replied to it or left a mark on it, their words are theirs, and it takes an administrator to clear the thread away. Your own replies stay yours to withdraw either way. **Reacting, and settling a thread**: Add a reaction — the smiley with a plus, under the conversation — lets everyone in a thread leave their own mark on it, and choose what it says: 👍, ✅, 👀, 🤔, 🎉 or 👎. That is how an author and an editor can each sign off on the same thread and have the two be told apart. Your own mark is the button for changing it, and choosing the one you already have takes it back. Your mark is also how you clear a thread out of your way: it stops being one that is waiting on you, and the panel below can hide the threads you have marked — a manuscript ticked ✅ down its length reads as though the round were finished, because for you it is. A mark is how a thread is settled. There is nothing else to do once everyone who cares has ticked it: the conversation stays on the page, where it is still worth reading, and it is out of everybody's way who has marked it. **Naming somebody**: Type @ in a comment and pick a collaborator. Their name appears as a chip in the comment, and the thread is flagged as waiting on them. Only people with access to the project are offered. **Finding the ones that need you**: The Comments icon in the left rail opens every comment in the book in one list, newest message first within each chapter, with a badge showing how many are waiting on you. A thread is waiting on you if you are in it — you wrote in it, or it names you — and you have not answered: somebody else had the last word, and you have left no mark on it. Click any row to jump to the passage, in whichever chapter it is in — which makes working through a round of editorial comments a matter of going down the list. The row you clicked last stays outlined, so when you come back to the list you can see where you left off. Two controls across the top narrow what you are shown. The first is how close a thread is to you: Everything, Includes Me — the threads you have written in or been named in — Waiting on me, or Nothing, which takes every comment off the page so you can read the manuscript clean. The second is a row of chips, one per mark plus one for the threads you have not marked; every chip starts switched on, and switching one off hides the threads carrying that mark of yours. A filter narrows the manuscript, not just the list. A comment the panel is not showing is not highlighted in the text either: no numbered marker in the margin, and no conversation under the paragraph. That is what makes it worth setting one — you can work a filter at a time through a round of editing and read the pages as they will be, rather than through a hedge of other people's remarks. Nothing is lost by hiding it, including a reply you had half written. The panel says how many are hidden and Clear brings them all back, and while anything is hidden the Comments icon in the rail carries a dot to say so. Filters are remembered in this browser, so the one you set today is still set tomorrow. **The AI's comments**: Your AI agent can hold up its end of a conversation too: it leaves comments, replies to yours, and marks a thread with an emoji. Its messages are labelled as your AI rather than your own hand. You can edit or delete them exactly like one of your own, and it can remove or rewrite what it left — but never one of your messages, or a collaborator's, and it cannot delete a thread you have answered any more than you could delete one of its. **Reverting**: Everything above is recorded in the project's history, so if a collaboration goes wrong you can roll a chapter — or the whole book — back to any earlier point. See Tools.