iA Writer Templates: Install, Customize and Export (2026)
November 11, 2026 · 10 min read
iA Writer Templates: How Preview, PDF and Custom Templates Work
iA Writer templates are small bundles of HTML, CSS and JavaScript that decide how your text looks in Preview, in print and in exported PDFs. They never touch the Markdown itself. This guide covers the built-in choices, iA's free extras, installing on Mac, iPad and Windows, and building or tweaking your own.
What Are iA Writer Templates?
A template is a tiny web page that wraps your document. iA Writer converts your Markdown to HTML, drops it into the template's page, and styles it with the template's CSS. Fonts, margins, line height, headers and footers all come from the template, per iA's templates documentation.
Your source file stays plain text. Switch templates and only the rendered output changes, so one draft can print as a serif essay today and a sans-serif report tomorrow.
These aren't the same as reusable starter files such as a README or meeting-notes skeleton. If that's what you're after, our ready-to-use Markdown templates are the place to start. Still choosing an app? Compare the best Markdown editors or our Mac Markdown editor picks.
The Six Built-In iA Writer Templates and How to Switch
iA Writer ships with six templates on Mac, iPad and Windows:
- Modern (Sans) for clean sans-serif output
- Classic (Serif) for traditional prose
- Manuscript (Mono), Manuscript (Duo) and Manuscript (Quattro), three takes on a manuscript look
- GitHub, which copies GitHub's CSS for technical writing
On Mac you switch from the Preview toolbar or from View → Template. On Windows it's the Preview toolbar or View → Templates. On iPad, open Preview, tap the first icon on the left and choose Template.
The GitHub option behaves differently from the rest. iA says it doesn't support the default template settings, such as numbered headings and the footer, because it mirrors GitHub's styling exactly. Pick it for README-style docs, not a novel.
Each platform keeps template settings in its own place. On Mac, title page, header and footer options sit under Settings → Templates → Printing & PDF Export. Paper size is under File → Page Setup. Windows keeps both under File → Settings → Templates. On iPad, use Configure Templates in Preview, with paper size under Settings → Templates.
Which Exports Use the Template: PDF, Print, Word or HTML?
This is the part that's easiest to get wrong. A template shapes Preview, and Preview shapes PDF and formatted print. It doesn't shape a Word file. Here's each format, per iA's export documentation:
| Export | Uses the template? | Where the styling comes from |
|---|---|---|
| Yes | Template styling is applied and locked in | |
| Print (formatted) | Yes | Matches what you see in Preview |
| Print Plain Text | No | Raw text only |
| Word (.docx) | No | Basic formatting converts; you style fonts and colours in Word |
| Markdown (.md) | No | Plain text with your original syntax |
| HTML | Not stated | iA's export page doesn't say whether the template's CSS is included |
The Word row trips people up. Bold, italics, headings, lists, links and quotes map to Word's matching styles, but iA says fonts, sizes and colours belong in Word. Plan to restyle the document there.
For HTML, test an export before you depend on it. iA pitches HTML export at blogs and content management systems, which usually apply their own stylesheet anyway.
Where Can You Download Free iA Writer Templates?
iA offers several extra templates as free downloads on its templates page. Each comes as a ZIP:
- Helvetica, a simple, clean sans-serif look
- Palatino, a classic book face for prose
- Academic MLA, for papers in MLA style (listed on the Mac and iPad pages, not on the Windows page)
- Letter, for correspondence
- Fountain, for screenplays written in the Fountain format
- Chess, for logging chess games
iA also publishes sample bundles in its iA-Writer-Templates repository on GitHub. It holds Example.iatemplate, a GitHub.iatemplate, and a pair of files called Markup.txt and Markup.html that show how common Markdown converts.
Community templates on GitHub make good study material. They're third-party code that iA doesn't publish, so read their CSS and JavaScript before you install one.
How to Install an iA Writer Template on Mac, iPad and Windows
The template file ends in .iatemplate, though downloads usually arrive zipped.
Mac. Double-click the downloaded ZIP to extract it. Then either double-click the .iatemplate file, drag it onto the iA Writer icon in the Dock, or go to Settings → Templates → + → Install Template.
There's a catch on Mac. iA Writer copies the bundle when you install it, so later edits to your original file don't show up. To change an installed copy, right-click it in the Templates settings and choose Show in Finder.
iPad and iPhone. Go to Settings → Templates → Custom Templates → Get More Templates, download one from iA's site and open it in iA Writer. You can also send a bundle by AirDrop or use Copy to iA Writer from Safari, Mail or iCloud Drive. A ZIP must hold only one template.
Windows (version 1.2 or later). Choose File → Install Template and pick the .iatemplate.zip file. If you only have a bare .iatemplate folder, compress it to a ZIP first.
iA's template documentation covers Mac, iOS and Windows only, so don't expect these steps to apply elsewhere.
Inside an .iatemplate Bundle: Info.plist, HTML Pages and style.css
A template is a folder that macOS and iOS treat as a single file, called a bundle. On a Mac, right-click it in Finder to open the bundle and browse its files. Here's the layout from iA's custom templates documentation:
Example.iatemplate/
Contents/
Info.plist
Resources/
document.html
title.html
header.html
footer.html
style.css
The document.html page lays out your text in Preview, print and PDF. The title, header and footer pages only appear in printed documents and PDFs.
Info.plist is an XML property list that ties those files together. Three keys are required: CFBundleName (the name shown in the app), CFBundleIdentifier (a unique reverse-DNS string such as com.example.template) and IATemplateDocumentFile. Here's a trimmed version of iA's example:
<key>CFBundleIdentifier</key>
<string>com.example.template</string>
<key>CFBundleName</key>
<string>Example</string>
<key>IATemplateDocumentFile</key>
<string>document</string>
<key>IATemplateFooterFile</key>
<string>footer</string>
<key>IATemplateFooterHeight</key>
<integer>90</integer>
Note that the file values leave off .html, even though the files themselves need that extension. Header and footer heights are optional numbers capped at 400. A description, author and author URL are recommended. Two optional switches turn off Smart Tables and TeX math processing, which converts math to MathML. Both default to on.
Building a Custom iA Writer Template With data-document and Data Attributes
iA Writer fills your HTML pages through data attributes. It finds elements carrying them and replaces their contents, then fires an ia-writer-change event on each one it updates.
The key attribute is data-document. It receives your whole document as HTML, converted with MultiMarkdown plus a few iA additions. data-page-number and data-page-count are for title pages, headers and footers, while data-title, data-author and data-date work on any page:
<body class="footer">
<p><span data-title></span> - <span data-date="MMMM yyyy"></span></p>
<p><span data-page-number></span> / <span data-page-count></span></p>
</body>
In an exported PDF, that footer shows the file name as the title, a date such as November 2026, and a page counter like 3 / 12. Date patterns follow Unicode's standard on Mac and Microsoft's on Windows, and the output may shift to suit the locale. data-page-number doesn't work on the title page, and data-author comes from the app's settings.
iA Writer also sets classes on the html element, such as night-mode, mac, ios and the content-size-xs to content-size-xxxl range for iOS text sizes. Don't add your own classes there, because they get replaced. Set color and background-color on html so the Mac toolbar matches, and leave vertical margins off the document page.
We prefer copying Example.iatemplate, giving it a new identifier, and editing only style.css at first. Most of the look comes from CSS, and our Markdown CSS guide covers the selectors. On Mac, Shift Command R reloads the template in Preview. On Windows, Ctrl J opens the Chromium inspector. To enable the Web Inspector on Mac, run this in Terminal:
defaults write pro.writer.mac WebKitDeveloperExtras -bool true
To see the kind of HTML your stylesheet will receive, paste a sample into the Markdown to HTML converter below. It isn't iA's MultiMarkdown, so details can differ, but headings, lists, tables and quotes come out as the same basic elements.
Tweaking a Template Without Building One: a Style Block in Your Document
You don't always need a new bundle. iA documents a lighter route: put an HTML style block in the document, and it overrides the selected template's CSS. It suits one-off changes like a bigger font or a new text colour.
<style>
@media print {
body { font-size: 14pt; }
}
</style>
# Chapter One
The rain had stopped by the time we reached the harbour.
The @media print wrapper aims the change at print and PDF output, which is how iA's own example targets PDF font size. Use the Web Inspector to find the classes worth targeting.
The trade-off is that the style block lives in that one file. Other Markdown apps may strip it or show it as raw text. If you reuse the tweak across documents, a custom template is cleaner.
If you draft in our editor instead, know its limit here: it has no export templates or themes, and its PDF export uses one fixed layout.
Quick Answers About iA Writer Templates
iA Writer templates control how your words look on screen, in print and in PDFs, while your Markdown stays untouched. Start with the six built-in options, add iA's free extras when you need a letter or screenplay, and reach for a style block before you build a bundle. When you do build one, copy iA's example. For drafts that don't need any template setup, write and preview them in the editor.