Release Notes

We’re constantly working to improve iA Writer. Here’s a breakdown on what we’ve added to each release.


Deep Typography Refresh

  • New typeface in three flavors
  • Mono: Single character width, the classic
  • Duo: Two widths, freeing M and W
  • Quattro: Four widths, for a cleaner text image
  • Over 1,000 optical variations seamlessly adapt to provide the best writing experience in any environment
  • 12 text sizes in Editor and Preview
  • Many Chinese, Japanese, and Korean typography improvements, including emphasis dots
  • Bold, italic, and strikethrough commands are much more reliable and work inside words
  • High quality math equation typesetting in Preview using KaTeX

Library Locations

  • Now support Desktop & Documents in iCloud
  • Can be added from anywhere in iCloud Drive

Fully-Featured Export to Microsoft Word

  • Rebuilt from the ground up
  • Compatible with Microsoft Word 2007 or newer, Apple Pages, and Google Docs
  • Supports local images, footnotes, citations, page breaks, tables, math, headings, unordered lists, ordered lists, task lists, definition lists, block quotes, bold, italic, CJK emphasis, strikethrough, superscript, subscript, links, horizontal rules, code

Other Improvements

  • Added visible filename when switching between tabs with hidden title bar
  • Copy URL command to open files from menu in Library
  • Command-Click links in Editor
  • Use – to exclude words from searches: -microsoft word
  • Inline code command
  • Typing suggestions can be enabled in Touch Bar
  • Korean and Russian localizations
  • Added help articles
  • Better hashtag detection


Hashtags (like Instagram and Twitter)

  • Write #tags to group documents
  • Use in Quick Search and Smart Folders rules
  • Hashtags are shown in Organizer and Go menu
  • Hide hashtags from Preview and formatted exports in Templates preferences

Smart Folders

  • Filter your documents using a variety of rules including text searches, file extensions, hashtags, parent and ancestor paths, absolute and relative dates
  • Use a custom sort order
  • Automatically sync across your devices
  • Get automatic keyboard shortcuts in Go menu

URL Commands

  • Updated commands to create and open documents
  • Added authenticated x-callback-url commands to read and write files
  • Manage URL commands in General preferences

Dark Appearance

  • Renamed night mode to dark appearance to conform with a future update of macOS
  • System light and dark appearance state is matched by default with a future update of macOS

Free Candy

  • Added navigation controls to Library in full screen windows
  • Assign custom display names to Library Locations in Organizer
  • Rename Favorites in Organizer
  • Duplicate items in Library
  • Go → Enclosing Folder menu
  • Fixed an issue where images couldn’t be dragged to Editor from Safari, Photos, and other apps
  • Added STIX 2.0 fonts for math expressions in Preview
  • HTML tags are dimmed in Editor
  • Hide Favorites, Smart Folders, or Hashtags sections from Organizer and Go menu in Library preferences


  • Improved library performance and reduced memory usage
  • SVG images are always displayed as pictures when used as content blocks
  • Code blocks are excluded from text stats


  • Fixed an issue with autosaves failing in some contexts
  • Fixed crashes


  • Defined CSS files as to be processed as code
  • Fixed an issue where preview scroll bar could be invisible with some templates
  • Fixed Strikethough menu item functionality
  • Switched to system popup menu indicators
  • Improved performance and stability


  • Added Touch Bar support in Editor
  • Added CSV delimiter detection
  • Added caption support for source code content blocks
  • Enabled SVG image content blocks
  • Set up Markdown export to use default extension
  • Switched to fixed width numbers in tables in standard templates


Embed Local Images

  • Include images from Library in your documents (.png, .gif, .jpg)
  • Images are uploaded to Medium and WordPress when sharing a draft

Embed Tables

  • Include comma separated value files as tables in your documents (.csv)
  • Create advanced tables using MultiMarkdown

Embed other text files

  • Build a manuscript from several chapters
  • Embedded source code files are added as code blocks
  • Nest text files into each other

Note: Embedding only works for files in the same folder (or subfolders) as the master file. You can’t embed files in a parallel or higher directory.

Other Improvements

  • Modified Preview and Library pane behavior so both can be shown
  • Swipes on the left toggle Library
  • Swipes on the right toggle Preview
  • Added toggle button for Focus Mode in title bar
  • Focus Mode now dismisses Preview and Library panes
  • UI improvements to Library
  • Added file info popover in Library
  • Switched right-click in Library menu item from “New Folder with Selection” to “New Folder” (hold option for “New Folder with Selection”)
  • Added Project Archive export for sharing all embedded files together (.zip)
  • Changed Chinese font in editor to Ping Fang
  • Improved external file change handling
  • Caret position is now restored when returning from full-width Preview
  • Performance optimizations and improvements


Added WordPress Site Picker

WordPress users with more than one site can now choose where to share.

Choose Sort Order in Library

  • Newest or Oldest on Top for Date Modified
  • A–Z or Z-A for file Name and Kind
  • Access in View > Sort Files By, Right Click in Library > Sort By


Custom Templates

  • Preview, create PDFs, and print documents in your own style
  • Templates are web pages. Use HTML, CSS, and JavaScript to lay out your documents
  • Add templates in Preferences
  • Download more templates from iA Writer’s Web Site
  • Learn more about templates in Help

Page Breaks

  • Add page breaks to printed documents and PDFs
  • Insert with +++ on an empty line
  • Format > Add Page Break

Title Pages

  • Print and export PDFs with a title page
  • Default templates show document name and author on the title page
  • Set the author in Preferences

Other Improvements

  • Added option to change default file extension in Preferences
  • Fixed an issue where attempts to change file file extension via title bar popover could fail
  • Fixed an issue where tables were not inserted in new documents
  • Updated to MultiMarkdown 5.3
  • Adjusted drag and drop in Library to follow system conventions
    — Drag to move
    — Drag while holding Option to copy


Share to WordPress

  • Add your account in Preferences
  • Create drafts on your WordPress site with File > Share > New Draft on WordPress

Other Improvements

  • Added a preference for default document action: New or New in Library
  • Added a toggle for last used Syntax Control
  • Excluded links from reading time and text statistics
  • Improved automatic name generation
  • Updated to MultiMarkdown 5.2


Focus Mode for Paragraphs

  • Focus Mode can be expanded to the bounds of full paragraphs
  • Accessed via Preferences > Editor > Focus Mode

Your Table is Ready

  • Click the Table button in the toolbar and set the desired number of rows and columns
  • The required Markdown for the table is created for you instantly

Other Improvements and Fixes

  • Fixed an issue where documents did not refresh when changed by some text editors and third-party sync services
  • Added an option to hide text snippets in Library
  • Stopped showing non-text files in iCloud Library
  • Improved H6 alignment at the beginning of a page
  • Fixed an issue which prevented Smart Delete from working
  • Fixed an issue where toolbar could remain visible when typing
  • Smart Quotes no longer convert primes to curly quotes in code blocks


Support for MultiMarkdown’s Table of Contents

  • Add {{TОC}} to your documents to have a table of contents generated in Preview
  • TOC button in the Format Toolbar adds this for you
  • An entry is made for each heading in the document
  • Click a TOC entry to jump to that section of the document

Added File → Open Quickly ⇧⌘O

  • Blazing-fast, it searches through your Library
  • Use arrow keys to navigate results
  • return to open document in a new window
  • ⇧return to open document in the current window
  • ⌘return to show in Finder

Search supports advanced syntax

  • Search for specific terms by quoting "search query"
  • Match the first word of name or text using ^word
  • Use set operators AND, OR, and NOT
  • Search for names or texts that contain a specific word with name:notes or text:"book"
  • See the full description and examples in Help

Changed default shortcuts for structure actions

  • Old shortcuts are still available for compatibility with other text editors
  • Shift Right tab
  • Shift Left ⇧tab
  • Move Line Down ⌘⌥↓
  • Move Line Up ⌘⌥↑

Improved URL scheme support

  • iawriter://new and iawriter://new-in-library
  • Both support an optional text parameter iawriter://new?text=

Other Improvements

  • Search results are now sorted by relevancy
  • Added commands to insert a table of contents tag into the document
  • Improved code block detection
  • Added “Replace All” to Find bar
  • Added “New” action to Dock
  • Improved heading appearance in Japanese


  • Set up new windows to use last visible state of library and preview
  • Fixed a delay when opening a new window
  • Improved text editing performance
  • Improved stability



  • - [x] Click tasks to mark as completed
  • Improved search in Japanese
  • Added text actions in “Format” → “Structure”
    • Shift Left ⌘[
    • Shift Right ⌘]
    • Move Line Up ⌥⌘[
    • Move Line Down ⌥⌘]
  • Improved transition to full size preview
  • Improved automatic name generation
  • Added text size to Editor preferences.
  • Preview toolbar uses matching colors
  • Added “Show in Library” action in Search
  • Added options to print header and footer separately
  • Added proper title capitalization in “Edit” > “Transformations”
  • Added progress indicator for background export and sharing operations
  • Upgraded to MultiMarkdown 5.0.1
  • Prevented spell checking in code
  • Return preserves the amount of leading whitespace


  • Fixed an issue where search was not working for non-Latin scripts
  • Improved performance and stability
  • Various smaller bug fixes



  • Any folder can be added as a location in the Library
  • Export drafts to
  • Localization for Japanese and German
  • Templates:
    • Choose indentation or vertical spacing for paragraphs
    • Choose centered or left-justified headings
  • Header and footer are optional on print/PDF export
  • Preferences dialog (⌘,)
  • New windows use last size
  • Preview uses last width
  • Default extension uses last extension change


  • Fixed crashes


Document Library

  • Swipe left or Command+E to show/hide
  • ViewSort by to arrange documents in browser
  • Dropbox Sync (link through storage button at bottom-left)
  • Click file/folder names to rename
  • Swipe left to go back a folder level (or use title menu)
  • Move documents with click and drag
  • Show/Hide file extensions

The Editor

  • Typewriter Mode (⌘T)
  • Toolbar can switch between Format, Syntax, and Stats
  • Smart Paste eliminates doubled list markers when pasting

Integrated Preview

  • Swipe right or Command+R to show/hide
  • Multiple typographical options for preview, PDF export, and print
  • Synchronous Preview scrolling

iA Writer Support

Get iA Writer

Download iA Writer for Windows, Mac, iOS, and Android

iA Writer Newsletter

Subscribe to get updates, outlooks and tips on upcoming iA Writer releases. Expect no more than one mail per month.