Skip to content

Exporting Your Work

The Export Tool on macOS

The Export Tool on macOS

Atlas can export your documents in several formats, whether you're sharing a draft, publishing an eBook, or producing a print-ready PDF. Use Cmd+Shift+E or the Editor menu to start an export. Each format includes a live preview so you can fine-tune settings before finalizing.

Info

Document and project exporting are always available, including in Atlas Preview and after your subscription expires. Atlas never holds your data hostage and works in formats that other tools can use. See Atlas Project Files for what a project export contains.

Choosing a Format

When you open the export sheet, you'll need to pick a format.

For rich formats like HTML, ePub, and PDF, selecting a format reveals a thumbnail grid of available styles in the Formatting Settings popover — a mix of the built-in styles that ship with Atlas and any custom styles you've imported or created. Tap or click a card to select it, and the preview on the right updates immediately.

Tip

PDF style cards in the Settings section include an info (i) button that opens a description popover so you can compare options before committing or see special features / instructions to a theme.

See Custom Export Styles for how to import, duplicate, export, and sync your own styles.

Equations in Exports

Documents containing LaTeX equations export with equations rendered as images in HTML, ePub, PDF, and RTF formats. Markdown export preserves the LaTeX source as-is, and plain text export includes the equation syntax. See Math Equations for more.

Export Formats

Markdown

Export as a standard .md file preserving all formatting syntax. Use this when sharing with other markdown-compatible tools or for version-controlled writing workflows.

When exporting a single document as Markdown, an Include Frontmatter toggle is available in the export settings — it defaults on. When enabled, Atlas prepends a YAML block listing tags first, then any metadata field values in project-defined order. This applies only to single-document Markdown exports; bulk and continuous folder exports do not emit frontmatter. See Metadata and Tags for the format details.

Export from Shortcuts

The Export as Markdown action lets you produce the same .md file from the Shortcuts app or Siri—optionally with its frontmatter—so you can automate exporting and, for example, drop the file straight into the system Share sheet. See Shortcuts & Automation.

Plain Text

A rendered .txt file with markdown syntax stripped, leaving clean readable text. Annotations can optionally be included as inline parenthesized text. Footnotes are marked in the text as [1], [2], and so on, with a Notes list at the end of the file. Links to other documents appear as their text. A web link appears as its text followed by the address in parentheses, so [Atlas](https://example.com) becomes Atlas (https://example.com). If the link text is already the address, it appears once.

RTF

Rich Text Format for sharing with word processors and other apps that don't read Markdown. RTF appears in the format picker on iOS and macOS, for both single documents and folders.

  • Fixed styling — RTF uses a standardized style. There's no style picker and no PDF page controls.
  • Images and equations — A document with images or math equations exports as an .rtfd package, which holds a TXT.rtf file plus one file for each image or equation. Any other document exports as a plain .rtf file.
  • Lists, tables, and footnotes — Lists and tables export as real RTF lists and tables. Footnotes appear as numbers, with a Notes section at the end.
  • Settings — The Content section offers Remove Strikethrough Content and Convert Internal Links to Plain Text. For folders, you can also choose separate or continuous output and flat or hierarchical structure.

In a continuous folder export, the separator setting controls the break between documents: a page break gives a real page break, a rule gives a centered line, and none leaves a blank gap. Atlas writes the result as index.rtf, or index.rtfd if any included document has images or equations. Links between documents jump within the file.

The preview shows what will be exported and follows light and dark appearance.

HTML

Web page export with three built-in styles and support for custom styles:

  • System — Default browser styling, minimal overrides.
  • Classic — Traditional document styling with serif headings and comfortable body copy.
  • Minimal — Clean, minimal styling suitable for reading and sharing.

You can also create your own HTML Export Styles, and import Ulysses .ulstyle CSS themes, which Atlas supports directly. See Create a Custom HTML Style for a start-to-finish tutorial, or Custom Export Styles for the full workflow.

ePub 3

Atlas on every platform

ePub eReader Preview

eBook export with four built-in styles — Standard, Serif, Sans, and Black Pearl — plus any custom ePub Export Styles you've imported. ePub export includes:

  • Cover image and author metadata
  • Chapter modes — Single Document, Chapter per Document, or Custom Selection (hand-pick which documents start a chapter)
  • Footnote placement — pop-up (Apple Books style), end of each section, or end of all documents, which adds a final Notes chapter
  • Optional annotations, which follow the footnote placement you choose
  • Kindle Preview — A preview mode that shows the book as pages on a Kindle-style screen
  • Ulysses .ulstyle CSS theme import

See Exporting an ePub for a deeper walk-through of ePub-specific options, or Create a Custom ePub Style to build your own.

PDF

Full PDF export with four built-in styles:

  • Default — Clean sans-serif body with comfortable line spacing. A good general-purpose choice.
  • Modern — Airy layout with narrow margins and centered page numbers in the footer. Great for reports and long reads.
  • Classic — Serif body with justified text and wide margins. Evokes traditional book typesetting.
  • Novel — Trade-paperback (5"×8") layout with two-sided mirrored margins, justified body, automatic chapter page breaks at H1, and running chapter titles in the header of right-hand pages.

Every PDF style (built-in or custom) supports a deep set of options:

Option What it controls
Page size 15 presets including US Letter, US Legal, Tabloid, Tabloid Oversize, 5×8″ (trade paperback), A3, A4, A5, B5, JIS B5, ROC 16K, Super B/A3, and envelope sizes (#10, Chou 3, DL). When a style suggests a size, a lock keeps it pinned to that suggestion — Novel locks to 5×8″; unlock or change the size to go custom.
Margins Style Default, Normal, Narrow, or Wide.
Two-sided layout Mirrored recto/verso margins for facing-page output.
Heading typography Per-level (H1–H6) alignment, weight, slant, top/bottom margins, and page-break-before.
Body, blockquote, link, and code Font, size, color, and spacing per element.
Headers and footers Page number, running heading, custom text, or blank — with separate content for the first page and for recto/verso pages when two-sided is on. Custom text can include {{export.date}} and {{export.words}}.

Custom PDF Export Styles can be created, imported, duplicated, and exported. See Custom Export Styles.

Info

Backslash-escaped characters (for example, \* to keep a literal asterisk) are highlighted in the editor and stripped from the final HTML, ePub, and PDF output so readers see the intended character, not the escape.

Block images sized Small, Medium, or Large in the editor keep that sizing on export — Atlas emits a matching size class in HTML and ePub output. Oversized source images are also automatically downsized and compressed on export, across HTML, ePub, PDF, and Markdown, to keep exported file size reasonable.

Removing Struck-Through Text

The Content settings include a Remove Strikethrough Content toggle, on by default, that drops any struck-through (~~like this~~) text — including whole struck lines — from the exported output. It's handy for keeping editing marks like deleted passages out of a shared draft. It applies to every text-based format: plain text, HTML, ePub, PDF, and RTF. Markdown export is the exception — it always preserves the raw ~~…~~ source so nothing is lost when you round-trip a file.

The Content settings also include a Convert Internal Links to Plain Text toggle. It's off by default, Atlas remembers your choice, and it appears under Content in every format. It replaces links to other documents, including [[wiki-links]], with their text so the exported file has no internal links. It applies to document links and canvas-item links.

Turn it on when you're sending a document somewhere that links to other documents would make no sense, or when you want a clean, link-free copy. See Internal Links in Exports for what happens when it's off.

Export Preview

Every export includes a live preview that updates as you change settings, making it easy to experiment before committing. When exporting a folder in continuous mode, the preview can scroll to individual documents so you can verify specific sections.

Links work in the preview too. Clicking a link to another document shows that document in Quick Look, and web links open in your default browser (on iOS, through the in-app browser setting). The preview keeps its scroll position when it refreshes, so changing a setting doesn't send you back to the top.

ePub and PDF exports add a preview mode to the toolbar. Kindle Preview (ePub) shows the book as pages on a Kindle-style screen, so you can judge how it reads on an e-reader. Double Page View (PDF) shows pages side by side as spreads, which helps when you're checking a two-sided layout. Both affect only the preview and never the exported file, and Atlas doesn't remember them between sessions. Double Page View is available on Mac and on iPad in regular width, but not on iPhone. See Kindle Preview for how it behaves.

The Export Tool follows your project. If you rename, add, remove, or reorder documents while it's open, the document list and preview update to match. Atlas also remembers the HTML style you used last.

Exporting Folders

When you export a folder, Atlas includes all its contents and offers additional options to control the output. These options apply across all formats, including the PDF pipeline.

Choosing Which Documents to Include

The export inspector lists the folder's documents under Exportable Documents. Each row has an Include in export toggle, so you can leave individual documents out without moving or deleting them. In ePub Custom Selection chapter mode this control becomes a bookmark button that marks where chapters begin — there, enabling or disabling a document moves to the row's context menu (Enable Export / Disable Export). Excluded documents are dimmed in the list.

Output Mode

  • Separate files — One file per document, useful when you need individual files for each piece
  • Continuous — All documents combined into a single file, with configurable separators: none, horizontal rule, or page break

Folder exports follow the reading order in the Organizer: each parent comes before its children, going depth first. Trashed documents, and anything inside a trashed folder, are skipped. Canvases and web pages inside a folder aren't exported, and a folder that holds only canvases or web pages can't be exported.

Folder Structure (Separate Files)

  • Flat — All files exported at the same level
  • Hierarchical — Preserves your folder structure in the output. A document with children gets its own folder.

Exported file names are always unique, regardless of letter case, so documents titled Notes and notes no longer collide. A / or other character that isn't allowed in file names becomes a space.

Image Location

  • Subfolder — Images placed in an images/ subfolder
  • Root — Images placed alongside documents at the root level

Each folder remembers its export settings independently, so you can configure once and re-export without reconfiguring. See Using Folders for more on how folders support your workflow.

Export Warnings

When something can't be included in a single-item export, Atlas shows an Exported with Warnings alert before the share sheet or save panel and lists what was left out. Choose Continue to finish the export. The alert covers canvases and web pages, remote images that PDF and RTF couldn't download, and, for ePub, standalone media files, since an ePub book includes only the images placed inside your documents.

Internal atlas:// links reference documents by identifier, which only works inside Atlas. Atlas resolves these for you on every export, so readers never end up with a broken atlas:// reference. Links to other documents work in the exported file, and the link text stays as you wrote it. How a link behaves depends on the format:

  • Markdown — Internal links are written as [[Title]] or [[Title|alias]]. A link that simply shows the document title becomes [[Chapter 3: The Storm]]; a link with custom display text becomes [[Chapter 3: The Storm|see the storm]]. Because Atlas reads this same syntax back in, exported Markdown round-trips, and re-importing the file relinks the documents by title. See Round-Tripping Through Markdown.
  • HTML, separate files — Links point to the sibling files using relative links.
  • HTML, continuous — Links jump to the document within the page.
  • ePub — Links go to the chapter.
  • PDF, continuous — Links are clickable and jump to the first line of the document.
  • PDF, separate files — Links open the other PDFs.
  • RTF, continuous — Links jump to the document within the file.
  • Plain Text — Never has links. Internal links appear as their text.

If the linked document isn't part of the export, either because you excluded it or because you're exporting a single document, the link becomes plain text. Links inside footnotes and annotations are also plain text. Any external https:// links are left untouched.

To remove every internal link from the output, turn on Convert Internal Links to Plain Text in the Content settings. Every link in every format then becomes its visible text and nothing jumps.

See Also