Inhaltsblöcke

Drücke im Editor /, um das Block-Menü zu öffnen und einen Inhaltsblock einzufügen.

Textblöcke

Absatz und Überschriften

Absätze sind der Standard-Textblock. Verwende H2 für Hauptabschnitte und H3 für Unterabschnitte.

Blockzitat

Für zitierte Inhalte oder hervorgehobene Aussagen.

"Dokumentation ist ein Liebesbrief, den du an dein zukünftiges Ich schreibst."

Horizontale Trennlinie

Visuelle Trennung zwischen Abschnitten.

Inline-Formatierung

Markiere Text, um die Formatierung über die Toolbar oder Tastenkombinationen anzuwenden:

• Fett (Strg/Cmd+B) — Betonung

• Kursiv (Strg/Cmd+I) — dezente Betonung oder Titel

• Code (Strg/Cmd+E) — Inline-Code, Befehle oder Dateinamen

• Highlight — Aufmerksamkeit auf Schlüsselbegriffe lenken

Listen

Aufzählungs- und nummerierte Listen

Aufzählungslisten für unsortierte Elemente, nummerierte Listen für Sequenzen.

• Punkt eins

• Punkt zwei

1. Erster Schritt

2. Zweiter Schritt

Aufgabenliste

Interaktive Checkboxen, die Leser als erledigt markieren können. Der Fortschritt bleibt im Browser gespeichert.

• Eine Sammlung erstellen

• Deinen ersten Artikel schreiben

• Eine eigene Domain verbinden

Verwende dies für Einrichtungs-Checklisten, Voraussetzungen oder Verfahren, die Leser selbst verfolgen.

Verfahren

Schritte

Nummeriertes Verfahren, bei dem jeder Schritt einen Titel und einen Textkörper hat. Visueller als eine einfache nummerierte Liste.

Verwende dies für komplexe Verfahren, Tutorials oder Workflows, bei denen jeder Schritt detaillierte Anweisungen benötigt.

Layout-Blöcke

Spalten

Inhalte nebeneinander. Wähle beim Einfügen des Blocks zwischen 2 oder 3 Spalten.

Verwende dies für Vergleiche, Funktionsübersichten oder das Aufteilen verwandter Inhalte.

Karte

Hervorgehobene Box, die auf einen anderen Artikel verlinkt. Füge ein Icon über die Icon-Auswahl hinzu.

Verwende dies für Links zu verwandten Artikeln oder für die Navigation zum nächsten Schritt.

Button

Ein einzelner Call-to-Action-Button für externe Links.

Verwende dies für primäre externe Aktionen. Maximal einer pro Artikel.

Code-Blöcke

Einzelner Code-Block

Code mit Syntax-Highlighting. Füge bei Bedarf ein Dateinamen-Label hinzu.

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

Multi-Code

Derselbe Code in mehreren Sprachen mit Tab-Umschaltung.

// JavaScript
fetch('/api/articles')
  .then(res => res.json())

# Python
import requests
response = requests.get('/api/articles')

Verwende dies für API-Beispiele mit SDKs in mehreren Sprachen.

Ausklappbarer Inhalt

Details

Inhalt, der beim Klicken ausgeklappt wird. Der Leser sieht nur die Zusammenfassung, bis er sie öffnet.

Verwende dies für FAQs, optionales Hintergrundwissen oder Fehlerbehebungen, die nicht alle Leser benötigen.

Medien

Bild

Füge Bilder hinzu, indem du Dateien in den Editor ziehst, aus der Zwischenablage einfügst oder das Slash-Menü verwendest. Unterstützt PNG, JPEG, GIF und WebP.

Video

Füge Videos hinzu, indem du sie von einer Hosting-Plattform einbettest oder eine Datei direkt hochlädst. Drücke / und wähle Video aus dem Block-Menü aus, dann entscheide dich für das Einbetten einer URL oder das Hochladen einer Datei.

Ein Video einbetten

Füge eine URL von YouTube, Vimeo, Wistia, Loom oder Tella ein, um das Video in deinen Artikel einzubetten.

Ein Video hochladen

Lade eine Videodatei direkt von deinem Computer hoch. Unterstützte Formate sind MP4, WebM, MOV und OGG.

Upload-Limits:

• Maximale Dateigröße: 512 MB

• Maximale Dauer: 2 Stunden

Wenn ein Video diese Anforderungen nicht erfüllt, siehst du eine Inline-Validierungsfehlermeldung im Upload-Element. Häufige Fehler sind:

• Dateityp nicht unterstützt — lade ein MP4-, WebM-, MOV- oder OGG-Video hoch

• Datei zu groß — maximale Größe ist 512 MB

• Video zu lang — maximale Dauer ist 2 Stunden

• Leere Datei — die Videodatei enthält keine Daten

• Upload failed — das Video konnte nicht hochgeladen werden, versuche es erneut

Benutzerdefiniertes HTML

Füge benutzerdefiniertes HTML hinzu, um Widgets von Drittanbietern, Formulare oder andere externe Inhalte von Anbietern wie Typeform, Calendly, Tally oder jedem Dienst, der Einbettungscode bereitstellt, einzubetten. Drücke / und wähle Custom HTML aus dem Block-Menü.

Seitennotizen

Callout

Hervorgehobener Absatz für Tipps, Warnungen oder wichtige Informationen.

Auf ein oder zwei pro Artikel beschränken. Niemals mehrere stapeln.

Daten

Tabelle

Strukturierte Daten in Zeilen und Spalten.

Verwandte Ressourcen

• Wie man Artikel manuell erstellt

• Artikel mit Fern erstellen und bearbeiten