Unterstreichen in Markdown: Was auf GitHub und in anderen Renderern funktioniert

Markdown hat keine native Syntax zum Unterstreichen von Text. In CommonMark und GitHub Flavored Markdown bedeutet _text_ kursiv und __text__ fett. Eine Unterstreichung erfordert gewöhnlich HTML-Unterstützung oder eine anwendungsspezifische Erweiterung.

Auf GitHub ist folgende Form dokumentiert:

Die <ins>geänderte Frist</ins> endet am Freitag.

GitHub führt <ins>...</ins> in seiner Dokumentation zur grundlegenden Formatierung für unterstrichenen Text auf. Das ist eine von der Plattform unterstützte HTML-Option und kein neues Markdown-Begrenzungszeichen, das überall funktioniert.

Unterstreichen, Fettdruck und Kursivschrift im Vergleich

Quelltext	Bedeutung	Wo es zu erwarten ist
_wichtig_	Betonung, meist kursiv	CommonMark und GFM
__wichtig__	Starke Betonung, meist fett	CommonMark und GFM
**wichtig**	Starke Betonung, meist fett	CommonMark und GFM
<ins>eingefügter Text</ins>	Eingefügter Text, meist unterstrichen	Renderer mit HTML-Unterstützung; von GitHub dokumentiert
<u>annotierter Text</u>	HTML-Annotation, meist unterstrichen	Renderer, die dieses HTML-Element erlauben

Wählen Sie Fettdruck oder Kursivschrift, wenn Sie etwas betonen möchten. Beispielsweise bleibt **Fällig am Freitag** in einer README, einer Notiz und einem Markdown-Export verwendbar, ohne von rohem HTML abzuhängen.

Was unterscheidet ins und u?

Die beiden Tags können ähnlich aussehen, haben aber unterschiedliche Bedeutungen.

<ins> kennzeichnet Text, der in ein Dokument eingefügt wurde. Das passt zu einer Überarbeitung, etwa einer neu hinzugefügten Anforderung. Browser unterstreichen ihn üblicherweise; ein Stylesheet kann das Aussehen jedoch ändern. Siehe die MDN-Referenz für eingefügten Text.

Diese Version unterstützt <ins>CSV- und TSV-Importe</ins>.

<u> markiert eine Annotation, die keine gewöhnliche Betonung ist, etwa die Kennzeichnung eines Rechtschreibfehlers. Modernes HTML definiert es nicht als allgemeines Tag für „dies ist wichtig“. Siehe die MDN-Referenz zum u-Element.

Bitte prüfen Sie die Schreibweise von <u>Vorraussetzung</u>.

Wenn Sie eine Website kontrollieren und eine rein optische Unterstreichung benötigen, verwenden Sie text-decoration: underline in CSS. Eine gehostete Markdown-Plattform kann Style-Attribute entfernen oder eigene Stile verbieten. Auch dieser Ansatz ist daher nicht überall übertragbar.

Warum funktioniert Unterstreichen in einem Editor und verschwindet in einem anderen?

Es gibt drei getrennte Entscheidungen: Der Markdown-Parser erkennt HTML, die Anwendung legt erlaubte Tags fest und das Stylesheet am Ziel bestimmt das Aussehen der erlaubten Elemente. GFM-Unterstützung garantiert nicht, dass ein Produkt alle HTML-Tags zulässt.

Der MD File Viewer-Editor entfernt derzeit rohe HTML-Tags aus Benutzereingaben. Wenn Sie dort <ins>eingefügter Text</ins> oder <u>annotierter Text</u> einfügen, bleiben die Wörter ohne diese Tags erhalten; die Vorschau unterstreicht sie daher nicht. Nutzen Sie diese Vorschau für unterstützte Markdown-Formatierungen und prüfen Sie HTML-basierte Formatierungen dort, wo sie veröffentlicht werden.

Wenn Sie ein HTML-Dokument nach Markdown übertragen, hilft HTML in Markdown, Text, Überschriften, Links und Listen wiederherzustellen. Unterstreichungen und eigenes CSS können verloren gehen, weil reines Markdown keine entsprechende Syntax besitzt. Prüfen Sie das Ergebnis, bevor Sie das Original ersetzen.

Beispiele für eine GitHub-README

Für eine kurze Ergänzung in einem Änderungshinweis lautet GitHubs dokumentierte HTML-Option:

Diese Version ergänzt <ins>einen optionalen Importschritt</ins>.

Verwenden Sie für eine Frist oder Anforderung Markdown-Betonung:

**Erforderlich:** Die CSV-Datei muss eine Kopfzeile enthalten.

Verwenden Sie für ein Ziel einen Link:

[Importanleitung lesen](https://example.com/import)

Unterstrichener Text kann wie ein anklickbarer Link aussehen. Lassen Sie gewöhnliche Beschriftungen nicht interaktiv wirken, insbesondere wenn derselbe Absatz echte Links enthält. Der Leitfaden zu Markdown-Links behandelt aussagekräftige Linktexte und Referenzlinks.

Häufige Fehler beim Unterstreichen

Doppelte Unterstriche machen den Text fett. Der Wechsel von **Wort** zu __Wort__ ändert das Begrenzungszeichen, nicht die Bedeutung. Beide Formen kennzeichnen starke Betonung.

Backticks zeigen das Tag als Code. Die Schreibweise `<ins>Text</ins>` ist in einem Tutorial hilfreich, zeigt aber absichtlich das Markup, statt es zu rendern.

Tastenkürzel gehören zur Anwendung. Ein Rich-Text-Editor kann einen Unterstreichen-Befehl anbieten und HTML oder sein eigenes Dokumentformat speichern. Dadurch wird Unterstreichen nicht Teil von übertragbarem Markdown.

Eine unterstrichene Überschrift ist ein anderes Konzept. In diesem Quelltext erzeugen die Bindestriche eine Überschrift zweiter Ebene:

Versionshinweise
-------------

Sie unterstreichen keinen Ausdruck innerhalb eines Absatzes. Für eine Trennlinie zwischen Abschnitten verwenden Sie eine horizontale Markdown-Linie mit Leerzeilen darüber und darunter.

Häufig gestellte Fragen

Wie unterstreiche ich in Markdown auf GitHub?

Verwenden Sie <ins>Text</ins>, das GitHub für Unterstreichungen dokumentiert. Für Betonungen, die auch in Renderern ohne HTML-Unterstützung funktionieren, verwenden Sie stattdessen **Text** oder *Text*.

Gibt es eine reine Markdown-Alternative zum Unterstreichen?

Es gibt kein standardisiertes Begrenzungszeichen für Unterstreichungen. Manche Anwendungen ergänzen eigene Syntax; prüfen Sie jedoch deren Dokumentation und das beim Export verwendete Format.

Bleibt eine Unterstreichung bei der Konvertierung von Markdown in PDF oder Word erhalten?

Nur wenn der Konverter das betreffende HTML oder die Erweiterung erhält und dessen Formatierung unterstützt. Gehen Sie nicht davon aus, dass eine in der Vorschau einer Anwendung sichtbare Unterstreichung einen anderen Export übersteht. Prüfen Sie die Ergebnisdatei oder verwenden Sie standardmäßigen Fettdruck, wenn Übertragbarkeit wichtig ist.

Der Markdown-Spickzettel bietet eine kompakte Referenz für Formatierungen mit eigener Markdown-Syntax.