Grundlegende Schreib- und Formatierungssyntax

In diesem Artikel:

• Überschriften
• Textstil
• Text zitieren
• Code zitieren
• Links
• Links zu Abschnitten
• Relative Links
• Listen
• Aufgabenlisten
• Personen und Teams erwähnen
• Referencing issues and pull requests)
• Emojis verwenden
• Absätze und Zeilenumbrüche
• Markdown-Formatierung ignorieren

Überschriften

Um eine Überschrift zu erstellen, fügen Sie bis zu sechs Rautenzeichen (#) vor dem Text der Überschrift hinzu. Die Anzahl an # bestimmt die Größe der Überschrift.

# Die größte Überschrift
## Die zweitgrößte Überschrift
###### Die kleinste Überschrift

Textstil

Um Text hervorzuheben, können Sie die Fett- und/oder Kursivschreibung verwenden oder den Text durchstreichen.

Text zitieren

Sie können einen Text mit einem > zitieren.

Mit den Worten von Abraham Lincoln:

> Verzeihen Sie meine Ausdrucksweise.

Code zitieren

Sie können Code oder einen Befehl innerhalb eines Satzes mit einfachen Backticks zitieren. Der Text innerhalb der Backticks wird nicht formatiert.

Verwenden Sie `git status`, um alle neuen oder geänderten Dateien aufzulisten, die noch nicht committet wurden.

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

Zu den grundlegenden Git-Befehlen gehören:
```
git status
git add
git commit
```

Weitere Informationen finden Sie unter „Erstellen und Hervorheben von Codeblöcken“.

Links

Sie können einen Inline-Link erstellen, indem Sie den Text in eckigen Klammern [] einschließen und dann die URL in runden Klammern () einschließen. Einen Link können Sie auch mit dem Tastenkürzel Befehlstaste/Strg + K erstellen.

Diese Website wurde mit [GitHub Pages](https://pages.github.com/) erstellt.

Links zu Abschnitten

You can link directly to a section in a rendered file by hovering over the section heading to expose the link:

Relative Links

Sie können relative Links und Bildpfade in Ihren gerenderten Dateien definieren, um Leser dabei zu unterstützen, in Ihrem Repository zu anderen Dateien zu navigieren.

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

[Beitragsrichtlinien für dieses Projekt](docs/CONTRIBUTING.md)

GitHub Enterprise wandelt Ihren relativen Link oder den Bildpfad automatisch anhand dessen um, auf welchem Branch Sie sich gerade befinden, damit der Link oder der Pfad immer funktioniert. Sie können alle relativen Linkoperanden verwenden, darunter beispielsweise ./ und ../.

Relative Links sind einfacher für Benutzer zu verwenden, die Ihr Repository klonen. Absolute Links funktionieren möglicherweise nicht in Klons Ihres Repositorys. Sie sollten relative Links verwenden, um auf andere Dateien in Ihrem Repository zu verweisen.

Listen

Sie können eine ungeordnete Liste erstellen, indem Sie einer Textzeile oder mehreren Textzeilen ein - oder * voranstellen.

- George Washington
- John Adams
- Thomas Jefferson

Um Ihre Liste zu ordnen, stellen Sie jeder Zeile eine Zahl voran.

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

Verschachtelte Listen

Sie können eine verschachtelte Liste erstellen, indem Sie ein Listenelement oder mehrere Listenelemente unter einem anderen Element einrücken.

Beim Web-Editor auf GitHub Enterprise oder bei einem Texteditor wie Atom, der eine nicht proportionale Schriftart verwendet, können Sie Ihre Liste visuell ausrichten. Geben Sie 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. Erstes Listenelement
    - Erstes untergeordnetes Listenelement
    - Zweites untergeordnetes Listenelement

Um eine verschachtelte Liste im Kommentareditor auf GitHub Enterprise zu erstellen, der keine nicht proportionale Schriftart verwendet, können Sie sich das Listenelement direkt über der verschachtelten Liste ansehen und die Anzahl der Zeichen zählen, die vor dem Inhalt dieses Elements steht. Geben Sie diese Anzahl an Leerzeichen dann vor dem untergeordneten Listenelement ein.

Im folgenden Beispiel könnten Sie ein untergeordnetes Listenelement unter dem Listenelement 100 hinzufügen. <code>Erstes Listenelement hinzufügen, indem Sie das untergeordnete Listenelement um mindestens fünf Leerzeichen einrücken, da sich vor Erstes Listenelement fünf Zeichen (100.) befinden.

100. Erstes Listenelement
     - Erstes untergeordnetes Listenelement

Sie können mit derselben Methode mehrere Ebenen an verschachtelten Listen erstellen. Beispiel: Beim ersten untergeordneten Listenelement stehen sieben Zeichen (␣␣␣␣␣-␣) vor Erstes untergeordnetes Listenelement. Daher müssen Sie das zweite untergeordnete Listenelement um sieben Leerzeichen einrücken.

100. Erstes Listenelement
     - Erstes untergeordnetes Listenelement
       - Zweites untergeordnetes Listenelement

Weitere Beispiele finden Sie in den GitHub Flavored Markdown – Spezifikationen.

Aufgabenlisten

To create a task list, preface list items with a regular space character followed by [ ]. To mark a task as complete, use [x].

- [x] Finish my changes
- [ ] Push my commits to GitHub
- [ ] Open a pull request

If a task list item description begins with a parenthesis, you'll need to escape it with \:

- [ ] \(Optional) Öffnen Sie einen Nachverfolgungs-Issue.

Weitere Informationen finden Sie unter „Informationen zu Aufgabenlisten“.

Personen und Teams erwähnen

Sie können auf GitHub Enterprise eine Person oder ein Team erwähnen, indem Sie @ gefolgt vom Benutzer- bzw. Teamnamen eingeben. Dadurch erhält die Person oder das Team eine Benachrichtigung und wird auf die Unterhaltung aufmerksam gemacht. Wenn Sie einen Kommentar bearbeiten und dabei den Benutzer- oder Teamnamen erwähnen, wird die Person bzw. das Team ebenfalls benachrichtigt.

@github/support Wie findet ihr diese Aktualisierungen?

Wenn Sie ein übergeordnetes Team erwähnen, erhalten auch die Mitglieder untergeordneter Teams Benachrichtigungen, was die Kommunikation mit mehreren Personengruppen erleichtert. Weitere Informationen finden Sie unter „Informationen zu Teams“.

Wenn Sie das Zeichen @ eingeben, wird eine Liste der Personen oder Teams von einem Projekt angezeigt. Diese Liste wird während Ihrer Eingabe gefiltert. Wenn Sie den Namen der gewünschten Person bzw. des gewünschten Teams sehen, können Sie ihn mit den Pfeiltasten auswählen und die Tabulator- oder Eingabetaste drücken, um den Namen zu vervollständigen. Wenn Sie Teams erwähnen möchten, geben Sie den @Organisations-/Teamnamen ein. Alle Mitglieder des Teams haben die Unterhaltung daraufhin abonniert.

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

Auf Issues und Pull Requests verweisen

Sie können eine Liste vorgeschlagener Issues und Pull Requests im Repository anzeigen, indem Sie # eingeben. Geben Sie die Nummer des Issues oder Pull Requests ein, um die Liste zu filtern, und drücken Sie dann die Tabulator- oder Eingabetaste, um das markierte Ergebnis zu vervollständigen.

Weitere Informationen finden Sie unter „Automatisch verlinkte Verweise und URLs“.

Emojis verwenden

Sie können Emojis einfügen, indem Sie :EMOJICODE: eingeben.

@octocat :+1: Dieser Pull Request sieht gut aus. Er ist bereit zum Mergen! :shipit:

Bei der Eingabe von : wird eine Liste mit Vorschlägen für Emojis angezeigt. The list will filter as you type, so once you find the emoji you're looking for, press Tab or Enter to complete the highlighted result.

Eine komplette Liste der verfügbaren Emojis und Codes finden Sie unter emoji-cheat-sheet.com.

Absätze und Zeilenumbrüche

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

Markdown-Formatierung ignorieren

You can tell GitHub Enterprise to ignore (or escape) Markdown formatting by using \ before the Markdown character.

Wir benennen \*unser-neues-Projekt\* in \*unser-altes-Projekt\* um.

Weitere Informationen finden Sie unter „Markdown-Syntax“ von Daring Fireball.

Weiterführende Informationen

• GitHub Flavored Markdown – Spezifikation
• „Informationen zum Schreiben und Formatieren bei GitHub“
• „Mit erweiterter Formatierung arbeiten“
• „Markdown meistern“