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 strong, you can do so with single underscores or double asterisks, respectively, or use the shortcuts
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 in the Edit menu (“Edit › 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
That’s one small step for a man, one giant leap for mankind.
And with a divider you can, well, divide. Text sections, for example.
The Editing Phase
The next part of the markup is helpful for editing purposes: It lets 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.
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 double-click 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 (or use the
⌘K shortcut). This will open a popover 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. 1 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?
Ulysses will, per default, display small image previews in the editor. You can tweak the size of this preview in Ulysses’ “General” preferences, or turn it off completely: Images will then be indicated by a little bubble dubbed
- Type (fn), put text into the popover, hit
⌘↩︎, continue. ↩