You are on page 1of 10

iA Writer Support

This is the support section of iA Writer, a writing app by Information
Architects Inc. It covers general questions and dives into specifics about
the latest versions of our iOS, Mac, and, Android apps. If you have
questions about previous versions, please consult our support archive.

Our apps use Markdown formatting. This lets you apply basic formatting
by adding a few punctuation characters. You can also use the formatting
buttons in the bottom bar of your text window on OS X or the formatting
keys in the Keyboard Bar of iA Writer for iOS.

1.4.1 Basics

If you are not familiar with Markdown, it might look a little scary at first.
Once you get the basics, you will quickly love it as it allows you to format
your text without taking your hands off the keyboard. iA Writer’s Auto-
Markdown will give you instant feedback if you got the formatting right or
not.

Headings

You can use up to up to six levels by writing # at the start of a line; the
number of hashtags defines the hierarchy of the heading.

# First level heading
## Second level heading
### Third level heading

Emphasis and Importance

Emphasis (“italics”) and important (“bold”) are written by putting * or _
around the text you want to see in a different format.

Emphasis: *example* or _example_ (⌘I)
Importance: **example** or __example__ (⌘B)

Ordered list item 2. Emphasis + Importance ***example*** or ___example___ Numbered lists Type 1. hyphen (-). Create a bulleted list by using an asterisk (*). or plus sign (+). followed by a space. * Bulleted list item * Bulleted list item * Bulleted list item Task lists Type -[ ] or 1.or + then a space. . Ordered list item 3.[ ] then a space. Adding an x between the square brackets will tick off a task list item in the Preview. then a space.[ ] Unfinished task list item . and combine them: * First level ** Second level 1. Any number (followed by a full stop and space) can be used and the list items will be ordered from 1 when exported.[x] Finished task list item Nesting lists You can nest lists several levels deep. . First level . Ordered list item Bulleted lists Type *. iA Writer for Mac and iOS also support clicking or tapping the list item marker to toggle it. 1.

Then. * First level * Second level 1. and Auto Markdown is optimized for non-tab nested lists. and the URL: . First level 1. iA Writer for iOS includes keys to indent and outdent list items.1.4. Second level * First level unordered list item * 1. on a line by itself add the reference with a colon.1. followed immediately by the URL in parentheses: [text to link](http://example. space. Second level Blockquotes Type > plus a space (just like email): > A quoted paragraph >> A quoted paragraph inside a quotation 1. Second level ordered list item Using tab indents for nesting is also possible when using a physical keyboard. but currently there is no Tab key in the iOS on-screen keyboard.com/) You can also use reference links. They can be found by tapping and holding the list key in the keyboard bar.2 Advanced Links Create a link by surrounding the link text in square brackets. Add the reference in square brackets after the text to link.

you can use Fenced code blocks.com/image. In addition. ``` This is a fenced code block ``` Footnotes Add a footnote in square brackets preceded by a caret. Then add the footnote content like a reference link.. for example: . or add a code block by adding at least four spaces to the start of a line: This is a code block In iA Writer. which begin and end with triple backticks. *.jpg) Code You can mark up code in-line using backticks (`code`). +. but the image is not embedded. as long as the text doesn’t start with list.docx. >). -. #. it’s also possible to start a code block with a tab.[text to link][ref] … [ref]: http://example. On export to RTF or .com/ Images Currently only web-accessible image URLs are supported. Note that inline formatting (like _underscores_) is ignored in code. currently the image’s alt text is added. and don’t need indenting. You can add images via the following syntax: ![](http://example. header or blockquote syntax characters (1.

use vertical bar characters to denote cells.|:---. The TOC will become visible and clickable in preview. Row| left | nicely | right | |3. Tables To make a table. That being said. Just add {{TOC}} wherever you want the table of content to appear and iA Writer generates it from the Headlines you use in your text.Some text with a footnote[^1]. On Mac you can add it via the toolbar or the Format Menu. Table of Contents Generating a table of content is as easy as it gets. Row left nicely right . separate with a row of cells with hyphens. This is a mess. Row| aligned | centered | aligned | Let’s be real. You can also add an inline footnote in the following manner: Some text with a footnote[^This is the footnote itself. Start with column headers. For example: |Header |Column 1 | Column 2 | Column 3 | |:--.].|:----:| ----:| |1. but they are the weak point of Markdown. Row| is | is | is | |2. There is a custom key for it on iOS. then add further rows of cells. … [^1]: The linked footnote appears at the end of the document. Markdown tables look more reasonable than HTML-Tables. they still translate nicely when rendered: Header Column 1 Column 2 Column 3 1. Row is is is 2.

This is also included as a key in iA Writer for iOS’s keyboard bar. optionally separated with spaces. For example: * * * . hyphens (-). please use one or two returns to separate paragraphs. add three or more asterisks (*). To do so. please ensure Smart Dashes are turned off in Edit → Substitutions. or underscores (_) on a line by themselves. iA Writer for Mac includes a button in the Toolbar which will automatically generate the cells for a table. Instead. Horizontal rules You can add a thematic break which will be represented by a dividing line (<hr>) when exported to HTML. 3. Row aligned centered aligned There is a trick though you can use when writing Markdown tables with a monospaced font. Separating paragraphs A line starting with a tab indicates a block of code. You can feign the correct column width by adding space characters to align the table: Note: If you find your table does not render correctly in Preview. Because of this it is currently not possible to use a return-plus-tab to indicate a new paragraph in Writer.

4. . In addition. This means \* gives *.3 MultiMarkdown Writer apps currently use MultiMarkdown. Nested list items can use additional list syntax (** list item). 1.or ------------- “Escaping” formatting characters If you want to type a formatting character and have Writer treat it as text not formatting. These include: Only a single return is needed between paragraphs. Metadata Use MultiMarkdown’s metadata to store important information about your documents. you can change these syntax modifications from on to off in the Preferences. hidden from Preview. Writer’s default syntax includes some minor changes. turn on “Process Metadata” in Preferences. Escaping isn’t needed in code blocks. To start using metadata in your documents. \_ gives _ etc. In iA Writer 3. You can use MultiMarkdown metadata to build correspondence Templates. in addition to “default” tab indentation ( * list item). type a backslash first \.

If you open Preview and compare the raw text and the rendered Markdown you will see this: . followed by an empty line. Write: Animal: Cat Thing: Mat You can use the metadata in the text by putting it in brackets adding a % sign.You can do this with two easy steps. First you define your Metadata at the very top of your document. The whole document should now look like this: Animal: Cat Thing: Mat The [%Animal] sat on the [%Thing]. Write: The [%Animal] sat on the [%Thing]. Let’s write “The Cat sat on the Mat” with Metadata.

4 Preview Writer apps use Markdown formatting.4. so you can format your text just by typing.1. and it’s also subtly formatted on-screen using Auto Markdown: Writer also provides a formatted preview of your document: iA Writer for Mac: choose View → Show Preview (⌘R) or swipe to the left iA Writer for iPad and iPhone: tap Preview or swipe to the left . It’s familiar.

RTF.docx). or File → Print Plain Text → PDF . and PDF via File → Export. Microsoft Word 2007 (.4.5 Exporting iA Writer 3 supports exporting as HTML. you can copy formatted text from Writer’s Preview to paste into other programs. You can also export as PDF on Mac via File → Print → PDF.1. Finally. .