The exporters for the PDF, the Rich Text and the Microsoft Word Format allow exporting of Documents including the text styles (as opposed to the Plain Text Exporter). Since they have most of the formatting options in common, we'll explain them together. The PDF format offers the most options, followed by the Rich Text format and the Word format.

Table of Contents:
  1. Templates
  2. Page Setup
  3. Paragraph Styles
  4. Editing Paragraph Styles
  5. Inline Styles
  6. Editing Inline Styles
  7. Markers
  8. Extras
  9. Notes
  10. Images and Footnotes
  11. Page Numbers (PDF export only)


Since the settings for these export format are quite extensive, all settings can be saved as a template. These templates can then be used for these three export formats. Because the PDF format has the largest range of settings, it is most convenient to create the templates with the PDF Exporter. The settings not used by the Rich Text Exporter and the Word Format Exporter are ignored upon export to those formats.
In order to create a new template, adjust the settings in the export first. Afterwards, select "Save as Template…". In the appearing pop-up menu, enter a name for the new template can be entered.
If the settings of an existing template should be changed, the template has to be selected from the template menu first. After these settings are loaded, modifications can be made. Finally, the "Save as Template…" button can be clicked and the template name of the template just changed has to be entered. The button "Delete Template" does exactly the same as it says.
The pop-up menu always contains two standard templates and the item "Last Setup". If the latter is chosen, the settings from the previous Ulysses session will be loaded.

Page Setup

In the section the page format, the orientation (those settings can be modified by clicking "Page Setup…") as well as the margins can be adjusted. If the settings do not fit to the selected printer, a warning will be displayed and the settings can be readjusted.

Paragraph Styles

The formatting of an exported Document is defined by the paragraph styles. In the column "Style", the used paragraph style can be assigned to the desired formatting. In addition to the paragraph styles given by the Ulysses preferences, there are four other elements a paragraph style can be assigned to: "Normal text", "First line", "Title of Document" and "Subtitle".
In "Normal Text", the appearance of the body text can be modified. This style also is the base format for the other settings. It is used for every paragraph style with the setting "Like normal text".
Using "First line", a different style can be assigned for the first line of a Document. Thus, the first line (without special markers) can be used as a heading.
Similarly, the title can be assigned its own style using "Title of Document", which will then be inserted at the beginning of every Document.
The last option, "Subtitle", can be used if the Document does not start with a heading. Furthermore, if there is a heading at the beginning, a subtitle is inserted right after the heading in the assigned style. A subtitle can consist of the Document title, the status, the label and the timestamp. These elements can be selected by ticking the checkboxes next to them.

Editing Paragraph Styles

By clicking on "Edit…" in the context menu of a style, the available paragraphs styles can be edited, new paragraph styles can be added, or existing ones can be deleted.
The available styles are listed on the left-hand side of the Paragraph Style Editor. Styles printed in bold are currently in use and can consequently not be deleted. The order of this list is the same as the order of the styles in the context menu. This order can be changed by dragging the entries to the desired position. By clicking the "+" or the "-" button, a new style can be added or an existing one deleted, respectively. If the Duplicate button is clicked, a copy of the selected paragraph style will be created. By clicking the name of a paragraph style, the style will be selected and its properties will be displayed in the right-hand side of the editor. The following properties of the selected paragraph style can be modified: font, alignment (left, right, centered, natural or justified), line spacing, indention (at the start and the end), spacing between paragraphs, classification in the hierarchy (the numeration of the headings depends on the hierarchy), tabstops (position and its type).
After clicking "Save", the changes will be applied to the current export settings; however, they will not be applied to a (potentially) selected template. To apply the changed styles to the templates, they will have to be saved as template as well (see section "Templates"). "Cancel" will discard all changes.

Inline Styles

In the column "Style", a text formatting or one of the actions "Delete tags", "Delete text" or "Don't touch" can be assigned to a text style. "Delete Tags" will remove the tags and will leave the formatting of the text as it is. "Delete Text" will delete every tagged text passage including the tags. The last option, "Don't touch", ignores the tags and the text in between the tags. The inline styles can be edited, added or delete just like the paragraph styles.

Editing Inline styles

To open the Inline Style Editor, "Edit…" has to be selected from the context menu of an inline style, which are shown in the column "Style". Most of the settings in this editor are very similar to the Paragraph Style Editor (see "Editing Paragraph styles" for details). The only difference between these two editors lies in the properties. Upon selecting an inline style from the list, the right-hand side of the editor will display the font traits, various underlining styles and the foreground (i.e., font) and background colors.
The "Save" and "Cancel" buttons work exactly the same as in the Paragraph Style Editor.


Markers can be assigned to the same text formattings or actions like the text styles, except the action "Delete Tags", since markers are not tagged. Instead, characters can be inserted at the start and the end of the marked passages using the action "Enclose in". The inserted characters are arbitrary, the start and the end characters can even differ. If one wants to do so, the desired characters have to be entered after each other (start first, end second) and separated by " - " (space, dash, space),. For instance, if "S" should be at the start of a marker and "E" at its end, "S - E" would have to be entered.


In the section "Extras", various settings for the export can be specified. "Delete empty lines" removes empty lines from the Documents.
"No hanging indent for first line in copy text" removes indents after headings and empty lines, if indention in body text is enabled.
"Tabs at beginning of line start are x blank spaces" converts tabstops at the start of a line to x spaces.
"--- is page break" can be used to assign characters, which are converted to page breaks in the exported Documents.



The Notes for the Documents can be added at three different positions in the Document: at the start or the end of the Document or after the heading. The formatting of the Notes can either be left intact or be assigned to a Paragraph Style, which can be selected from the pop-up menu below (see screenshot).


Inserting Images and Footnotes

Additionally, the PDF and the RTF exporter allow inserting images and footnotes into exported Documents. The third Screencast Web Resource on Exporting also explains these features in detail and goes through a couple of examples.

Since the Editor can only contain text, images need to be inserted into Notes in the Notepad. To insert an image into the Notepad, simply drag'n'drop or copy and paste it into an empty Note.
Image in Note
To link to the image in the text, it needs an identifier. Simply type an identifier in front of the image and separate them by a dash, i.e., "identifier-image". Additionally, the identifier and the image must be enclosed in start and stop tags. By default, these tags are "[[" and "]]", respectively (you can choose any other tags, you just have to remember them later on). Thus, the content of the Note is as follows: "[[identifier-image]]" (see screenshot).
In order to insert this image in the exported Documents, the identifier must now be entered in the text (enclosed in the tags) at the position where the image should appear, i.e., "[[identifier]]".

Footnotes can be inserted in exported Documents in much the same way. Enter the footnote in a Note, put an identifier and a dash in front of it ("identifier-footnote"). Enclose the footnote in start and end tags, which are "{{" and "}}" by default: "{{identifier-footnote}}". Thus, an example footnote could look like this: "{{FN1-This is the footnote text.}}". The identifier (e.g., "FN1") now only needs to be entered in the text at the desired position, enclosed in start and end tags. Additionally, footnotes can also be entered in the text right away. For this, enter the start tag, a dash, the footnote, and the end tag, e.g., "{{-This is the footnote text}}".

Connections to notes

To enable exporting images and footnotes in the exporter, enable the checkbox "Connections to notes". In the table below, the start and end tags for images and footnotes can be set (if you used the default tags, you don't need to change anything there). Finally, the connection needs to be set to "On" in the "Status" column. Here the start and stop tags can also be customized. The key for the connections can be any character string (incl. numbers). It has to be unique in one Document; however, the key can be used again in other Documents.
Footnotes can either be numbered continuously or can be restarted on each page. This setting can be adjusted in the pop up menu below the table.

Page Numbers (PDF export only)

The PDF exporter can number the pages in the exported Documents. The page number (or the page number including the total page number) can be inserted at the top or the bottom of a page with a left-, right-, or center-alignment.

< Plain Text
LaTeX >