To mark up a heading, start a line with one or more hashes. The number of hashes corresponds to the heading’s hierarchical level. That is, type ## for a second level heading, ### for a third level heading, and so on.

If you want to emphasize a word or phrase, or mark it up as important, you can do so with single underscores, or double asterisks, respectively.

Ordered and unordered lists can be created by simply typing dashes or numbers at the beginning of a line. And they will automatically continue, if “Smart Lists” are enabled (Editor Settings › Spelling & Substitutions):

  • This is
  • An example
  • Of an unordered list

If you want to create block quotes, e.g. to provide a motto, or to highlight famous quotes from even more famous people, simply start a line with a > character:

That’s one small step for a man, one giant leap for mankind.
(Neil Armstrong)

And with a divider you can, well, divide. Text sections, for example.


The Editing Phase

The following definitions are helpful for editing purposes: They let you highlight text, as you would with a classic highlighter, or mark text for deletion.

While these definitions serve important purposes on screen, their true power will only become apparent during export. As an example, when creating a PDF with the “Swiss Knife” style applied, comments and deletions will be absent from the output file, since this is a style meant to deliver a finalized PDF. But when using the “Rough Cut” style, comments will be included, since that style is meant to be used for printed drafts.

Text Objects

Headings, emphasis and comments may be all that’s needed for general prose, but some texts require images or footnotes, and online publications may require the insertion of links.

Enter what we call text objects – “these colored bubbles” you have already come across in this introduction. They are a bit different from standard text markup, as you can tap a text object and add additional content (a photo, a URL). Their creation, however, is just as simple:

To add a link, type square brackets around a word or phrase. This will open a dedicated view which lets you add, well, a link to a webpage. If you type curly brackets around a phrase instead, you will create an annotation, which is basically a note added to that phrase.

You can also add images or footnotes, again by typing only a few characters.  Enter (img) and you’ll be asked to provide either an image file or a URL. Of course, you can also just drag an image into your text, but where’s the fun in that?

Image Preview

Per default, display small image previews in the editor. You can tweak the size of this preview in the editor settings under “Layout”, or turn it off completely: Images will then be indicated by a little bubble dubbed IMG.