First Steps
The adoc Studio Interface
Let’s first take a closer look at the interface in adoc Studio. It consists of three areas:
-
Sidebar: Here you can see all your documents, chapters, folders, and media in the current project.
-
Editor: This is where you write your document.
-
Preview: Here you can see the output of your document in PDF or HTML.
The preview and the editor are separate from each other. This has the advantage that you can make changes to the content or design independently of each other.
Writing in AsciiDoc
AsciiDoc is a simple markup language. This means you mark up your texts with individual characters to describe them more precisely. These markups determine how the text is displayed in the preview and in the output.
For example, an = stands for the document title. Each additional = places the heading one hierarchy level lower.
| In adoc Studio, headings are automatically displayed in the sidebar (in the Section Navigator) as an outline. Clicking on them jumps directly to the corresponding place in the document. |
Headings and Document Structure
AsciiDoc supports up to six heading levels:
| Syntax | Meaning | Usage |
|---|---|---|
|
|
Document title |
Only once per document, at the very top |
|
|
Chapter (Level 1) |
Main sections of your document |
|
|
Subchapter (Level 2) |
Subdivisions within a chapter |
|
|
Section (Level 3) |
Further subdivisions |
|
|
Subsection (Level 4) |
Finer structuring |
|
|
Deepest level (Level 5) |
Rarely used |
There must always be a space between the = and the heading text. |
In the upcoming chapters, we will dive deeper into AsciiDoc. In the chapter Formatting, you will learn how to display text in bold, italic, or underlined.