Enterprise Server 3.20 ist derzeit als Release Candidate verfügbar.

Schreiben mathematischer Ausdrücke

Verwende Markdown, um mathematische Ausdrücke auf GitHub anzuzeigen.

Wer kann dieses Feature verwenden?

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

In diesem Artikel

Informationen zum Schreiben mathematischer Ausdrücke

Zur klaren Kommunikation mathematischer Ausdrücke unterstützt GitHub diese in Markdown im LaTeX-Format. Weitere Informationen findest du unter LaTeX/Mathematics in Wikibooks.

GitHub's mathematische Renderingfunktion verwendet MathJax; ein open source, JavaScript-basiertes Anzeigemodul. MathJax unterstützt eine Vielzahl von LaTeX-Makros und mehrere nützliche Erweiterungen zur Barrierefreiheit. Weitere Informationen findest du in der MathJax-Dokumentation und der Dokumentation zu MathJax-Erweiterungen zur Barrierefreiheit.

Das Rendering mathematischer Ausdrücke ist in GitHub Issues, GitHub Discussions, Pull Requests, Wikis und Markdowndateien verfügbar.

Schreiben von Inlineausdrücken

Es gibt zwei Möglichkeiten, einen mathematischen Ausdruck inline vom Text zu trennen. Du kannst den Ausdruck entweder mit Dollarsymbolen ($) umschließen oder den Ausdruck mit $` beginnen und mit `$ beenden. Die letztere Syntax ist nützlich, wenn der von dir geschriebene Ausdruck Zeichen enthält, die sich mit der Markdownsyntax überlappen. Weitere Informationen finden Sie unter Grundlegende Schreib- und Formatierungssyntax.

This sentence uses `$` delimiters to show math inline: $\sqrt{3x-1}+(1+x)^2$

Screenshot: Gerenderter Markdown-Code mit mathematischem Inlineausdruck: die Quadratwurzel aus 3x minus 1 plus (1 plus x) im Quadrat

This sentence uses $\` and \`$ delimiters to show math inline: $`\sqrt{3x-1}+(1+x)^2`$

Screenshot von gerendertem Markdown, das einen mathematischen Inlineausdruck mit Backtick-Syntax zeigt: die Quadratwurzel aus 3x minus 1 plus (1 plus x) zum Quadrat.

Schreiben von Ausdrücken als Blöcke

Um einen mathematischen Ausdruck als Block hinzuzufügen, beginnst du eine neue Zeile und trennst den Ausdruck mit zwei Dollarsymbolen $$.

Tipp

Wenn du in einer MD-Datei schreibst, musst du bestimmte Formatierungen verwenden, um einen Zeilenumbruch zu erstellen, z. B. das Beenden der Zeile mit einem umgekehrten Schrägstrich wie im folgenden Beispiel gezeigt. Weitere Informationen zur Verwendung von Zeilenumbrüchen in Markdown findest du unter Grundlegende Schreib- und Formatierungssyntax.

**The Cauchy-Schwarz Inequality**\
$$\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)$$

Screenshot: Gerenderter Markdown-Code mit einer komplexen Gleichung. Fett gedruckter Text: „Die Cauchy-Schwarz-Ungleichung“ oberhalb der Formel für die Ungleichung.

Alternativ kannst du mit der ```math-Codeblocksyntax einen mathematischen Ausdruck als Block anzeigen. Bei dieser Syntax musst du keine $$-Trennzeichen verwenden. Der folgende Code rendert die gleiche Darstellung wie oben:

**The Cauchy-Schwarz Inequality**

```math
\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
```

Dollarzeichen innerhalb und in Bezug auf mathematische Ausdrücke schreiben

Um in einer Zeile, die einen mathematischen Ausdruck enthält, ein Dollarzeichen als Zeichen anzuzeigen, müssen Sie das nicht als Trennzeichen verwendete $-Zeichen mit einem Escapezeichen versehen, um sicherzustellen, dass die Zeile ordnungsgemäß gerendert wird.

  • Füge in einem mathematischen Ausdruck vor dem expliziten \ ein $-Symbol hinzu.

    This expression uses `\$` to display a dollar sign: $`\sqrt{\$4}`$

    Screenshot des gerenderten Markdowns zeigt, wie ein Backslash vor einem Dollarzeichen das Zeichen in einem mathematischen Ausdruck darstellt.

  • Außerhalb eines mathematischen Ausdrucks, aber in derselben Zeile, verwende Span-Tags um das explizite $.

    To split <span>$</span>100 in half, we calculate $100/2$

    Screenshot: Gerenderter Markdown-Code, der zeigt, wie ein in span-Tags eingeschlossenes Dollarzeichen als Inlinetext und nicht als Teil einer mathematischen Gleichung angezeigt wird

Weiterführende Lektüre

  •         [Die MathJax-Website](http://mathjax.org)

  •         [Erste Schritte beim Schreiben und Formatieren auf GitHub](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github)

  •         [GitHub Flavored Markdown Spezifikation (Spec)](https://github.github.com/gfm/)