Skip to main content

Grundlegende Schreib- und Formatierungssyntax

Erstelle mit einer einfachen Syntax eine ausgereifte Formatierung für deine Texte und Codes auf GitHub.

Wer kann dieses Feature verwenden?

Markdown kann auf der Webbenutzeroberfläche von GitHub verwendet werden.

Überschriften

Um eine Überschrift zu erstellen, kannst du bis zu sechs Rautensymbole (#) vor dem Text der Überschrift hinzufügen. Die Anzahl der verwendeten Rauten (#) bestimmt die Hierarchieebene und die Schriftgröße der Überschrift.

# A first-level heading
## A second-level heading
### A third-level heading

Screenshot des gerenderten GitHub-Markdowns mit Beispielen für die Überschriften h1, h2 und h3, die in Schriftgröße und visueller Gewichtung abnehmen, um die absteigende Hierarchieebene anzuzeigen.

Wenn du mindestens zwei Überschriften verwendest, generiert GitHub automatisch ein Inhaltsverzeichnis, auf das du zugreifen kannst, indem du innerhalb des Dateiheaders auf klickst. Die einzelnen Überschriftentitel werden im Inhaltsverzeichnis aufgeführt, und du kannst auf einen Titel klicken, um zum gewünschten Abschnitt zu navigieren.

Screenshot der Infodatei im Open-Source-Repository von GitHub Docs mit geöffnetem Dropdownmenü für das Inhaltsverzeichnis. Das Symbol für das Inhaltsverzeichnis ist in dunklem Orange eingerahmt.

Formatieren von Text

Du kannst Text in Kommentarfeldern und Dateien vom Typ .md mittels Fettformatierung, Kursivformatierung, durchgestrichenem, tief- oder hochgestelltem Text hervorheben.

StyleSyntaxTastenkombinationenBeispielOutput
Fett** ** oder __ __BEFEHL+B (Mac) oder STRG+B (Windows/Linux)**This is bold text**Dieser Text ist fett.
Kursiv* * oder _ _     BEFEHL+I (Mac) oder STRG+I (Windows/Linux)_This text is italicized_Dieser Text ist kursiv.
Durchgestrichen~~ ~~Keine~~This was mistaken text~~Dieser Text war falsch.
Fett und kursiv verschachtelt** ** und _ _Keine**This text is _extremely_ important**Dieser Text ist sehr wichtig.
Alles fett und kursiv*** ***Keine***All this text is important***Dieser gesamte Text ist wichtig.
Tiefgestellt<sub> </sub>KeineThis is a <sub>subscript</sub> textDies ist ein tiefgestellter Text.
Hochgestellt<sup> </sup>KeineThis is a <sup>superscript</sup> textDies ist ein hochgestellter Text.
Unterstrich<ins> </ins>KeineThis is an <ins>underlined</ins> textDies ist ein unterstrichener Text.

Zitieren von Text

Text kann mit dem folgenden Zeichen zitiert werden: >.

Text that is not a quote

> Text that is a quote

Zitierter Text wird eingerückt und in einer anderen Schriftfarbe dargestellt.

Screenshot des gerenderten GitHub-Markdowns mit einem Beispiel für zitierten Text. Das Zitat wird mit einer vertikalen Linie auf der linken Seite eingerückt, und der Text ist dunkelgrau statt schwarz.

Note

In einer Unterhaltung kannst du Text in einem Kommentar automatisch zitieren, indem du den Text markierst und anschließend R drückst. Wenn du einen vollständigen Kommentar zitieren möchtest, kannst du auf und anschließend auf Antwort mit Zitat klicken. Weitere Informationen zu Tastenkombinationen findest du unter Tastenkombinationen.

Code zitieren

Du kannst Code oder einen Befehl innerhalb eines Satzes mit einfachen Backticks zitieren. Der Text innerhalb der Backticks wird nicht formatiert. Du kannst auch die Tastenkombination Command+E (Mac) oder STRG+E (Windows/Linux) verwenden, um die Backticks für einen Codeblock innerhalb einer Markdownzeile einzufügen.

Use `git status` to list all new or modified files that haven't yet been committed.

Screenshot des gerenderten GitHub-Markdowns mit der Darstellung von Zeichen, die in Backticks eingeschlossen sind. Die Wörter „git status“ werden in einer Schriftart mit fester Breite und hellgrau hervorgehoben angezeigt.

Um Code oder einen Text in einem eigenen Absatz zu formatieren, verwende dreifache Backticks.

Some basic Git commands are:
```
git status
git add
git commit
```

Screenshot des gerenderten GitHub-Markdowns mit einem Codeblock. Die Wörter „git status“, „git add“ und „git commit“ werden in einer Schriftart mit fester Breite und hellgrau hervorgehoben angezeigt.

Weitere Informationen findest du unter Code-Blöcke erstellen und markieren.

Wenn du häufig Codeausschnitte und Tabellen bearbeitest, profitierst du möglicherweise von der Aktivierung einer Schriftart mit fester Breite in allen Kommentarfeldern auf GitHub Enterprise Server. Weitere Informationen finden Sie unter Informationen zum Schreiben und Formatieren bei GitHub.

Unterstützte Farbmodelle

In Issues, Pull Requests und Diskussionen kannst du mit Backticks Farben innerhalb eines Satzes aufrufen. Ein unterstütztes Farbmodell in Backticks zeigt eine Visualisierung der Farbe an.

The background color is `#ffffff` for light mode and `#000000` for dark mode.

Screenshot des gerenderten GitHub-Markdowns, der zeigt, wie HEX-Werte in Backticks kleine Farbkreise erstellen. #ffffff zeigt einen weißen Kreis und #000000 einen schwarzen Kreis.

Hier findest du die derzeit unterstützten Farbmodelle.

ColorSyntaxBeispielOutput
HEX`#RRGGBB``#0969DA`Screenshot des gerenderten GitHub-Markdowns, der zeigt, wie der HEX-Wert #0969DA mit einem blauen Kreis angezeigt wird.
RGB`rgb(R,G,B)``rgb(9, 105, 218)`Screenshot des gerenderten GitHub-Markdowns, der zeigt, wie der RGB-Wert 9, 105, 218 mit einem blauen Kreis angezeigt wird.
HSL`hsl(H,S,L)``hsl(212, 92%, 45%)`Screenshot des gerenderten GitHub-Markdowns, der zeigt, wie der HSL-Wert 212, 92%, 45% mit einem blauen Kreis angezeigt wird.

Note

  • Ein unterstütztes Farbmodell darf keine führenden oder nachgestellten Leerzeichen innerhalb der Backticks aufweisen.
  • Die Visualisierung der Farbe wird nur in Issues, Pull Requests und Diskussionen unterstützt.

Du kannst einen Inlinelink erstellen, indem du den Text in eckige Klammern [ ] und die URL in runde Klammern ( ) einschließt. Du kannst auch die Tastenkombination BEFEHL+K verwenden, um einen Link zu erstellen. Wenn Text ausgewählt ist, kannst du eine URL aus der Zwischenablage einfügen, um automatisch einen Link aus der Auswahl zu erstellen.

Du kannst auch einen Markdownlink erstellen, indem du den Text markierst und die Tastenkombination BEFEHL+V verwendest. Wenn du den Text durch den Link ersetzen möchtest, verwende die Tastenkombination BEFEHL+UMSCHALT+V.

This site was built using [GitHub Pages](https://pages.github.com/).

Screenshot des gerenderten GitHub-Markdowns, der zeigt, wie Text in Klammern, „GitHub Pages“, als blauer Link angezeigt wird.

Note

GitHub Enterprise Server erstellt automatisch Links, wenn du gültige URLs in einen Kommentar einfügst. Weitere Informationen findest du unter Automatisch verlinkte Verweise und URLs.

Sie können direkt eine Verknüpfung mit jedem Abschnitt mit einer Überschrift vornehmen. Um den automatisch generierten Anker in einer gerenderten Datei anzuzeigen, zeigen Sie mit der Maus auf die Abschnittsüberschrift, um das -Symbol verfügbar zu machen, und klicken Sie auf das Symbol, um den Anker in Ihrem Browser anzuzeigen.

Screenshot einer Infodatei für ein Repository. Links neben einer Abschnittsüberschrift ist ein Linksymbol dunkelorange umrandet.

Wenn Sie den Anker für eine Überschrift in einer von Ihnen bearbeiteten Datei bestimmen müssen, können Sie sich an die folgenden Grundregeln halten:

  • Buchstaben werden in Kleinbuchstaben konvertiert.
  • Leerzeichen werden durch Bindestriche (-) ersetzt. Alle anderen Leerzeichen oder Interpunktionszeichen werden entfernt.
  • Führende und nachgestellte Leerzeichen werden entfernt.
  • Markupformatierung wird entfernt, sodass nur der Inhalt übrig bleibt (z. B. wird _italics_ zu italics).
  • Wenn der automatisch generierte Anker für eine Überschrift mit einem früheren Anker im selben Dokument identisch ist, wird ein eindeutiger Bezeichner durch Anfügen eines Bindestrichs und einer automatisch erhöhten ganzen Zahl generiert.

Ausführlichere Informationen zu den Anforderungen von URI-Fragmenten finden Sie unter RFC 3986: Uniform Resource Identifier (URI): Generische Syntax, Abschnitt 3.5.

Der folgende Codeblock veranschaulicht die Grundregeln zum Generieren von Ankern aus Überschriften in gerenderten Inhalten.

# Example headings

## Sample Section

## This'll be a _Helpful_ Section About the Greek Letter Θ!
A heading containing characters not allowed in fragments, UTF-8 characters, two consecutive spaces between the first and second words, and formatting.

## This heading is not unique in the file

TEXT 1

## This heading is not unique in the file

TEXT 2

# Links to the example headings above

Link to the sample section: [Link Text](#sample-section).

Link to the helpful section: [Link Text](#thisll--be-a-helpful-section-about-the-greek-letter-Θ).

Link to the first non-unique section: [Link Text](#this-heading-is-not-unique-in-the-file).

Link to the second non-unique section: [Link Text](#this-heading-is-not-unique-in-the-file-1).

Note

Wenn Sie eine Überschrift bearbeiten oder die Reihenfolge von Überschriften mit „identischen“ Ankern ändern, müssen Sie auch Links zu diesen Überschriften aktualisieren, da sich die Anker ändern.

Du kannst relative Links und Bildpfade in deinen gerenderten Dateien definieren, um Leser dabei zu unterstützen, in deinem Repository zu anderen Dateien zu navigieren.

Ein relativer Link ist ein Verknüpfung, die relativ zur aktuellen Datei ist. Wenn sich beispielsweise eine README-Datei im Root deines Repositorys und eine andere Datei in docs/CONTRIBUTING.md befindet, sieht der relative Link zu CONTRIBUTING.md in deiner README-Datei wie folgt aus:

[Contribution guidelines for this project](docs/CONTRIBUTING.md)

GitHub Enterprise Server wandelt deinen relativen Link oder den Bildpfad automatisch anhand dessen um, auf welchem Branch du dich gerade befindest, damit der Link oder der Pfad immer funktioniert. Der Pfad des Links ist relativ zur aktuellen Datei. Links, die mit / beginnen, sind relativ zum Repositorystamm. Du kannst alle relativen Linkoperanden verwenden, z. B. ./ und ../.

Ihr Linktext sollte sich in einer einzelnen Zeile befindet. Das folgende Beispiel funktioniert nicht.

[Contribution 
guidelines for this project](docs/CONTRIBUTING.md)

Relative Links sind für Benutzer, die dein Repository klonen, einfacher zu verwenden. Absolute Links funktionieren möglicherweise nicht in Klons deines Repositorys - wir empfehlen relative Links zu verwenden, um auf andere Dateien in deinem Repository zu verweisen.

Benutzerdefinierte Anker

Sie können standardmäßige HTML-Ankertags (<a name="unique-anchor-name"></a>) verwenden, um Navigationsankerpunkte für eine beliebige Position im Dokument zu erstellen. Um mehrdeutige Verweise zu vermeiden, sollten Sie ein eindeutiges Benennungsschema für Ankertags verwenden, indem Sie z. B. eines Präfix zum Attributwert name hinzufügen.

Note

Benutzerdefinierte Anker werden nicht in die Dokumentgliederung/das Inhaltsverzeichnis aufgenommen.

Sie können eine Verknüpfung mit einem benutzerdefinierten Anker unter Verwendung des Wert des Attributs name herstellen, das Sie dem Anker gegeben haben. Die Syntax ist genau gleich wie beim Verknüpfen mit einem Anker, der für eine Überschrift automatisch generiert wird.

Zum Beispiel:

# Section Heading

Some body text of this section.

<a name="my-custom-anchor-point"></a>
Some text I want to provide a direct link to, but which doesn't have its own heading.

(… more content…)

[A link to that custom anchor](#my-custom-anchor-point)

Tip

Benutzerdefinierte Anker werden vom automatischen Benennungs- und Nummerierungsverhalten automatischer Überschriftenlinks nicht berücksichtigt.

Bilder

Du kannst ein Bild anzeigen, indem du ! hinzufügst und den Alternativtext mit [ ] umschließt. Alternativtext ist ein kurzer Text, der den Informationen im Bild entspricht. Umschließe dann den Link für das Bild mit Klammern ().

![Screenshot of a comment on a GitHub issue showing an image, added in the Markdown, of an Octocat smiling and raising a tentacle.](https://myoctocat.com/assets/images/base-octocat.svg)

Screenshot eines Kommentars zu einem GitHub-Issue, das ein im Markdown hinzugefügtes Bild von Octocat zeigt, die lächelt und einen Tentakel hebt.

GitHub Enterprise Server unterstützt das Einbetten von Bildern in Issues, Pull Requests, Kommentare und Dateien vom Typ .md. Du kannst ein Bild aus deinem Repository anzeigen, einen Link zu einem Onlinebild hinzufügen oder ein Bild hochladen. Weitere Informationen findest du unter Ressourcen hochladen.

Note

Wenn du ein Bild anzeigen möchtest, das sich in deinem Repository befindet, solltest du keine absoluten Links, sondern relative Links verwenden.

Hier findest du einige Beispiele für die Verwendung relativer Links zum Anzeigen eines Bilds.

KontextRelativer Link
In einer Datei vom Typ .md im gleichen Branch/assets/images/electrocat.png
In einer Datei vom Typ .md in einem anderen Branch/../main/assets/images/electrocat.png
In Issues, Pull Requests und Kommentaren des Repositorys../blob/main/assets/images/electrocat.png?raw=true
In einer Datei vom Typ .md in einem anderen Repository/../../../../github/docs/blob/main/assets/images/electrocat.png
In Issues, Pull Requests und Kommentaren eines anderen Repositorys../../../github/docs/blob/main/assets/images/electrocat.png?raw=true

Note

Die letzten beiden relativen Links in der obigen Tabelle funktionieren nur für Bilder in einem privaten Repository, wenn der Betrachter mindestens Lesezugriff auf das private Repository besitzt, das die Bilder enthält.

Weitere Informationen findest du unter Relative Links.

Design angeben, in dem ein Bild angezeigt wird

Du kannst das Design angeben, für das ein Bild in Markdown angezeigt wird, indem du das HTML-Element <picture> in Kombination mit dem Medienfeature prefers-color-scheme verwendest. Wir unterscheiden zwischen hellem und dunklem Farbmodus. Es sind also zwei Optionen verfügbar. Du kannst diese Optionen verwenden, um Bilder anzuzeigen, die für dunkle oder helle Hintergründe optimiert sind. Das ist besonders bei transparenten PNG-Bildern hilfreich.

Der folgende Code zeigt beispielsweise ein Bild einer Sonne für helle Designs und einen Mond für dunkle Designs an:

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/25423296/163456776-7f95b81a-f1ed-45f7-b7ab-8fa810d529fa.png">
  <source media="(prefers-color-scheme: light)" srcset="https://user-images.githubusercontent.com/25423296/163456779-a8556205-d0a5-45e2-ac17-42d089e3c3f8.png">
  <img alt="Shows an illustrated sun in light mode and a moon with stars in dark mode." src="https://user-images.githubusercontent.com/25423296/163456779-a8556205-d0a5-45e2-ac17-42d089e3c3f8.png">
</picture>

Die alte Methode, Bilder anhand des Themas zu kennzeichnen, indem ein Fragment an die URL angehängt wird (#gh-dark-mode-only oder #gh-light-mode-only), lautet deprecated und wird zugunsten der oben beschriebenen neuen Methode entfernt.

Listen

Du kannst eine ungeordnete Liste erstellen, indem du einer Textzeile oder mehreren Textzeilen -, * oder + voranstellst.

- George Washington
* John Adams
+ Thomas Jefferson

Screenshot des gerenderten GitHub-Markdowns mit einer Aufzählung der Namen der ersten drei amerikanischen Präsidenten.

Um deine Liste zu ordnen, stelle jeder Zeile eine Zahl voran.

1. James Madison
2. James Monroe
3. John Quincy Adams

Screenshot des gerenderten GitHub-Markdowns mit einer nummerierten Liste der Namen des vierten, fünften und sechsten amerikanischen Präsidenten.

Verschachtelte Listen

Du kannst eine verschachtelte Liste erstellen, indem du ein Listenelement oder mehrere Listenelemente unter einem anderen Element einrückst.

Beim Web-Editor in GitHub Enterprise Server oder bei einem Texteditor wie Visual Studio Code, der eine Festbreitenschriftart verwendet, kannst du deine Liste visuell ausrichten. Gib vor dem einzurückenden Listenelement so viele Leerzeichen ein, bis das Listenzeichen (- oder *) direkt unter dem ersten Zeichen des darüber liegenden Elements liegt.

1. First list item
   - First nested list item
     - Second nested list item

Note

Im webbasierten Editor kannst du eine oder mehrere Textzeilen ein- oder ausrücken, indem du zuerst die gewünschten Zeilen markierst und dann TAB bzw. UMSCHALT+TAB drückst.

Screenshot von Markdown in Visual Studio Code, der zeigt, wie eingerückte Aufzählungszeichen vertikal am ersten Buchstaben der darüber stehenden Textzeilen ausgerichtet sind.

Screenshot des gerenderten GitHub-Markdowns mit einem nummerierten Element, gefolgt von einem Aufzählungselement mit Einrückung um eine Ebene nach rechts sowie einem weiteren Aufzählungselement, das noch weiter nach rechts eingerückt ist.

Um eine verschachtelte Liste im Kommentareditor auf GitHub Enterprise Server zu erstellen, der keine nicht proportionale Schriftart verwendet, kannst du Dir das Listenelement direkt über der verschachtelten Liste ansehen und die Anzahl der Zeichen zählen, die vor dem Inhalt dieses Elements stehen. Gib diese Anzahl an Leerzeichen dann vor dem untergeordneten Listenelement ein.

In diesem Beispiel kannst du ein untergeordnetes Listenelement unter dem Listenelement 100. First list item hinzufügen, indem du das untergeordnete Listenelement mindestens fünf Leerzeichen weit einrückst, da sich vor First list item fünf Zeichen (100. ) befinden.

100. First list item
     - First nested list item

Screenshot des gerenderten GitHub-Markdowns mit einem Listenelement, dem die Zahl 100 vorangestellt ist, gefolgt von einem Aufzählungselement, das eine Ebene nach rechts eingerückt ist.

Du kannst mit derselben Methode mehrere Ebenen an verschachtelten Listen erstellen. Ein Beispiel: Da das erste geschachtelte Listenelement vor dem geschachtelten Listeninhalt First nested list item sieben Zeichen (␣␣␣␣␣-␣) enthält, musst du das zweite geschachtelte Listenelement um mindestens zwei weitere Zeichen (mindestens neun Leerzeichen) einrücken.

100. First list item
     - First nested list item
       - Second nested list item

Screenshot des gerenderten GitHub-Markdowns mit einem Listenelement, dem die Zahl 100 vorangestellt ist, gefolgt von einem Aufzählungselement mit Einrückung um eine Ebene nach rechts sowie einem weiteren Aufzählungselement, das noch weiter nach rechts eingerückt ist.

Weitere Beispiele findest du in der Spezifikation zu GitHub Flavored Markdown.

Aufgabenlisten

Um eine Aufgabenliste zu erstellen, stellst du den Listenelementen einen Bindestrich und ein Leerzeichen gefolgt von [ ] voran. Um eine Aufgabe als erledigt zu markieren, verwende [x].

- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:

Screenshot: Gerenderte Version des Markdowns. Die Verweise auf Issues werden als Issuetitel gerendert.

Wenn die Beschreibung eines Aufgabenlistenelements mit einer Klammer beginnt, muss die Klammer mit dem Escapezeichen \ versehen werden:

- [ ] \(Optional) Open a followup issue

Weitere Informationen findest du unter Informationen zu Aufgabenlisten.

Personen und Teams erwähnen

Du kannst eine Person oder ein Team in GitHub Enterprise Server erwähnen, indem du @ sowie den Benutzer- oder Teamnamen eingibst. Dadurch wird eine Benachrichtigung ausgelöst und die Aufmerksamkeit auf die Unterhaltung gelenkt. Wenn du einen Kommentar bearbeitest und dabei den Benutzer- oder Teamnamen erwähnst, wird die Person respektive das Team ebenfalls benachrichtigt. Weitere Informationen zu Benachrichtigungen findest du unter Informationen zu Benachrichtigungen.

Note

Eine Person wird nur über eine Erwähnung benachrichtigt, wenn die Person Lesezugriff auf das Repository hat. Falls das Repository einer Organisation gehört, muss die Person außerdem der Organisation angehören.

@github/support What do you think about these updates?

Screenshot des gerenderten GitHub-Markdowns, der zeigt, wie die Erwähnung des Teams @github/support als anklickbarer Text in Fettformatierung dargestellt wird.

Wenn du ein übergeordnetes Team erwähnst, erhalten auch die Mitglieder untergeordneter Teams Benachrichtigungen, was die Kommunikation mit mehreren Personengruppen erleichtert. Weitere Informationen findest du unter Informationen zu Teams.

Wenn du das Zeichen @ eingibst, wird eine Liste der Personen oder Teams eines Projektes angezeigt. Diese Liste wird während deiner Eingabe gefiltert. Wenn du den Namen der gewünschten Person respektive des gewünschten Teams siehst, kannst du ihn mit den Pfeiltasten auswählen und die Tabulator- oder Eingabetaste drücken, um den Namen zu vervollständigen. Gib für Teams @organization/team-name ein. Daraufhin wird die Unterhaltung für alle Mitglieder des Teams abonniert.

Die automatisch vervollständigten Ergebnisse sind auf Repository-Mitarbeiter und andere Thread-Teilnehmer beschränkt.

Auf Issues und Pull Requests verweisen

Du kannst eine Liste vorgeschlagener Issues und Pull Requests im Repository anzeigen, indem du # eingibst. Gib die Nummer des Issues oder Pull Requests ein, um die Liste zu filtern, und drücke dann die Tabulator- oder Eingabetaste, um das markierte Ergebnis zu vervollständigen.

Weitere Informationen findest du unter Automatisch verlinkte Verweise und URLs.

Auf externe Ressourcen verweisen

Wenn benutzerdefinierte Autolink-Referenzen für ein Repository konfiguriert sind, werden Verweise auf externe Ressourcen, beispielsweise ein JIRA-Issue oder ein Zendesk-Ticket, in verkürzte Links umgewandelt. Wenn Du wissen möchtest, welche automatische Verknüpfungen in Deinem Repository verfügbar sind, wende Dich an eine Person mit Administratorberechtigungen für das Repository. Weitere Informationen findest du unter Automatische Verlinkungen von externen Ressourcen konfigurieren.

Ressourcen hochladen

Zum Hochladen von Ressourcen (beispielsweise Bilder) kannst du Drag&Drop verwenden, die Ressourcen über einen Dateibrowser auswählen oder sie einfügen. Du kannst Ressourcen in Issues, Pull Requests, Kommentare und Dateien vom Typ .md in deinem Repository hochladen.

Emojis verwenden

Du kannst deinem Text Emojis hinzufügen, indem du :EMOJICODE:, einen Doppelpunkt gefolgt vom Namen des Emojis, eingibst.

@octocat :+1: This PR looks great - it's ready to merge! :shipit:

Screenshot des gerenderten GitHub-Markdowns, der zeigt, wie Emoji-Codes für +1 und Shipit visuell als Emoji gerendert werden.

Wenn du : eingibst, wird eine Liste mit vorgeschlagenen Emojis angezeigt. Die Liste wird bei der Eingabe gefiltert. Wenn du das gewünschte Emoji siehst, drücke TAB oder die EINGABETASTE, um das hervorgehobene Ergebnis zu vervollständigen.

Eine vollständige Liste der verfügbaren Emojis und Codes findest du im Spickzettel für Emojis.

Absätze

Um einen neuen Absatz zu erstellen, lasse eine Zeile zwischen den Textzeilen leer.

Fußnoten

Mit der folgenden Klammersyntax kannst du deinem Inhalt Fußnoten hinzufügen:

Here is a simple footnote[^1].

A footnote can also have multiple lines[^2].

[^1]: My reference.
[^2]: To add line breaks within a footnote, prefix new lines with 2 spaces.
  This is a second line.

Die Fußnote wird wie folgt gerendert:

Screenshot des gerenderten Markdowns mit hochgestellten Zahlen, die zur Angabe von Fußnoten verwendet werden, sowie optionale Zeilenumbrüche in einer Fußnote.

Note

Die Position einer Fußnote in deinem Markdown hat keinen Einfluss darauf, wo die Fußnote gerendert wird. Du kannst eine Fußnote direkt nach dem Verweis auf die Fußnote schreiben, und die Fußnote wird trotzdem am unteren Rand des Markdowns gerendert. In Wikis werden Fußnoten nicht unterstützt.

Alerts

Warnungen sind eine Markdown-Erweiterung basierend auf der Blockquote-Syntax, mit der Sie kritische Informationen hervorheben können. Auf GitHub Enterprise Server werden sie mit charakteristischen Farben und Symbolen angezeigt, um auf die Signifikanz des Inhalts hinzuweisen.

Verwenden Sie Warnungen nur, wenn sie für den Benutzererfolg von entscheidender Bedeutung sind, und beschränken Sie sie auf ein oder zwei pro Artikel, um zu verhindern, dass der Leser überlastet wird. Darüber hinaus sollten Sie vermeiden, Benachrichtigungen nacheinander zu platzieren. Warnungen können nicht in anderen Elementen geschachtelt werden.

Um eine Warnung hinzuzufügen, verwenden Sie eine spezielle Blockquotezeile, die den Warnungstyp angibt, gefolgt von den Warnungsinformationen in einer Standardblockquote. Es stehen fünf Arten von Warnungen zur Verfügung:

> [!NOTE]
> Useful information that users should know, even when skimming content.

> [!TIP]
> Helpful advice for doing things better or more easily.

> [!IMPORTANT]
> Key information users need to know to achieve their goal.

> [!WARNING]
> Urgent info that needs immediate user attention to avoid problems.

> [!CAUTION]
> Advises about risks or negative outcomes of certain actions.

Hier sind die gerenderten Warnungen aufgeführt:

Screenshot von gerenderten Markdown-Warnungen, die zeigen, wie Hinweis, Tipp, Wichtig, Warnung und Vorsicht mit verschiedenfarbigem Text und Symbolen gerendert werden.

Inhalt mit Kommentaren ausblenden

Du kannst GitHub Enterprise Server anweisen, Inhalt aus dem gerenderten Markdown auszublenden, indem du den Inhalt in einem HTML-Kommentar platzierst.

<!-- This content will not appear in the rendered Markdown -->

Markdown-Formatierung ignorieren

Du kannst GitHub Enterprise Server anweisen, die Markdown-Formatierung zu ignorieren (oder zu umgehen), indem du \ vor dem Markdown-Zeichen platzierst.

Let's rename \*our-new-project\* to \*our-old-project\*.

Screenshot des gerenderten GitHub-Markdowns, der zeigt, wie umgekehrte Schrägstriche die Konvertierung von Sternchen in Kursivschrift verhindern. Der Text lautet „Benennen wir unser-neues-Projekt in unser-altes-Projekt um“.

Weitere Informationen zu umgekehrten Schrägstrichen findest du in der Markdown-Syntax von Daring Fireball.

Note

Die Markdownformatierung wird im Titel eines Issues oder eines Pull Requests nicht ignoriert.

Deaktivieren des Markdown-Renderings

Wenn du eine Markdowndatei anzeigst, kannst du oben in der Datei auf Code klicken, um das Rendern von Markdown zu deaktivieren und stattdessen den Quelltext der Datei anzuzeigen.

Screenshot einer Markdowndatei in einem GitHub-Repository mit Optionen für die Interaktion mit der Datei. Eine Schaltfläche mit der Bezeichnung „Code“ ist dunkelorange umrandet.

Durch das Deaktivieren des Markdownrenderings kannst du die Funktionen der Quellenansicht nutzen, wie z. B. Zeilenverknüpfungen, die beim Anzeigen von gerenderten Markdowndateien nicht verfügbar sind.

Weitere Informationsquellen