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

  1. Launch FusionMD. The document browser opens, showing three sections: Blank, Templates, and For Layout.
  2. Click "Blank Document." A new untitled editor window opens. The toolbar shows the mode picker set to "Markdown" (the green default).
  3. Write a heading. Type # My First Document. The heading appears large and bold in real time — syntax highlighting is live.
  4. 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.
  5. Try some formatting. Select a word and click B in the format bar to make it bold. Or type **word** directly — both work.
  6. Insert a list. Press Return twice, then click the bullet-list button in the format bar. Type three items, pressing Return between each.
  7. Open the live preview. Click the eye icon in the toolbar to reveal the rendered Markdown preview alongside the editor.
  8. 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.
  9. Export to PDF. Press ⌘⇧E or go to File → Export → PDF. Choose a save location. The PDF renders using your active text theme.
  10. Save. Press ⌘S. FusionMD saves as .fusiondoc by default.
No lock-in: A .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.
Left sidebar tabs: The left panel has multiple tabs that appear or change with the active mode. In Markdown mode you'll find the Navigator (document outline, jump to any heading), the Boilerplate library, and the Table Creator (visual table builder that outputs Markdown tables). In Variables mode the Variables and Conditions tabs appear; in Script mode the Scene Navigator; in Layout mode the Layout Styles tab.

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

  1. Open any document.
  2. Open the right panel. Click the panel button in the toolbar (rightmost group), or press ⌘2.
  3. Go to the Document Styles tab — the last tab in the right panel. You'll see a list of built-in themes.
  4. Click "Novel." The preview pane immediately updates — a warm serif body font, generous line height, and book-style heading sizes appear.
  5. 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.
  6. Try "Technical." Clean sans-serif body with code-friendly proportions — good for documentation and reference material.
  7. 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.
  8. Set a distinctive heading color. Click the heading color swatch, choose a deep teal. The preview updates live.
  9. Name your theme and click Save. It appears at the top of the list.
  10. Lock it to this document. With your custom theme selected, click "Set as Document Theme." A ✦ symbol appears. This theme now travels with the .fusiondoc file and renders identically on any Mac running FusionMD.
Note: Themes control the preview and export appearance, not the editor view. The editor is always clean and minimal — comfortable to write in regardless of your theme choice.

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

  1. Select a passage in the editor — a sentence, paragraph, or any range of text. AI Polish works on whatever you have highlighted.
  2. 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.
  3. 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
  4. Select a mode and click Rewrite. A progress indicator appears while the AI works.
  5. Review the result. The rewritten text appears in the panel. You haven't changed your document yet — read it carefully first.
  6. Click Apply to replace your selection, Discard to keep your original, or Try Again to discard and rewrite in a different mode.
Language-aware: The rewrite respects your document's language. A French document gets French rewrites; a Canadian English document gets Canadian spelling. If AI is not configured, an error message links you to Settings → AI.

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

  1. Open a blank document.
  2. Locate the AI prompt bar at the bottom of the editor window — a text field with a blue Generate button.
  3. Write a prompt: "Write a 300-word introduction to a report on remote work productivity, including three key statistics as bullet points."
  4. Press ⌘↩ or click Generate. The bar shows "Generating…" while the AI works, then "Added to editor" when content is inserted.
  5. 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.
  6. Edit the content. AI output is just Markdown — select, retype, or delete any part of it normally.
  7. 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.
  8. 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.
Context-aware generation: The AI adapts to the active mode automatically. In Markdown mode it writes content. In Variables mode it declares {{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

  1. From the document browser, click the Templates section and select Proposal.
  2. A configuration sheet lists all required variables: {{client_name}}, {{project_title}}, {{author}}, {{date}}, and more.
  3. Fill in the fields and click "Create Document." A new document opens with all variables replaced by your values.

Authoring a Template

  1. Open a blank document and switch to Variables mode (click "Variables" in the mode picker).
  2. Write your document using {{variable_name}} wherever values should be filled in. Example: "Dear {{recipient_name}}, I am writing on behalf of {{company_name}}."
  3. Open the Variables panel (left sidebar, Variables tab). FusionMD has already detected your variables.
  4. 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.
  5. 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.
  6. Save as template. Click "Save as Template…". The file saves as .fusiontemplate and can be shared with your team.
  7. Open your template. Double-click the .fusiontemplate file. The variable configuration sheet appears. Required fields are enforced — you cannot create the document without completing them.
Six built-in templates: Article, Report, Proposal, Short Story, Screenplay, and Research Paper — each with sensible pre-declared variables. Open them from the document browser to see how templates are constructed.

6 Proofreading & Style Analysis

What you'll learn: using the Proofreader, Style & Clarity, and the Language subtab inside the Writing Coach panel.

Steps

  1. Open any document with several paragraphs of prose.
  2. Open the right panel (⌘2) and click the Writing Coach tab (the checkmark icon).
  3. 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.
  4. 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").
  5. 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.
  6. Filter by category. Use the chips at the top of the list to show only one category at a time (e.g., "Long sentences").
  7. 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).
  8. Enable Adverbs highlight. All adverbs highlight teal. Decide which ones earn their place and which are padding.
  9. Enable Passive Voice highlight. Purple highlights show sentences where the grammatical subject is not the actor. Revise toward active constructions where it improves clarity.
Non-destructive: Highlights are a visual overlay only. Toggle them on and off — they never change your document. The readability score updates live as you edit.

7 The Boilerplate Library

What you'll learn: saving reusable Markdown blocks, organizing them by category, and inserting them into any document.

Steps

  1. Open a document containing text you reuse frequently — a legal disclaimer, a standard bio, an email sign-off.
  2. Select that text in the editor.
  3. 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.
  4. See it in the library. Your block appears under the category you chose.
  5. 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.
  6. Create a few more blocks in different categories. Blocks are organized alphabetically within category groups; "Other" is always last.
  7. Edit a block. Right-click any block → Edit. The next insertion uses the updated version.
App-global library: Every document you open has access to every boilerplate block. Blocks store raw Markdown — variables, headings, tables, and code blocks all work. This is distinct from template variables: boilerplate is static reusable text; variables are fill-in placeholders.

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

  1. Open a multi-section document (article, report, newsletter content). Layout mode works best with structured writing.
  2. Enable Layout mode. Click "Layout" in the mode picker. A confirmation dialog may appear; confirm.
  3. Open the Layout panel. The left sidebar now shows a Layout Styles tab with two sections: Paragraph Styles and Character Styles.
  4. Add paragraph styles. Click + next to Paragraph Styles. Add: "Body Text", "Chapter Title", "Pull Quote", "Byline".
  5. Tag a paragraph. Place your cursor in a paragraph. In the Layout panel, click "Body Text". FusionMD inserts :::Body Text before and ::: after the paragraph — marking it with that style name. Click "Hide Markers" for a cleaner view.
  6. 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.
  7. 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.
  8. Export to IDML. Click "Export as IDML…" in the navigation bar.
  9. 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).
No Pandoc required: IDML export is built into FusionMD — no third-party tools needed. FusionMD prefixes style names with [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

  1. 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.
  2. Insert a title page. In format bar Row 2, click "Title Page." A Fountain title block is inserted. Edit the title and author fields.
  3. Add a scene heading. In Row 1, click "Scene." The snippet INT. LOCATION – DAY is inserted and highlighted purple — ready to edit.
  4. Write an action line. Click "Action" and describe what happens in the scene.
  5. Add a character cue. Click "Character" and type your character's name in ALL CAPS (Fountain standard).
  6. Write dialogue. Click "Dialogue" and type the character's lines. The preview renders them in the screenplay-standard indented position.
  7. Add a parenthetical. Click "Parenthetical" and insert a wryliner like (sarcastically) between the cue and dialogue.
  8. 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.
  9. Add a transition. Click "Transition" and insert CUT TO: between scenes.
  10. Check statistics. Click the statistics button in the toolbar to see page count, scene count, and word count.
  11. Export PDF. File → Export → PDF. The output is a properly formatted screenplay: correct margins, 12pt Courier, scene headings in caps, dialogue properly indented.
AI writes scenes: In Script mode, the AI prompt bar generates Fountain-formatted scenes on demand. Describe what happens and let FusionMD write the draft — scene headings, action, dialogue, and all.

10 Text Transformations

What you'll learn: using built-in transformation rulesets and creating a custom one.

Steps

  1. Open a document that was pasted in from another source — often these have smart/dumb quote inconsistencies, double spaces, or style issues.
  2. Open Text Transformations. Go to Edit → Text Transformations.
  3. Select "Whitespace Cleanup" from the ruleset list. Click Apply. FusionMD reports how many replacements were made (e.g., "47 replacements").
  4. Select "Smart Quotes" and apply. All straight quotes " and ' are converted to curly typographic equivalents.
  5. Create a custom ruleset. Click + in the ruleset list. Name it "My Cleanup Rules."
  6. 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.
  7. Add more rules — for instance, replace "utilise" with "use", or "prior to" with "before."
  8. Apply your ruleset. The report shows how many instances of each rule matched.
Regex supported: Rules can use full regular expressions. Built-in rulesets are read-only; duplicate them to customize. All rulesets are saved and available across every document.

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.

CategoryColorPractical use
NounsBlueSpot noun-heavy sentences that could be tightened
VerbsGreenSee whether action words are doing the work
AdjectivesAmberFind over-described passages
AdverbsPurpleClassic editing target — "kill your adverbs"
PronounsPinkCatch pronoun-heavy prose that loses specificity
PrepositionsTealIdentify prepositional-phrase chains
DeterminersYellowSpot density of articles (the/a/an)
ConjunctionsRedLong conjunction runs signal run-on sentences

Steps

  1. Open a document with at least a few paragraphs of prose.
  2. Open the right panel (⌘2) and click the Parts of Speech tab (the tag icon).
  3. Watch the highlights appear. All eight categories are on by default. Your document text is unchanged — highlights are a visual overlay only.
  4. Toggle categories. Click any row to enable or disable that category. Try turning off everything except Adverbs (purple) for a focused editing pass.
  5. 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.
  6. Check the counts. Each row shows how many times that category appears. Total tagged-word count appears at the bottom.
  7. 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.
  8. 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.
  9. 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.
Supported languages: English (US/UK/AU/CA), French, German, Spanish, Italian, Portuguese, Chinese (Simplified & Traditional), Japanese, Russian, Arabic, and more — controlled by the document language setting.

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.

Note: Most settings take effect immediately — no restart needed. The Editor font size is separate from the text theme font. The editor size is for writing comfort; the theme font controls how your document looks in the preview and in all exports.

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

  1. Open any document (or paste a paragraph with a few deliberate misspellings).
  2. 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.
  3. Click the Spelling subtab (cursor icon). FusionMD scans the document and lists every misspelled word.
  4. Review the list. Each entry shows the word in context. Below each word, suggestion chips display up to five alternative spellings.
  5. Click a suggestion chip. The misspelled word is replaced in the document instantly. The list updates and the corrected word disappears.
  6. 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

  1. Still inside the Writing Coach tab, click the Grammar subtab (checkmark badge icon).
  2. 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.
  3. Where macOS suggests a correction, a clickable button shows the proposed fix. Click it to apply directly.
  4. Where no automatic fix is available, the description helps you understand what to revise. Click the issue to scroll the editor to that location.
  5. Edit yourself if the automatic correction isn't quite right — the grammar panel is advisory, not prescriptive.

Part 3 — Thesaurus, Dictionary & Overused Words

  1. Click the Vocabulary subtab (books icon). Three sections appear: Thesaurus, Dictionary, and Overused Words.
  2. Select a word in the editor. Both the Thesaurus and Dictionary sections populate automatically — no search button needed.
  3. In the Thesaurus section, synonyms, antonyms, and related terms appear as chips. Click any chip to replace the selected word in the document immediately.
  4. 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.
  5. Select a different word. Both sections update instantly.
  6. 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.
All on-device: Overused-word analysis and the thesaurus run entirely on your Mac using Apple's Natural Language framework. External sources (Datamuse, Free Dictionary API) are used for word lookups; attribution appears at the bottom of the Vocabulary panel. No document text is ever transmitted.

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

  1. Open a document. Open the right panel (⌘2) and click the Metadata tab (the info badge icon).
  2. 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.
  3. Set the Author. Type your name exactly as you want it to appear in the ePub file and in Apple Books.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
These fields travel with the document. Save and re-open the file — metadata is stored inside the .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

  1. 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.
  2. 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.
  3. 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.
  4. Export. Go to File → Export… → ePub3, or press ⌘⇧E and choose ePub3 from the format picker. Choose a save location.
  5. Open in Apple Books. Double-click the .epub file. Apple Books opens it. Check the cover, chapter list, text rendering, and any embedded images.
  6. 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.
  7. Distribute. Upload the .epub file to Apple Books Connect, Draft2Digital, Kobo, Smashwords, or any ePub-accepting retailer.
Native ePub3 — no Pandoc required. FusionMD's built-in exporter produces a valid ePub3 file without any third-party tools. If you have Pandoc installed (Settings → Export), an alternative export path is available; the panel offers both options. For most documents the native exporter is faster and produces correct output.

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

  1. Open a document you want to translate — the original will not be changed.
  2. Open the right panel (⌘2) and click the Translation tab (the translate icon).
  3. 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).
  4. 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.
  5. FusionMD translates the document paragraph by paragraph, preserving all paragraph breaks and Markdown structure. YAML front matter (title, author, date) is passed through untranslated.
  6. 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.
  7. 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

  1. Select any passage in the editor — a sentence, a paragraph, or a heading.
  2. Open the Translation panel and confirm the target language.
  3. Click "Translate Selection." The selected text is replaced with the translation immediately. Use ⌘Z to undo if needed.
Entirely on-device. All translation happens using Apple's Translation framework — no API key, no cloud service, and no document text ever leaves your Mac. The same framework powers iOS and macOS system translation. FusionMD simply connects it to your document.

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.

Before you begin: You need a completed manuscript in FusionMD. You also need a free Apple ID and a free Amazon account. Cover image creation is covered in Part 2 — no prior design experience required.

Part 1 — Structure your manuscript

  1. Use # Chapter Title for main chapters — each becomes a top-level table-of-contents entry. Use ## Section for subsections. Do not skip heading levels.
  2. Add a title page as your very first content:
    # Your Book Title
    ## Subtitle
    *by Your Name*
  3. 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

RequirementApple BooksAmazon KDP
Recommended size1600 × 2560 px1600 × 2560 px
Minimum size1400 px on shortest side1000 px on longest side
FormatJPEG or PNGJPEG or TIFF
Max file size4 MB50 MB (keep under 4 MB)
Color modeRGBRGB

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

  1. Open the right panel (⌘2) → Metadata tab.
  2. Title — exactly as it should appear in stores, in title case.
  3. Author — your full name or pen name.
  4. 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.
  5. Language — match the manuscript language. This sets the correct ePub reading direction (right-to-left for Arabic, Hebrew, etc.).
  6. 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

  1. In the right panel → Document Styles, select the ePub Book theme (serif body, first-line indents, generous line height).
  2. File → Export… → ePub3 (or ⌘⇧E). Name the file: your-book-title.epub.
  3. Test in Apple Books: double-click the .epub file. 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

  1. Go to authors.apple.com and sign in with your Apple ID.
  2. Click "Add a New Book." Enter title, author, description, category (up to two), and language.
  3. Upload the cover (1600 × 2560 px JPEG) as the store thumbnail.
  4. Upload the ePub file. Apple validates it automatically — errors include reference numbers. Fix in FusionMD and re-upload if needed.
  5. Set territories and pricing. Apple uses price tiers; set your tier and it prices in each currency automatically. Free books are allowed.
  6. Submit. Apple reviews within 24–72 hours and emails you when it's live.
  7. Full guidelines: support.apple.com/en-us/101662

Part 6 — Publish on Amazon KDP

  1. Go to kdp.amazon.com and sign in with your Amazon account.
  2. Click "+ Kindle eBook."
  3. Page 1 — Details: language, title, author, description, keywords (up to 7), and categories (up to 2 BISAC categories).
  4. Page 2 — Content: skip the ISBN (Amazon assigns a free ASIN). Upload your .epub file. Upload your cover JPEG separately. Click "Preview on Kindle" — verify chapter navigation and images on a Kindle screen.
  5. 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.
  6. Publish. Amazon reviews within 24–72 hours.
  7. 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.

  1. In FusionMD, open the Translation panel → set target language → click "Translate to New Document." The original is untouched. Requires macOS 15+.
  2. Review the translation — check proper nouns, idiomatic expressions, and dialogue tone. Machine translation handles narrative prose well; idioms and character voice may need adjustment.
  3. 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.
  4. Export as your-book-title-es.epub (or whatever language code fits).
  5. 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.
Wide distribution alternative. Draft2Digital (draft2digital.com) distributes to Apple Books, Barnes & Noble, Kobo, and others with one upload. Amazon KDP is not included — upload there directly. They take a small percentage per sale in exchange for handling the distribution.