FusionMD — Tutorials
Written guides for every feature in FusionMD — from your first document to professional layout export, ePub3 publishing, and document translation. Work through them in order or jump to any section using the contents list.
1 Your First Document
What you'll learn: creating a document, writing in Markdown, and exporting to PDF.
Steps
- Launch FusionMD. The document browser opens, showing three sections: Blank, Templates, and For Layout.
- Click "Blank Document." A new untitled editor window opens. The toolbar shows the mode picker set to "Markdown" (the green default).
- Write a heading. Type
# My First Document. The heading appears large and bold in real time — syntax highlighting is live. - Write body text. Press Return twice and write a paragraph. Notice the word count in the status bar updates as you type, and the preview pane on the right renders your text.
- Try some formatting. Select a word and click B in the format bar to make it bold. Or type
**word**directly — both work. - Insert a list. Press Return twice, then click the bullet-list button in the format bar. Type three items, pressing Return between each.
- Open the live preview. Click the eye icon in the toolbar to reveal the rendered Markdown preview alongside the editor.
- Adjust the preview split. Drag the divider between the editor and preview left or right. Drag all the way right to go full-screen editor; all the way left to see only the preview.
- Export to PDF. Press ⌘⇧E or go to File → Export → PDF. Choose a save location. The PDF renders using your active text theme.
- Save. Press ⌘S. FusionMD saves as
.fusiondocby default.
.fusiondoc file is a ZIP archive. Rename it .zip and open it — your plain Markdown is inside as content.md, readable by any editor, forever.
2 Choosing & Customizing a Text Theme
What you'll learn: applying a built-in theme, customizing fonts and colors, and locking a theme to a document.
Steps
- Open any document.
- Open the right panel. Click the panel button in the toolbar (rightmost group), or press ⌘2.
- Go to the Document Styles tab — the last tab in the right panel. You'll see a list of built-in themes.
- Click "Novel." The preview pane immediately updates — a warm serif body font, generous line height, and book-style heading sizes appear.
- Try "Typewriter." The monospaced font and tighter spacing give the preview a classic typewritten look. The editor background stays clean while the preview and all exports reflect the theme.
- Try "Technical." Clean sans-serif body with code-friendly proportions — good for documentation and reference material.
- Create a custom theme. Click the + button. A sheet opens with controls for: body font, heading font, code font, colors (body text, headings, links, background), line height, and margins.
- Set a distinctive heading color. Click the heading color swatch, choose a deep teal. The preview updates live.
- Name your theme and click Save. It appears at the top of the list.
- Lock it to this document. With your custom theme selected, click "Set as Document Theme." A ✦ symbol appears. This theme now travels with the
.fusiondocfile and renders identically on any Mac running FusionMD.
3 AI Polish: Rewriting Selected Text
What you'll learn: using AI to rewrite, fix, shorten, or simplify a selected passage — and reviewing the result before applying it.
Prerequisite
You need either Apple Intelligence (macOS 26, Apple Silicon, enabled in System Settings) or an OpenRouter API key in Settings → AI.
Steps
- Select a passage in the editor — a sentence, paragraph, or any range of text. AI Polish works on whatever you have highlighted.
- Open the Writing Coach tab in the right panel (the checkmark icon). Click the Cleanup subtab (wand-and-sparkles icon), then select AI Polish in the segmented control at the top.
- The panel shows a preview of your selected text and four rewrite modes:
- Polish — full professional edit: improves clarity, flow, and style while fixing all errors
- Fix Errors — proofreading only: corrects spelling and grammar with minimum changes
- Shorten — reduces the passage to roughly half its length while keeping all meaning
- Simplify — rewrites in plain language with shorter sentences
- Select a mode and click Rewrite. A progress indicator appears while the AI works.
- Review the result. The rewritten text appears in the panel. You haven't changed your document yet — read it carefully first.
- Click Apply to replace your selection, Discard to keep your original, or Try Again to discard and rewrite in a different mode.
4 Using the AI Prompt Bar
What you'll learn: generating content with AI, understanding context-aware prompts, and inserting AI content at a specific cursor position.
Prerequisite
You need Apple Intelligence or an OpenRouter API key. Go to Settings → AI to configure.
Steps
- Open a blank document.
- Locate the AI prompt bar at the bottom of the editor window — a text field with a blue Generate button.
- Write a prompt: "Write a 300-word introduction to a report on remote work productivity, including three key statistics as bullet points."
- Press ⌘↩ or click Generate. The bar shows "Generating…" while the AI works, then "Added to editor" when content is inserted.
- The content appears at your cursor position — not at the end of the document. Place your cursor anywhere before generating to control where content lands.
- Edit the content. AI output is just Markdown — select, retype, or delete any part of it normally.
- Try an inline expansion. Write a paragraph yourself, place your cursor at the end, and prompt: "Continue with a paragraph about asynchronous communication." The AI appends at the cursor.
- Switch to Variables mode (click "Variables" in the mode picker). The prompt bar placeholder changes. Prompt: "A consulting proposal template for a software project." The AI generates a full proposal with
{{client_name}},{{budget}}, and other variables already declared and detected in the Variables panel.
{{variables}}. In Script mode it writes Fountain-format scenes. In Design mode it generates a YAML styles: front-matter block for document typography. In Layout mode it tags content with paragraph style names.
5 Templates & Variables
What you'll learn: using the built-in templates, filling variables, creating your own template, and using conditions.
Using a Built-in Template
- From the document browser, click the Templates section and select Proposal.
- A configuration sheet lists all required variables:
{{client_name}},{{project_title}},{{author}},{{date}}, and more. - Fill in the fields and click "Create Document." A new document opens with all variables replaced by your values.
Authoring a Template
- Open a blank document and switch to Variables mode (click "Variables" in the mode picker).
- Write your document using
{{variable_name}}wherever values should be filled in. Example: "Dear {{recipient_name}}, I am writing on behalf of {{company_name}}." - Open the Variables panel (left sidebar, Variables tab). FusionMD has already detected your variables.
- Expand a variable. Click its disclosure arrow and set a label, type (Text, Date, Number, or List), required toggle, and placeholder text. Dates get a date picker; lists get a dropdown — this is enforced when the template is filled.
- Add a condition. Click the Conditions tab and add a toggle condition, for example
include_signature. Wrap an optional section in your document with a conditional block. One template can now cover both the full and short version of a document. - Save as template. Click "Save as Template…". The file saves as
.fusiontemplateand can be shared with your team. - Open your template. Double-click the
.fusiontemplatefile. The variable configuration sheet appears. Required fields are enforced — you cannot create the document without completing them.
6 Proofreading & Style Analysis
What you'll learn: using the Proofreader, Style & Clarity, and the Language subtab inside the Writing Coach panel.
Steps
- Open any document with several paragraphs of prose.
- Open the right panel (⌘2) and click the Writing Coach tab (the checkmark icon).
- Set document language. Click the Language subtab (globe icon). Select your document's language (e.g., English — United Kingdom). This drives spell checking, smart-quote style, and the dialogue checker simultaneously. Hover any subtab icon to see its name in the tooltip.
- Switch to the Proofreader. Click the Proofread subtab (checkmark circle icon). It scans the document and lists issues grouped into categories: unfilled placeholders, repeated phrases, unmatched punctuation, long sentences (>40 words), capitalization errors, and word-usage mistakes ("alot", "could of").
- Click an issue. FusionMD highlights the relevant text in the editor. If the issue is auto-correctable, a Fix button appears — click it to apply the correction.
- Filter by category. Use the chips at the top of the list to show only one category at a time (e.g., "Long sentences").
- Switch to Style & Clarity. Click the Style subtab. You'll see: Flesch-Kincaid reading ease score, estimated grade level, average sentence length, and highlight mode buttons — Adjectives (green), Adverbs (teal), Passive Voice (purple), Filler Words (amber).
- Enable Adverbs highlight. All adverbs highlight teal. Decide which ones earn their place and which are padding.
- Enable Passive Voice highlight. Purple highlights show sentences where the grammatical subject is not the actor. Revise toward active constructions where it improves clarity.
7 The Boilerplate Library
What you'll learn: saving reusable Markdown blocks, organizing them by category, and inserting them into any document.
Steps
- Open a document containing text you reuse frequently — a legal disclaimer, a standard bio, an email sign-off.
- Select that text in the editor.
- Save as boilerplate. In the left sidebar, click the Boilerplate tab. Click "Save Selection as Block." Enter a name (e.g., "Privacy Policy Footer") and an optional category (e.g., "Legal"). Click Save.
- See it in the library. Your block appears under the category you chose.
- Insert it elsewhere. Open a different document. Open the Boilerplate panel, find your block, and click Insert. The Markdown is pasted at the cursor — exactly the text you saved.
- Create a few more blocks in different categories. Blocks are organized alphabetically within category groups; "Other" is always last.
- Edit a block. Right-click any block → Edit. The next insertion uses the updated version.
8 Exporting for Professional Layout (IDML)
What you'll learn: using Layout mode to tag content with paragraph styles, and exporting to IDML for Affinity Publisher or Adobe InDesign.
Steps
- Open a multi-section document (article, report, newsletter content). Layout mode works best with structured writing.
- Enable Layout mode. Click "Layout" in the mode picker. A confirmation dialog may appear; confirm.
- Open the Layout panel. The left sidebar now shows a Layout Styles tab with two sections: Paragraph Styles and Character Styles.
- Add paragraph styles. Click + next to Paragraph Styles. Add: "Body Text", "Chapter Title", "Pull Quote", "Byline".
- Tag a paragraph. Place your cursor in a paragraph. In the Layout panel, click "Body Text". FusionMD inserts
:::Body Textbefore and:::after the paragraph — marking it with that style name. Click "Hide Markers" for a cleaner view. - Tag an inline span. Select a word in the editor. In the Character Styles panel, click a style name to wrap it in the inline syntax.
- Use AI for layout generation. Clear the document. In the AI prompt bar, type: "Write a 4-article newspaper front page covering local government, arts, sports, and weather. Tag each article with appropriate paragraph styles." The AI generates multiple annotated articles — each becomes a separate IDML TextFrame.
- Export to IDML. Click "Export as IDML…" in the navigation bar.
- Open in Affinity or InDesign. Your content appears in TextFrames on a grid. Your style names are in the Paragraph Styles panel, pre-tagged, ready to assign visual appearance (font, size, color).
[FUSION] to avoid collisions with any styles already in your layout document.
9 Writing a Screenplay
What you'll learn: switching to Script mode, using the Fountain format bar, navigating scenes, and exporting a screenplay PDF.
Steps
- Create a new document. In the mode picker, click "Script." The editor transforms: Courier New 12pt appears, the left panel shows the Scene Navigator, and the format bar gains screenplay-specific buttons.
- Insert a title page. In format bar Row 2, click "Title Page." A Fountain title block is inserted. Edit the title and author fields.
- Add a scene heading. In Row 1, click "Scene." The snippet
INT. LOCATION – DAYis inserted and highlighted purple — ready to edit. - Write an action line. Click "Action" and describe what happens in the scene.
- Add a character cue. Click "Character" and type your character's name in ALL CAPS (Fountain standard).
- Write dialogue. Click "Dialogue" and type the character's lines. The preview renders them in the screenplay-standard indented position.
- Add a parenthetical. Click "Parenthetical" and insert a wryliner like
(sarcastically)between the cue and dialogue. - Add a second scene. Click "Scene" again. Notice the Scene Navigator on the left — your new scene appears as a clickable entry for instant navigation.
- Add a transition. Click "Transition" and insert
CUT TO:between scenes. - Check statistics. Click the statistics button in the toolbar to see page count, scene count, and word count.
- Export PDF. File → Export → PDF. The output is a properly formatted screenplay: correct margins, 12pt Courier, scene headings in caps, dialogue properly indented.
10 Text Transformations
What you'll learn: using built-in transformation rulesets and creating a custom one.
Steps
- Open a document that was pasted in from another source — often these have smart/dumb quote inconsistencies, double spaces, or style issues.
- Open Text Transformations. Go to Edit → Text Transformations.
- Select "Whitespace Cleanup" from the ruleset list. Click Apply. FusionMD reports how many replacements were made (e.g., "47 replacements").
- Select "Smart Quotes" and apply. All straight quotes
"and'are converted to curly typographic equivalents. - Create a custom ruleset. Click + in the ruleset list. Name it "My Cleanup Rules."
- Add a rule. Click + in the rules list. Set Find:
\bvery\b(regex), Replace: (leave empty). This removes "very" from the document — a classic style edit. - Add more rules — for instance, replace "utilise" with "use", or "prior to" with "before."
- Apply your ruleset. The report shows how many instances of each rule matched.
11 Parts of Speech Analyzer
What you'll learn: color-coding your text by grammatical category, using the panel to analyze prose patterns, and working across languages.
What it does
The Parts of Speech panel identifies every word by its grammatical role and highlights each category in a distinct color — live, non-destructively, in any language Apple's Natural Language framework supports. All analysis runs on-device; no internet connection required.
| Category | Color | Practical use |
|---|---|---|
| Nouns | Blue | Spot noun-heavy sentences that could be tightened |
| Verbs | Green | See whether action words are doing the work |
| Adjectives | Amber | Find over-described passages |
| Adverbs | Purple | Classic editing target — "kill your adverbs" |
| Pronouns | Pink | Catch pronoun-heavy prose that loses specificity |
| Prepositions | Teal | Identify prepositional-phrase chains |
| Determiners | Yellow | Spot density of articles (the/a/an) |
| Conjunctions | Red | Long conjunction runs signal run-on sentences |
Steps
- Open a document with at least a few paragraphs of prose.
- Open the right panel (⌘2) and click the Parts of Speech tab (the tag icon).
- Watch the highlights appear. All eight categories are on by default. Your document text is unchanged — highlights are a visual overlay only.
- Toggle categories. Click any row to enable or disable that category. Try turning off everything except Adverbs (purple) for a focused editing pass.
- Use "None" then selectively re-enable. Click None at the bottom to clear all highlights, then tap individual categories to switch them on one at a time.
- Check the counts. Each row shows how many times that category appears. Total tagged-word count appears at the bottom.
- Try a practical editing pass:
- Enable only Adjectives (amber). Does each amber word add meaning, or does the noun carry it alone?
- Enable only Adverbs (purple). Consider replacing verb-adverb pairs with a single stronger verb ("walked slowly" → "shuffled").
- Enable Verbs and Nouns together. Well-written action prose is mostly green and blue.
- Switch document language. Open the Grammar tab and change the language to French, then return to the Parts of Speech tab. The analysis updates using French grammar models.
- Explain a word with AI. Select any single word. At the bottom of the panel, the Explain section appears. Click "Explain with AI" (sparkles button). In 2–3 sentences the AI explains why that word functions as that part of speech in this specific sentence. Requires Apple Intelligence or an OpenRouter API key.
12 Settings & Customizing Your Environment
What you'll learn: the seven settings tabs and how to set up FusionMD the way you want it.
Quick Tour of Settings (⌘,)
General
Toggle "Enable professional layout features" to show or hide Layout mode and IDML export. Writers who don't need layout can keep the interface clean.
Appearance
Choose from 19 interface color themes — from clean minimal options like Stone and Slate to vibrant accents like Ocean, Rust, and Sage. The selected theme applies to the app chrome: toolbar, sidebars, and panels. Enable Contrast Boost for enhanced text contrast throughout the interface.
Editor
Drag the font size slider (8–28pt) — the editor updates live. Adjust line height and paragraph spacing. Toggle Typewriter Mode, Focus Mode (line dimming), Show Invisibles, and Soft Wrap. Disable Spell Check for code-heavy documents where Apple's checker is intrusive.
Export
Set your default export format. See Pandoc status — if not installed, click the install guidance button. Set paper size for PDF export: Letter, A4, or Legal.
Accessibility
Reduce Motion disables animated transitions. Font Size Multiplier scales all UI text up. High Contrast Mode enforces higher contrast ratios throughout the UI.
AI
Paste your OpenRouter API key and select your preferred AI provider. Use Apple Intelligence for fully on-device generation (macOS 26, Apple Silicon required). The trial status and purchase link are also shown here.
About
App version, build, and license status. Links to the website, documentation, and the feedback issue tracker.
13 Writing Coach: Spelling, Grammar & Vocabulary
What you'll learn: using the Spelling panel to fix misspellings in one click, the Grammar panel to understand and resolve grammar issues, and the Vocabulary tab to look up synonyms, definitions, and spot overused words.
The Writing Coach is the collection of eight analysis tools inside the Writing Coach tab in the right panel: Spelling, Grammar, Proofread, Style, Vocabulary, Language, Dialogue, and Cleanup. This tutorial covers Spelling, Grammar, and Vocabulary.
Part 1 — Spell Check
- Open any document (or paste a paragraph with a few deliberate misspellings).
- Open the right panel (⌘2) and click the Writing Coach tab (checkmark icon). The eight subtab icons appear in a scrollable row. Hover any icon to see its name.
- Click the Spelling subtab (cursor icon). FusionMD scans the document and lists every misspelled word.
- Review the list. Each entry shows the word in context. Below each word, suggestion chips display up to five alternative spellings.
- Click a suggestion chip. The misspelled word is replaced in the document instantly. The list updates and the corrected word disappears.
- Repeat until the list is empty. If a word is correctly spelled but unfamiliar to the dictionary (a proper noun, technical term), simply ignore it — the list does not modify your text unless you click a chip.
Part 2 — Grammar Analysis
- Still inside the Writing Coach tab, click the Grammar subtab (checkmark badge icon).
- FusionMD lists grammar issues found by the macOS grammar engine. Each issue shows a plain-English description ("Agreement — verb does not agree with subject", "Fragment — consider revising") along with the surrounding text for context.
- Where macOS suggests a correction, a clickable button shows the proposed fix. Click it to apply directly.
- Where no automatic fix is available, the description helps you understand what to revise. Click the issue to scroll the editor to that location.
- Edit yourself if the automatic correction isn't quite right — the grammar panel is advisory, not prescriptive.
Part 3 — Thesaurus, Dictionary & Overused Words
- Click the Vocabulary subtab (books icon). Three sections appear: Thesaurus, Dictionary, and Overused Words.
- Select a word in the editor. Both the Thesaurus and Dictionary sections populate automatically — no search button needed.
- In the Thesaurus section, synonyms, antonyms, and related terms appear as chips. Click any chip to replace the selected word in the document immediately.
- In the Dictionary section, the full entry loads: phonetic pronunciation, part of speech, definitions, and example sentences. The dictionary is language-aware — it uses your document's language setting.
- Select a different word. Both sections update instantly.
- Scroll to Overused Words. This analysis runs on the full document without requiring a selection. It shows content words (nouns, verbs, adjectives, adverbs) that appear three or more times. A word recurring frequently is not always a problem — "character" in a story is fine. The list highlights candidates for review. Select a listed word and the Thesaurus suggests alternatives.
The other two subtabs
- Dialogue (speech bubble icon) — analyses dialogue in fiction. Detects dialogue-heavy passages, checks for balanced attribution ("said" vs more colourful verbs), and flags long unbroken dialogue runs without action beats. Most useful in Script mode and in fiction documents.
- Cleanup (wand-and-sparkles icon) — runs configurable text-transformation rules across the document. Built-in rulesets include Whitespace Cleanup (normalises spacing), Smart Quotes (converts straight quotes to curly), and Em Dash Spacing. You can add custom find-and-replace rules. The AI Polish option rewrites selected text using the active AI model.
14 Document Metadata & Cover Image
What you'll learn: setting your document's title, author, description, language, and cover image in the Metadata panel — the fields ePub3 export and distributors need.
Steps
- Open a document. Open the right panel (⌘2) and click the Metadata tab (the info badge icon).
- Set the Title. By default this matches the document title FusionMD uses in the browser. Edit it here to set the published title independently of the filename.
- Set the Author. Type your name exactly as you want it to appear in the ePub file and in Apple Books.
- Add a Description. Write one to three sentences that describe the book. This appears in the ePub's metadata and in ebook store listings when you upload the file.
- Set the Language. The language picker here mirrors the document language setting. Arabic, Hebrew, and Persian set the reading direction to right-to-left automatically in every export.
- Attach a Cover Image. Click "Choose Cover Image…" and select a JPEG or PNG. FusionMD stores it with the document and embeds it in every ePub3 export. The recommended size is 1600 × 2560 px.
- Verify. All fields are optional individually, but a complete set — title, author, description, language, and cover — is required by most ebook distributors before they will accept an upload.
.fusiondoc archive. If you duplicate the document to create a translation, copy the metadata too and update the Language field.
15 Exporting an ePub3 Ebook
What you'll learn: preparing a document for ePub export, choosing the right text theme, and producing a distribution-ready ePub3 file.
Before you export
A well-structured Markdown document exports a well-structured ebook. Use heading levels consistently — # Chapter One, ## Section — because FusionMD turns each heading into a chapter entry in the ePub's table of contents.
Steps
- Complete the Metadata panel. See Tutorial 14. At minimum set Title, Author, and Language. Attach a cover image if you have one — it is embedded automatically.
- Choose a text theme. Open the Document Styles tab in the right panel. For fiction and narrative prose, select the ePub Book theme — it applies serif body type, first-line paragraph indents, and generous line height. For technical writing, Technical works well. The theme controls how the ebook renders in Apple Books and other readers.
- Preview the output. The live web preview panel (drag the divider left to widen it) shows a close approximation of what the ebook will look like.
- Export. Go to File → Export… → ePub3, or press ⌘⇧E and choose ePub3 from the format picker. Choose a save location.
- Open in Apple Books. Double-click the
.epubfile. Apple Books opens it. Check the cover, chapter list, text rendering, and any embedded images. - Check for large files. If the document contains many embedded images or video, FusionMD warns you before export if the combined file size exceeds 50 MB — Apple Books and most distributors have practical limits on file size.
- Distribute. Upload the
.epubfile to Apple Books Connect, Draft2Digital, Kobo, Smashwords, or any ePub-accepting retailer.
16 Translating a Document
What you'll learn: translating an entire document into another language and opening the result in a new window, and translating a selected passage in-place.
Prerequisite
Translation requires macOS 15 Sequoia or later. Language packs are downloaded once from Apple on first use; subsequent translations run entirely on-device with no internet connection required.
Part 1 — Translate a full document to a new window
- Open a document you want to translate — the original will not be changed.
- Open the right panel (⌘2) and click the Translation tab (the translate icon).
- Set the target language. The "From" language is detected from your document's language setting. Click the "To" picker and choose your target — for example, Français (France).
- Click "Translate to New Document." If the required language pack is not yet downloaded, macOS shows a one-time download prompt. After accepting, translation begins automatically.
- FusionMD translates the document paragraph by paragraph, preserving all paragraph breaks and Markdown structure. YAML front matter (title, author, date) is passed through untranslated.
- Review the result. A new document window opens with the translated text. The original document is untouched. Both windows are independent — save, export, or discard the translation as needed.
- Set the new document's language. The translated document's language is automatically set to the target language, so spell checking and smart quotes update accordingly.
Part 2 — Translate a selection in-place
- Select any passage in the editor — a sentence, a paragraph, or a heading.
- Open the Translation panel and confirm the target language.
- Click "Translate Selection." The selected text is replaced with the translation immediately. Use ⌘Z to undo if needed.
17 Publishing on Apple Books & Amazon KDP
What you'll learn: preparing a professional ebook in FusionMD, meeting the exact technical requirements for Apple Books and Amazon Kindle, publishing on both platforms, and using FusionMD's translation feature to publish foreign-language editions.
This is a complete follow-along walkthrough. By the end you will have a finished ebook live on both Apple Books and Amazon KDP. Work through each part in order — they build on each other.
Part 1 — Structure your manuscript
- Use
# Chapter Titlefor main chapters — each becomes a top-level table-of-contents entry. Use## Sectionfor subsections. Do not skip heading levels. - Add a title page as your very first content:
# Your Book Title## Subtitle*by Your Name* - Body images: JPEG for photos, PNG for diagrams. Maximum 1200 px wide, under 1 MB each, keep total embedded media under 40 MB. Drag images directly into the editor to embed them.
Part 2 — Cover image specifications
| Requirement | Apple Books | Amazon KDP |
|---|---|---|
| Recommended size | 1600 × 2560 px | 1600 × 2560 px |
| Minimum size | 1400 px on shortest side | 1000 px on longest side |
| Format | JPEG or PNG | JPEG or TIFF |
| Max file size | 4 MB | 50 MB (keep under 4 MB) |
| Color mode | RGB | RGB |
Use a single file for both: 1600 × 2560 px JPEG, RGB, under 4 MB. Create it in Canva (search "Kindle ebook cover" for a pre-sized template), Apple Keynote, or commission a designer with that brief.
Part 3 — Metadata panel in FusionMD
- Open the right panel (⌘2) → Metadata tab.
- Title — exactly as it should appear in stores, in title case.
- Author — your full name or pen name.
- Description — 150–300 words of store listing copy. Hook in the first sentence; end with a call to action. Amazon allows HTML formatting in descriptions; you can add that later in KDP's dashboard.
- Language — match the manuscript language. This sets the correct ePub reading direction (right-to-left for Arabic, Hebrew, etc.).
- Cover image — click "Choose Cover Image…" and select your 1600 × 2560 px JPEG. It embeds automatically in every ePub3 export.
Part 4 — Export and test
- In the right panel → Document Styles, select the ePub Book theme (serif body, first-line indents, generous line height).
- File → Export… → ePub3 (or ⌘⇧E). Name the file:
your-book-title.epub. - Test in Apple Books: double-click the
.epubfile. Check the cover, table of contents, body text, and all images. Fix anything in FusionMD and re-export before uploading.
Part 5 — Publish on Apple Books Connect
- Go to authors.apple.com and sign in with your Apple ID.
- Click "Add a New Book." Enter title, author, description, category (up to two), and language.
- Upload the cover (1600 × 2560 px JPEG) as the store thumbnail.
- Upload the ePub file. Apple validates it automatically — errors include reference numbers. Fix in FusionMD and re-upload if needed.
- Set territories and pricing. Apple uses price tiers; set your tier and it prices in each currency automatically. Free books are allowed.
- Submit. Apple reviews within 24–72 hours and emails you when it's live.
- Full guidelines: support.apple.com/en-us/101662
Part 6 — Publish on Amazon KDP
- Go to kdp.amazon.com and sign in with your Amazon account.
- Click "+ Kindle eBook."
- Page 1 — Details: language, title, author, description, keywords (up to 7), and categories (up to 2 BISAC categories).
- Page 2 — Content: skip the ISBN (Amazon assigns a free ASIN). Upload your
.epubfile. Upload your cover JPEG separately. Click "Preview on Kindle" — verify chapter navigation and images on a Kindle screen. - Page 3 — Pricing: skip KDP Select for now (it requires 90-day Amazon exclusivity, preventing Apple Books sales). Choose "Worldwide rights." For 70% royalty, price between $2.99 and $9.99. Amazon calculates international prices automatically.
- Publish. Amazon reviews within 24–72 hours.
- ePub submission guide: kdp.amazon.com — ePub guidelines
Part 7 — Translate and publish foreign-language editions
Each translated edition is a separate, independent book listing that earns alongside the original. The five highest-value ebook markets after English are Spanish, German, French, Portuguese (Brazil), and Japanese.
- In FusionMD, open the Translation panel → set target language → click "Translate to New Document." The original is untouched. Requires macOS 15+.
- Review the translation — check proper nouns, idiomatic expressions, and dialogue tone. Machine translation handles narrative prose well; idioms and character voice may need adjustment.
- Update the Metadata panel in the new document: confirm the language is set correctly, translate the description, and optionally create a cover with the title in the target language.
- Export as
your-book-title-es.epub(or whatever language code fits). - Create a new book listing on both Apple Books Connect and Amazon KDP. It is a separate book. Set the Language field to match — Amazon uses this to direct the listing to the correct regional stores.
Going further — ePub publishing guide
Ready to publish your ebook on Apple Books and Amazon KDP? The full step-by-step guide covers manuscript structure, cover image specifications, metadata, exporting, uploading to both stores, and using FusionMD's translation feature to publish in multiple languages.
Are You an ePub Author? A complete walkthrough from FusionMD manuscript to published ebook on Apple Books and Amazon KDP — including cover specs, translation, and reaching a global audience. →