1.1. Abschnittsformatierung

Während der erste Absatz eines Abschnitts ganz links ausgerichtet ist, werden die folgenden Absätze mit einem Einzug links gesetzt. Dies ist auch dann der Fall, wenn die Absätze sehr kurz sind.

So wie hier.

Oder hier.

Was dann etwas unerwartet sein kann. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

1.2. Abschnittsnummerierung

Abschnitte werden automatisch nummeriert wenn :sectnums: aktiviert ist. Die Abschnittsnummerierung kann mit :!sectnums: im Dokument laufend deaktiviert und wieder aktiviert werden, um z.B. gewisse Abschnitte nicht nummeriert zu lassen (siehe Beispiel unter Ziffer 3. Listen).

1.3. Inhaltsverzeichnis

Das Inhaltsverzeichnis wird automatisch generiert wenn :toc: aktiviert ist. Die tiefe des Inhaltsverzeichnisses kann mit :toclevels: im Dokument laufend festgelegt werden, um z.B. nur die obersten Abschnitte im Inhaltsverzeichnis zu zeigen (in diesem Dokument werden nur die obersten Abschnitte im Inhaltsverzeichnis angezeigt).

2.1. Inline Formatierung

2.2. Zahlen

Ungeordnete Listen

Nummerierte Listen

Mixed Content Lists

Checkliste

4.1. Links

4.2. Querverweise im Dokument

Es gibt verschiedene Möglichkeiten, den Text des Querverweises zu definieren:

Falls im Dokumentkopf die automatische Generierung von Abschnitts-IDs aktiviert ist (:sectids:), können auch diese Abschnitts-Ids für Querverweise verwendet werden: #_inline_formatierung.

Bei internen Querverweisen wird beim Maus-Hover standardmässig der Inhalt des referenzierten Abschnitt in einem Vorschaufenster dargestellt. Dabei funktionieren natürlich auch Querverweise auf Abschnitte die erst später im Dokument definiert werden.

4.3. Fussnoten

Verschiedene Varianten von Fussnoten: Standardfall mit kurzen Fussnoten², direkt im Text³ definiert.

Hier kommt ein Verweis auf eine seeeeeehr lange Fussnote⁴, die weiter oben im Text mit Blockinhalt definiert wurde.

Eine benannte Fussnote direkt im Satz liefert weitere Details zur Beschaffung⁵. Später im Text kann derselbe Hinweis⁵ nochmals zitiert werden, ohne den Inhalt zu wiederholen. Und falls die Erinnerung ein drittes Mal nötig ist, funktioniert auch das problemlos⁵.

5.1. Standard (schmales Bild)

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

5.2. Standard (breites Bild)

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

5.3. Volle Inhaltsbreite

Abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc abc Mit width-content kann ein Bild⁶ auf die Breite des Inhalts gestreckt werden. Der Inhalt entspricht dem Text sowie linke und rechte Randbemerkungen wenn diese vorhanden sind.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

5.4. Volle Seitenbreite

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

5.5. Halbe Seitenbreite (width-semi)

Mit width-semi kann ein Bild auf die halbe Breite der linken Randbemerkung bis zur halben Breite der rechten Randbemerkung gestreckt werden. Dies ist eine Zwischenstufe zwischen normaler Breite und width-content.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

5.6. Bild mit Dimensionierung

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

5.7. SVG

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

5.8. Float Left / Right

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.

6.1. Einfaches iFrame (width-content)

Margin note Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

6.2. iFrame mit width-semi

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

6.3. iFrame mit Titel (width-full)

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

7.1. Einfache Blockquote

The only way to do great work is to love what you do.

7.2. Blockquotes mit formatiertem Inhalt

Auch Randbemerkungen funktionieren innerhalb von Blockquotes! What’s new?

I’ve got Markdown in my AsciiDoc!

Like what?

• Blockquotes

• Headings

• Fenced code blocks

Is there more?

Yep. AsciiDoc and Markdown share a lot of common syntax already.

7.3. Geschachtelte Blockquotes

Allerdings funktionieren damit Randbemerkungen nicht. Blockquotes können auch geschachtelt werden mit der Markdown >-Schreibweise.

With tenure, Suzie’d have all the more leisure for yachting, but her publications are no good. Shaw, those twelve beige hooks are joined if I patch a young, gooey mouth. Are those shy Eurasian footwear, cowboy chaps, or jolly earthmoving headgear? The beige hue on the waters of the loch impressed all, including the French queen, before she heard that symphony again, just as young Arthur wanted.

With tenure, Suzie’d have all the more leisure for yachting, but her publications are no good. Shaw, those twelve beige hooks are joined if I patch a young, gooey mouth. Are those shy Eurasian footwear, cowboy chaps, or jolly earthmoving headgear? The beige hue on the waters of the loch impressed all, including the French queen, before she heard that symphony again, just as young Arthur wanted.

With tenure, Suzie’d have all the more leisure for yachting, but her publications are no good. Shaw, those twelve beige hooks are joined if I patch a young, gooey mouth. Are those shy Eurasian footwear, cowboy chaps, or jolly earthmoving headgear? The beige hue on the waters of the loch impressed all, including the French queen, before she heard that symphony again, just as young Arthur wanted.

With tenure, Suzie’d have all the more leisure for yachting, but her publications are no good. Shaw, those twelve beige hooks are joined if I patch a young, gooey mouth. Are those shy Eurasian footwear, cowboy chaps, or jolly earthmoving headgear? The beige hue on the waters of the loch impressed all, including the French queen, before she heard that symphony again, just as young Arthur wanted.

With tenure, Suzie’d have all the more leisure for yachting, but her publications are no good. Shaw, those twelve beige hooks are joined if I patch a young, gooey mouth. Are those shy Eurasian footwear, cowboy chaps, or jolly earthmoving headgear? The beige hue on the waters of the loch impressed all, including the French queen, before she heard that symphony again, just as young Arthur wanted.

With tenure, Suzie’d have all the more leisure for yachting, but her publications are no good. Shaw, those twelve beige hooks are joined if I patch a young, gooey mouth. Are those shy Eurasian footwear, cowboy chaps, or jolly earthmoving headgear? The beige hue on the waters of the loch impressed all, including the French queen, before she heard that symphony again, just as young Arthur wanted.

7.4. "Floated" Blockquotes

Blockquotes können im Fliesstext "floated" werden, d.h. innerhalb des Textes links oder rechts positioniert werden.

Waltz, nymph, for quick jigs vex Bud. Sphinx of black quartz, judge my vow. Pack my box with five dozen liquor jugs. Glib jocks quiz nymph to vex dwarf. Jackdaws love my big sphinx of quartz. The five boxing wizards jump quickly. How vexingly quick daft zebras jump! Quick zephyrs blow, vexing daft Jim. Two driven jocks help fax my big quiz. The jay, pig, fox, zebra and my wolves quack! Sympathizing would fix Quacker objectives. A wizard’s job is to vex chumps quickly in fog. Watch Jeopardy!, Alex Trebek’s fun TV quiz game.

By Jove, my quick study of lexicography won a prize! Waxy and quivering, jocks fumble the pizza. Fetching killjoy Mavis Wax was probed on the quay. “Yo, never mix Zoloft with Quik”, gabs Doc Jasper. One zany quaff is vodka mixed with grape juice and blood. Zitty Vicki smugly quipped in her journal, “Fay waxes her butt.” Hot Wendy gave me quasi-Kreutzfeld-Jacob pox. Jack’s pervy moxie quashed Bob’s new Liszt fugue. I backed Zevy’s qualms over Janet’s wig of phlox. Tipsy Bangkok panjandrums fix elections with quivering zeal.

7.5. Epigraphen

Einfacher Epigraph durch Anführungszeichen und Attribution:

Expliziter Epigraph mit einfacher Attribution im Titel:

Expliziter Epigraph mit Attribution via eigener Abschnitt, kann komplexe Formatierungen enthalten:

Auch Epigraphen können im Fliesstext "floated" werden, d.h. innerhalb des Textes links oder rechts positioniert werden.

Waltz, nymph, for quick jigs vex Bud. Sphinx of black quartz, judge my vow. Pack my box with five dozen liquor jugs. Glib jocks quiz nymph to vex dwarf. Jackdaws love my big sphinx of quartz. The five boxing wizards jump quickly. How vexingly quick daft zebras jump! Quick zephyrs blow, vexing daft Jim. Two driven jocks help fax my big quiz. The jay, pig, fox, zebra and my wolves quack! Sympathizing would fix Quacker objectives. A wizard’s job is to vex chumps quickly in fog. Watch Jeopardy!, Alex Trebek’s fun TV quiz game.

By Jove, my quick study of lexicography won a prize! Waxy and quivering, jocks fumble the pizza. Fetching killjoy Mavis Wax was probed on the quay. “Yo, never mix Zoloft with Quik”, gabs Doc Jasper. One zany quaff is vodka mixed with grape juice and blood. Zitty Vicki smugly quipped in her journal, “Fay waxes her butt.” Hot Wendy gave me quasi-Kreutzfeld-Jacob pox. Jack’s pervy moxie quashed Bob’s new Liszt fugue. I backed Zevy’s qualms over Janet’s wig of phlox. Tipsy Bangkok panjandrums fix elections with quivering zeal.

7.6. Verse

Auch Verse können im Fliesstext "floated" werden, d.h. innerhalb des Textes links oder rechts positioniert werden.

Waltz, nymph, for quick jigs vex Bud. Sphinx of black quartz, judge my vow. Pack my box with five dozen liquor jugs. Glib jocks quiz nymph to vex dwarf. Jackdaws love my big sphinx of quartz. The five boxing wizards jump quickly. How vexingly quick daft zebras jump! Quick zephyrs blow, vexing daft Jim. Two driven jocks help fax my big quiz. The jay, pig, fox, zebra and my wolves quack! Sympathizing would fix Quacker objectives. A wizard’s job is to vex chumps quickly in fog. Watch Jeopardy!, Alex Trebek’s fun TV quiz game.

By Jove, my quick study of lexicography won a prize! Waxy and quivering, jocks fumble the pizza. Fetching killjoy Mavis Wax was probed on the quay. “Yo, never mix Zoloft with Quik”, gabs Doc Jasper. One zany quaff is vodka mixed with grape juice and blood. Zitty Vicki smugly quipped in her journal, “Fay waxes her butt.” Hot Wendy gave me quasi-Kreutzfeld-Jacob pox. Jack’s pervy moxie quashed Bob’s new Liszt fugue. I backed Zevy’s qualms over Janet’s wig of phlox. Tipsy Bangkok panjandrums fix elections with quivering zeal.

8.1. Unterstützte Features

This is literal text
with preserved whitespace

Literal text

Left literal

Center literal

Right literal

9.1. Einfache eingeklappte Abschnitte

9.3. Einklappbarer Abschnitt mit Code

Error: Content repository not found (url: https://git.example.org/repo.git)
    at transformGitCloneError
    at git.clone.then.then.catch
Caused by: HttpError: HTTP Error: 401 HTTP Basic: Access Denied
    at GitCredentialManagerStore.rejected
    at fill.then

10.1. Einfache Hinweise

10.2. Hinweise mit komplexem Inhalt

11.1. Literal Blocks

This is a literal block.
All formatting is preserved exactly as written.
    Indentation is maintained.
Special characters like < > & are not escaped.

11.2. Listing Blocks

This is a listing block.
Similar to literal blocks but typically used for code.

11.3. Code with no Syntax Highlighting

module Main where

main :: IO ()
main = print "Hello World!"

11.4. Code with Syntax Highlighting

-- Hello world example:
module Main where

data = ()
type = String
year = 2020 / 1.0 * 1

studio = 10 + 10.0 + 10e0 + 0o10 + 0x10 -- → 54

main :: IO ()
main = print "Hello World!"

function greet(name) {
  console.log(`Hello, ${name}!`);
  return `Hello, ${name}!`;
}

greet('AsciiDoctor');

def fibonacci(n):
  """Calculate Fibonacci number."""
  if n <= 1:
    return n
  return fibonacci(n-1) + fibonacci(n-2)

print(fibonacci(10))

require 'sinatra'

get '/hi' do
  "Hello World!"
end

11.5. Code Blocks with Callouts (todo)

public class HelloWorld {
    public static void main(String[] args) { <1>
        System.out.println("Hello, World!"); <2>
    }
}

12.1. Horizontal Ruler

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

12.2. Open Blocks

This is an open block.

It can contain any content and is useful for custom formatting.

12.3. Sidebar (nyi)

12.4. Example Blocks (nyi)

13.1. IDs and Roles

This paragraph has a custom ID and class.

13.2. Custom Roles

This text is highlighted in red (if CSS supports it).

This is an important note with custom styling.

13.3. Attributes

This document is version 2.0, released on 2024-01-01.

13.4. Passthrough Blocks

13.5. Comments

13.6. Bibliography (todo)

The AsciiDoctor documentation[AsciiDoctor Docs] provides comprehensive information.

AsciiDoctor Documentation

13.7. Page Breaks (nyi)

This content appears on a new page (if supported by the backend).

13.8. Icons (nyi)

13.9. Keyboard Shortcuts (nyi)

Press kbd:[Ctrl+C] to copy.

Press kbd:[Ctrl+Shift+P] for command palette.

13.10. Buttons (nyi)

button:[Save]

button:[Cancel,role="danger"]

13.11. Menu Selections (nyi)

Select menu:File[New > Project] to create a new project.

13.12. "Description Lists" (nyi)

Horizontale Beschreibungsliste:

Vertical description list:

14.1. Inline Math

The quadratic formula is \$x = (-b ± sqrt(b^2-4ac))/(2a)\$.

14.2. Block Math

(end with a paragraph to calc the right bsm on the footnotes section)