Freigeben über


Learn Markdown-Referenz

Dieser Artikel enthält eine alphabetische Referenz zum Schreiben von Markdown für Microsoft Learn.

Markdown ist eine schlanke Markupsprache mit Nur-Text-Formatierungssyntax. Die Microsoft Learn-Plattform unterstützt CommonMark-kompatible Markdowns, die über die Markdig-Analyse-Engine analysiert werden. Microsoft Learn unterstützt auch benutzerdefinierte Markdown-Erweiterungen, die umfangreichere Inhalte auf der Microsoft Learn-Website bereitstellen.

Sie können einen beliebigen Text-Editor verwenden, um Markdown zu schreiben, aber wir empfehlen Visual Studio Code mit dem Learn Authoring Pack. Das Learn Authoring Pack bietet Bearbeitungstools und Vorschaufunktionen, mit denen Sie sehen können, wie Ihre Artikel aussehen, wenn sie in Microsoft Learn gerendert werden.

Warnungen (Hinweis, Tipp, Wichtig, Achtung, Warnung)

Warnungen sind eine Markdown-Erweiterung zum Erstellen von Blockvorführungszeichen, die in Microsoft Learn mit Farben und Symbolen gerendert werden, die die Bedeutung des Inhalts angeben.

Vermeiden Sie Hinweise, Tipps und wichtige Felder. Leser neigen dazu, diese zu überspringen. Es ist besser, diese Informationen direkt in den Artikeltext zu integrieren.

Wenn Sie Warnungen verwenden müssen, beschränken Sie diese auf ein oder zwei pro Artikel. Mehrere Hinweise sollten in einem Artikel nie nebeneinander stehen.

Die folgenden Warnungstypen werden unterstützt:

> [!NOTE]
> Information the user should notice even if skimming.

> [!TIP]
> Optional information to help a user be more successful.

> [!IMPORTANT]
> Essential information required for user success.

> [!CAUTION]
> Negative potential consequences of an action.

> [!WARNING]
> Dangerous certain consequences of an action.

Diese Warnungen sehen in Microsoft Learn wie folgt aus:

Hinweis

Information the user should notice even if skimming.

Tipp

Optional information to help a user be more successful.

Wichtig

Essential information required for user success.

Achtung

Negative potential consequences of an action.

Warnung

Gefährliche Folgen einer Aktion.

Geschweifte Klammern

Wenn Sie in Ihrer Datei spitze Klammern im Text verwenden (z. B. zur Bezeichnung eines Platzhalters), müssen Sie die spitzen Klammern manuell codieren. Andernfalls interpretiert Markdown sie als HTML-Tag.

Codieren Sie <script name> z. B. als &lt;script name&gt; oder \<script name>.

Spitze Klammern müssen in Text, der als Inlinecode oder in Codeblöcken formatiert ist, nicht mit einem Escapezeichen versehen werden.

Apostrophe und Anführungszeichen

Wenn Sie aus Word in einen Markdowneditor kopieren, könnte der Text typografische Apostrophe oder Anführungszeichen enthalten. Diese müssen codiert oder in einfache Apostrophe und Anführungszeichen geändert werden. Andernfalls wird beim Veröffentlichen der Datei möglicherweise Folgendes ausgegeben: It’s.

Hier sind die Codierungen für die typografischen Versionen dieser Satzzeichen:

  • Linkes (öffnendes) Anführungszeichen: &#8220;
  • Rechtes (schließendes) Anführungszeichen: &#8221;
  • Rechtes (schließendes) einzelnes Anführungszeichen oder Apostroph: &#8217;
  • Linkes (öffnendes) einzelnes Anführungszeichen (selten verwendet): &#8216;

Tipp

Um "intelligente" Zeichen in Ihren Markdowndateien zu vermeiden, verwenden Sie das Feature zum Ersetzen intelligenter Anführungszeichen des Learn Authoring Pack. Weitere Informationen finden Sie unter Austausch typografischer Anführungszeichen.

Blockquotes

Blockzitate werden mit dem >-Zeichen generiert:

> This is a blockquote. It is usually rendered indented and with a different background color.

Das vorherige Beispiel wird wie folgt gerendert:

Dies ist ein Blockzitat. Es wird normalerweise eingerückt und mit einer anderen Hintergrundfarbe gerendert.

Fetter und kursiver Text

Um Text fett zu formatieren, schließen Sie ihn in vier Sternchen ein:

This text is **bold**.

Um Text kursiv zu formatieren, schließen Sie ihn in zwei Sternchen ein:

This text is *italic*.

Um Text fett und kursiv zu formatieren, schließen Sie ihn in sechs Sternchen ein:

This text is both ***bold and italic***.

Anleitungen zur Verwendung von fett und kursiv formatiertem Text finden Sie in den Richtlinien zum Formatieren von Text.

Codeausschnitte

Learn Markdown unterstützt die Platzierung von Codeausschnitten sowohl inline in einem Satz als auch als separater "eingegrenzten" Block zwischen Sätzen. Weitere Informationen finden Sie unter Hinzufügen von Code zu Dokumenten.

Spalten

Die Markdown-Erweiterung für Spalten bietet Autoren die Möglichkeit, spaltenbasierte Inhaltslayouts hinzuzufügen, die flexibler und leistungsfähiger sind als einfache Markdowntabellen, die nur für echte tabellarische Daten geeignet sind. Sie können bis zu vier Spalten hinzufügen und das optionale Attribut span verwenden, um zwei oder mehr Spalten zusammenzuführen.

Die Erweiterung columns funktioniert zwar weiterhin, es wird jedoch nicht mehr empfohlen, sie zum Erstellen benutzerdefinierter Layouts zu verwenden. Wir haben festgestellt, dass viele benutzerdefinierte Spaltenlayouts Barrierefreiheitsprobleme aufweisen oder anderweitig gegen die Stilrichtlinien verstoßen. Erstellen Sie keine benutzerdefinierten Layouts. Verwenden Von Microsoft Learn-Standardfeatures.

Die Syntax für Spalten sieht wie folgt aus:

:::row:::
   :::column span="":::
      Content...
   :::column-end:::
   :::column span="":::
      More content...
   :::column-end:::
:::row-end:::

Spalten sollten nur einfaches Markdown, einschließlich Bildern, enthalten. Überschriften, Tabellen, Registerkarten und andere komplexe Strukturen sollten nicht eingeschlossen werden. Eine Zeile darf keinen Inhalt außerhalb der Spalte enthalten.

Beispielsweise erstellt das folgende Markdown eine Spalte, die zwei Spaltenbreiten umfasst, sowie eine Standardspalte (ohne span):

:::row:::
   :::column span="2":::
      **This is a 2-span column with lots of text.**

      Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec vestibulum mollis nunc
      ornare commodo. Nullam ac metus imperdiet, rutrum justo vel, vulputate leo. Donec
      rutrum non eros eget consectetur.
   :::column-end:::
   :::column span="":::
      **This is a single-span column with an image in it.**

      ![Doc.U.Ment](media/markdown-reference/document.png)
   :::column-end:::
:::row-end:::

Dies wird wie folgt gerendert:

Spalte mit doppelter Spaltenbreite und viel Text

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec vestibulum mollis nunc ornare commodo. Nullam ac metus imperdiet, rutrum justo vel, vulputate leo. Donec rutrum non eros eget consectetur.

Spalte mit einfacher Spaltenbreite und einem Bild

Dok.U.Ment

Kommentare

Microsoft Learn unterstützt HTML-Kommentare, wenn Sie Abschnitte Ihres Artikels auskommentieren müssen:

<!--- Here's my comment --->

Warnung

Vermeiden Sie private oder vertrauliche Informationen in HTML-Kommentaren. Microsoft Learn überträgt HTML-Kommentare in den veröffentlichten HTML-Code, der veröffentlicht wird. HTML-Kommentare sind zwar für das Auge des Lesers unsichtbar, aber im zugrundeliegenden HTML-Code verfügbar.

Überschriften

Microsoft Learn unterstützt sechs Ebenen von Markdownüberschriften:

# This is a first level heading (H1)

## This is a second level heading (H2)

...

###### This is a sixth level heading (H6)
  • Zwischen dem letzten # und dem Überschriftentext muss ein Leerzeichen stehen.
  • Jede Markdowndatei darf lediglich eine H1-Überschrift aufweisen.
  • Die H1-Überschrift muss nach dem YML-Metadatenblock der erste Inhalt in der Datei sein.
  • H2-Überschriften werden automatisch rechts in einem Navigationsmenü der veröffentlichten Datei angezeigt. Überschriften auf niedrigeren Ebenen werden nicht angezeigt. Verwenden Sie H2s an sinnvollen Stellen, damit Leser gut durch Ihre Artikel navigieren können.
  • HTML-Überschriften, wie z. B. <h1>, werden nicht empfohlen und führen in einigen Fällen zu Buildwarnungen.
  • Über Lesezeichenlinks können Sie Links zu einzelnen Überschriften einer Datei einfügen.

HTML

Obwohl Markdown Inline-HTML unterstützt, wird HTML für die Veröffentlichung in Microsoft Learn nicht empfohlen, und mit Ausnahme einer eingeschränkten Liste von Werten werden Buildfehler oder Warnungen verursacht.

Bilder

Die folgenden Dateitypen werden standardmäßig für Bilder unterstützt:

  • .jpg
  • .png

Zur Unterstützung sonstiger Bildtypen wie „.gif“ müssen Sie diese in docfx.json als Ressourcen hinzufügen:

"resource": [
  {
    "files" : [
      "**/*.png",
      "**/*.jpg,
      "**/*.gif"
    ],

Standarddarstellung von Bildern (standardmäßiges Markdown)

Die grundlegende Markdownsyntax zum Einbetten eines Bilds sieht wie folgt aus:

![<alt text>](<folderPath>)

Example:
![alt text for image](../images/Introduction.png)

<alt text> ist eine kurze Beschreibung des Bilds, und <folder path> ist ein relativer Pfad zum Bild. Für visuell eingeschränkte Menschen ist Alternativtext erforderlich. Dieser Text ist zudem nützlich bei einem Seitenladefehler, durch den ein Bild nicht gerendert wird.

Unterstriche in Alternativtext werden nicht korrekt gerendert, es sei denn, Sie stellen ihnen einen umgekehrten Schrägstrich (\_) als Escapezeichen voran. Kopieren Sie jedoch keine Dateinamen zur Verwendung als Alternativtext. Schreiben Sie beispielsweise nicht Folgendes:

![ADextension_2FA_Configure_Step4](./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG)

Schreiben Sie stattdessen Folgendes:

![Active Directory extension for two-factor authentication, step 4: Configure](./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG)

Konzeptionelle Standardbilder (Learn Markdown)

Die benutzerdefinierte :::image::: Erweiterung in Microsoft Learn unterstützt Standardbilder, komplexe Bilder und Symbole.

Bei Standardbildern funktioniert die ältere Markdownsyntax weiterhin, doch wird die neue Erweiterung empfohlen, da sie leistungsfähigere Funktionen unterstützt, wie z. B. das Angeben eines Lokalisierungsbereichs, der sich vom übergeordneten Thema unterscheidet. Weitere erweiterte Funktionen, z. B. das Auswählen aus der Shared Image Gallery statt Angabe eines lokalen Bilds, werden in Zukunft verfügbar sein. Die neue Syntax sieht wie folgt aus:

:::image type="content" source="<folderPath>" alt-text="<alt text>":::

Wenn type="content" (Standard), sind sowohl source als auch alt-text erforderlich.

Komplexe Bilder mit langen Beschreibungen

Sie können diese Erweiterung auch zum Hinzufügen eines Bilds mit einer langen Beschreibung verwenden, die von Sprachausgaben gelesen, aber nicht visuell auf der veröffentlichten Seite gerendert wird. Lange Beschreibungen sind eine Anforderung hinsichtlich der Barrierefreiheit bei komplexen Bildern, z. B. Diagrammen. Die Syntax sieht wie folgt aus:

:::image type="complex" source="<folderPath>" alt-text="<alt text>":::
   <long description here>
:::image-end:::

Wenn type="complex", sind source, alt-text, eine lange Beschreibung und das :::image-end:::-Tag erforderlich.

Wenn Ihre Änderungen in der Vorschau angezeigt oder veröffentlicht werden, können Sie überprüfen, ob die lange Beschreibung vorhanden ist, indem Sie mit der rechten Maustaste auf das Bild klicken und Überprüfen auswählen (sofern Sie den Microsoft Edge-Browser, wobei andere Browser über ähnliche Features verfügen). Mit dieser Aktion gelangen Sie zur Bildquelle im HTML-Code, unter der Sie die Klasse visually-hidden finden. Erweitern Sie die Dropdownliste für diese Klasse. Die lange Beschreibung wird jetzt angezeigt:

Screenshot des HTML-Codes für ein Bild mit seiner langen Beschreibung.

Automatische Rahmen

Die Erweiterung :::image::: unterstützt auch die border-Eigenschaft, die automatisch einen grauen Rahmen von 1 Pixel um Ihr Bild hinzufügt. Die border-Eigenschaft ist standardmäßig true bei content- und complex-Bildern, sodass der Rahmen automatisch eingefügt wird, es sei denn, Sie fügen die Eigenschaft explizit mit dem Wert false hinzu. Die border-Eigenschaft ist standardmäßig false bei icon-Bildern.

Die border-Eigenschaft ist die empfohlene Vorgehensweise zum Hinzufügen eines Rahmens. Erstellen Sie ihre eigenen Rahmen nicht manuell.

Festlegen des Lokalisierungsbereichs

Manchmal unterscheidet sich der Lokalisierungsbereich eines Bilds von dem des Artikels oder Moduls, in dem es enthalten ist. Dies kann zu einer falschen globalen Darstellung führen, wenn z. B. der Screenshot eines Produkts versehentlich in eine Sprache lokalisiert wird, in der das Produkt nicht verfügbar ist. Um dies zu verhindern, können Sie das optionale loc-scope-Attribut in Bildern vom Typ content und complex angeben. Dies ist bei Screenshots erforderlich, die ein Produkt mit einem anderen Lokalisierungsbereich als dem des Artikels oder Moduls zeigen, in dem sie enthalten sind.

Symbole

Die Bilderweiterung unterstützt Symbole, bei denen es sich um dekorative Bilder handelt und die keinen Alternativtext aufweisen sollten. Die Syntax für Symbole sieht wie folgt aus:

:::image type="icon" source="<folderPath>":::

Wenn type="icon", muss source und nicht alt-text angegeben werden.

Die border-Eigenschaft ist bei Symbolen standardmäßig false. Wenn für Ihr dekoratives Bild der Standardbildrahmen erforderlich ist, fügen Sie border="true" explizit dem :::image:::-Tag hinzu.

Einbezogene Markdowndateien

Wenn Markdowndateien in mehreren Artikeln wiederholt werden müssen, können Sie eine Includedatei verwenden. Das Include-Feature weist Microsoft Learn an, den Verweis zur Buildzeit durch den Inhalt der Includedatei zu ersetzen. Sie können Einbeziehungen auf folgende Arten verwenden:

  • Inline: Verwenden Sie einen häufig verwendeten Textausschnitt inline innerhalb eines Satzes wieder.
  • Block: Verwenden Sie eine gesamte Markdowndatei als ein im Abschnitt eines Artikels geschachtelten Block wieder.

Inline- oder Blockincludedateien sind Markdowndateien (.md). Sie können jeglichen gültigen Markdowncode enthalten. Includedateien befinden sich normalerweise in einem allgemeinen Unterverzeichnis includes im Stammverzeichnis des Repositorys. Bei Veröffentlichung des Artikels wird die einbezogene Datei nahtlos integriert.

Einbeziehungssyntax

Blockeinbeziehungen befinden sich in einer eigenen Zeile:

[!INCLUDE [<title>](<filepath>)]

Inlineeinbeziehungen befinden sich innerhalb einer Zeile:

Text before [!INCLUDE [<title>](<filepath>)] and after.

Dabei ist <title> der Name der Datei, und <filepath> ist der relative Pfad zur Datei. INCLUDE muss groß geschrieben werden, und es muss ein Leerzeichen vor <title> vorhanden sein.

Die Anforderungen und Überlegungen zu Includedateien lauten wie folgt:

  • Verwenden Sie Blockeinbeziehungen für umfangreiche Inhaltsmengen, d.h. ein oder zwei Absätze, ein gemeinsames Verfahren oder ein gemeinsamer Abschnitt. Verwenden Sie sie nicht für Texte, die kürzer als ein Satz sind.
  • Includes werden in der gitHub-gerenderten Ansicht Ihres Artikels nicht gerendert, da sie von Microsoft Learn-Erweiterungen abhängig sind. Sie werden erst nach der Veröffentlichung gerendert.
  • Schreiben Sie sämtlichen Text in einer Includedatei als vollständige Sätze oder Ausdrücke, die vom vorhergehenden sowie nachfolgenden Text in dem Artikel, der auf die Einbeziehung verweist, unabhängig sind. Wenn Sie diese Vorgabe ignorieren, wird eine unübersetzbare Zeichenfolge im Artikel erstellt.
  • Betten Sie keine Includedateien in andere Includedateien ein.
  • /Includes-Ordner werden aus dem Build ausgeschlossen. Daher werden Bilder, die in /includes-Ordnern gespeichert sind und auf die in eingeschlossenen Dateien verwiesen wird, nicht in veröffentlichten Inhalten angezeigt. Speichern Sie Bilder in einem /media-Ordner, der sich nicht im /includes-Ordner befindet.
  • Geben Sie Medien wie reguläre Artikel nicht zur gemeinsamen Nutzung durch Includedateien frei. Verwenden Sie eine separate Datei mit einem eindeutigen Namen für jede Einbeziehung und jeden Artikel. Speichern Sie die Mediendatei in dem Medienordner, der der Einbeziehung zugeordnet ist.
  • Verwenden Sie eine Einbeziehung nicht als ausschließlichen Inhalt eines Artikels. Einbeziehungen sind als Ergänzung des übrigen Artikelinhalts gedacht.

Indentation

In Markdown bestimmen Leerzeichen vor dem ersten Zeichen einer Zeile die Ausrichtung der Zeile relativ zu den vorangehenden Zeilen. Der Einzug beeinflusst insbesondere Nummerierungs- und Aufzählungslisten, um mehrere Ebenen der Schachtelung in einem hierarchischen oder Gliederungsformat zu rendern.

Verwenden Sie Leerzeichen, um Text einzuziehen, der an einem vorherigen Absatz oder einem Element in einer Nummerierungs- oder Aufzählungsliste ausgerichtet wird.

Die folgenden beiden Beispiele zeigen, wie eingezogene Absätze basierend auf ihrer Beziehung zu anderen Absätzen gerendert werden.

1. This is a numbered list example (one space after the period before the letter T).
   This sentence is indented three spaces.
   This code block is indented three spaces.
   
- This is a bulleted list example (one space after the bullet before the letter T).
  This sentence is indented two spaces.
  > [!TIP]
  > This tip is indented two spaces.
  - This is a second-level bullet (indented two spaces, with one space after the bullet before the letter T).
    This sentence is indented four spaces.
    > This quote block is indented four spaces.

Das Beispiel oben wird wie folgt gerendert:

  1. Dies ist ein Beispiel für eine nummerierte Liste (ein Leerzeichen nach dem Punkt vor dem Buchstaben T).

    Dieser Satz wird um drei Leerzeichen eingezogen.

    This code block is indented three spaces.
    
  • Dies ist ein Beispiel für eine Liste mit Aufzählungszeichen (ein Leerzeichen nach dem Aufzählungszeichen vor dem Buchstaben T).

    Dieser Satz wird um zwei Leerzeichen eingezogen.

    Tipp

    Dieser Tipp wird um zwei Leerzeichen eingezogen.

    • Dies ist ein Aufzählungszeichen der zweiten Ebene (um zwei Leerzeichen eingezogen mit einem Leerzeichen nach dem Aufzählungszeichen vor dem Buchstaben T).

      Dieser Satz wird um vier Leerzeichen eingezogen.

      Dieses Blockzitat wird um vier Leerzeichen eingezogen.

Weitere Informationen zur Syntax von Links finden Sie unter Verwenden von Links in der Dokumentation.

Listen (Nummeriert, Aufzählungszeichen, Checkliste)

Nummerierte Liste

Zum Erstellen einer nummerierten Liste können Sie für alle Punkte Einsen verwenden. Die Zahlen werden bei der Veröffentlichung in aufsteigender Reihenfolge als sequenzielle Liste gerendert. Für eine bessere Lesbarkeit der Quelle können Sie Ihre Listen manuell inkrementieren.

Verwenden Sie keine Buchstaben für Listen, auch nicht für geschachtelte Listen. Sie werden bei der Veröffentlichung in Microsoft Learn nicht ordnungsgemäß gerendert. Geschachtelte nummerierte Listen werden mit Kleinbuchstaben gerendert, wenn sie veröffentlicht werden. Beispiel:

1. This is
1. a parent numbered list
   1. and this is
   1. a nested numbered list
1. (fin)

Dies wird wie folgt gerendert:

  1. This is
  2. a parent numbered list
    1. and this is
    2. a nested numbered list
  3. (fin)

Liste mit Aufzählungszeichen

Verwenden Sie für eine Liste mit Aufzählungszeichen - oder * gefolgt von einem Leerzeichen am Anfang jeder Zeile:

- This is
- a parent bulleted list
  - and this is
  - a nested bulleted list
- All done!

Dies wird wie folgt gerendert:

  • This is
  • a parent bulleted list
    • and this is
    • a nested bulleted list
  • All done!

Unabhängig davon, welche Syntax Sie verwenden (- oder *), verwenden Sie diese jeweils konsistent innerhalb eines Artikels.

Checkliste

Prüflisten sind für die Verwendung in Microsoft Learn über eine benutzerdefinierte Markdown-Erweiterung verfügbar:

> [!div class="checklist"]
> * List item 1
> * List item 2
> * List item 3

Dieses Beispiel wird auf Microsoft Learn wie folgt gerendert:

  • List item 1
  • List item 2
  • List item 3

Verwenden Sie Checklisten am Anfang oder Ende eines Artikels, um zusammenzufassen, was der Leser lernen wird bzw. gelernt hat. Fügen Sie keine sinnlosen Checklisten in der Mitte des Artikels ein.

Aktion „Nächste Schritte“

Sie können eine benutzerdefinierte Erweiterung verwenden, um microsoft Learn-Seiten eine Aktionsschaltfläche für den nächsten Schritt hinzuzufügen.

Die Syntax ist wie folgt:

> [!div class="nextstepaction"]
> [button text](link to topic)

Beispiel:

> [!div class="nextstepaction"]
> [Learn about adding code to articles](code-in-docs.md)

Dies wird wie folgt gerendert:

Sie können für nächste Schritte jede unterstützte Linkart verwenden, auch einen Markdownlink zu einer anderen Webseite. In den meisten Fällen ist der Link für die nächsten Schritte ein relativer Link zu einer anderen Datei im gleichen Docset.

Nicht lokalisierte Zeichenfolgen

Sie können die benutzerdefinierte Markdownerweiterung no-loc verwenden, um Inhaltszeichenfolgen anzugeben, die beim Lokalisierungsprozess ignoriert werden sollen.

Bei allen angegebenen Zeichenfolgen wird die Groß-/Kleinschreibung beachtet. Das heißt, die Zeichenfolge muss genau übereinstimmen, um bei der Lokalisierung ignoriert zu werden.

Verwenden Sie die folgende Syntax, um eine einzelne Zeichenfolge als nicht lokalisierbar zu markieren:

:::no-loc text="String":::

Im folgenden Beispiel wird nur die einzelne Instanz von Document während des Lokalisierungsprozesses ignoriert:

# Heading 1 of the Document

Markdown content within the :::no-loc text="Document":::.  The are multiple instances of Document, document, and documents.

Hinweis

Verwenden Sie \, um Sonderzeichen mit Escapezeichen zu versehen:

Lorem :::no-loc text="Find a \"Quotation\""::: Ipsum.

Sie können auch Metadaten im YAML-Header verwenden, um alle Instanzen einer Zeichenfolge innerhalb der aktuellen Markdowndatei als nicht lokalisierbar zu markieren:

author: cillroy
no-loc: [Global, Strings, to be, Ignored]

Hinweis

Die „no-loc“-Metadaten werden in der Datei docfx.json nicht als globale Metadaten unterstützt. Die Lokalisierungspipeline liest die Datei docfx.json nicht, sodass die „no-loc“-Metadaten in jeder einzelnen Quelldatei hinzugefügt werden müssen.

Im folgenden Beispiel werden sowohl in title der Metadaten als auch im Markdownheader das Wort Document während des Lokalisierungsprozesses ignoriert.

In description der Metadaten und im Markdownhauptinhalt wird das Wort document lokalisiert, da es nicht mit dem Großbuchstaben D beginnt.

---
title: Title of the Document
author: author-name
description: Description for the document
no-loc: [Title, Document]
---
# Heading 1 of the Document

Markdown content within the document.

Selektoren

Selektoren sind Elemente der Benutzeroberfläche, mit denen der Benutzer zwischen mehreren Varianten desselben Artikels wechseln kann. Sie werden in einigen Dokumentationen verwendet, um Unterschiede bei der Implementierung zwischen Technologien oder Plattformen zu beheben. Selektoren sind in der Regel besonders für unsere Inhalte für mobile Plattformen geeignet, die sich an Entwickler richten.

Da derselbe Markdownselektor in jeder Artikeldatei enthalten ist, die diesen Selektor verwendet, wird empfohlen, dass Sie den Selektor Ihres Artikels in einer Includedatei platzieren. Dann können Sie auf diese Includedatei in allen Artikeldateien, die denselben Selektor verwenden, verweisen.

Es gibt zwei Selektortypen: einen einfachen und einen Mehrfachselektor.

Einfache Auswahl

> [!div class="op_single_selector"]
> - [Universal Windows](../articles/notification-hubs-windows-store-dotnet-get-started/)
> - [Windows Phone](../articles/notification-hubs-windows-phone-get-started/)
> - [iOS](../articles/notification-hubs-ios-get-started/)
> - [Android](../articles/notification-hubs-android-get-started/)
> - [Kindle](../articles/notification-hubs-kindle-get-started/)
> - [Baidu](../articles/notification-hubs-baidu-get-started/)
> - [Xamarin.iOS](../articles/partner-xamarin-notification-hubs-ios-get-started/)
> - [Xamarin.Android](../articles/partner-xamarin-notification-hubs-android-get-started/)

Dieser Code wird wie folgt gerendert:

Mehrfachauswahl

> [!div class="op_multi_selector" title1="Platform" title2="Backend"]
> - [(iOS | .NET)](./mobile-services-dotnet-backend-ios-get-started-push.md)
> - [(iOS | JavaScript)](./mobile-services-javascript-backend-ios-get-started-push.md)
> - [(Windows universal C# | .NET)](./mobile-services-dotnet-backend-windows-universal-dotnet-get-started-push.md)
> - [(Windows universal C# | Javascript)](./mobile-services-javascript-backend-windows-universal-dotnet-get-started-push.md)
> - [(Windows Phone | .NET)](./mobile-services-dotnet-backend-windows-phone-get-started-push.md)
> - [(Windows Phone | Javascript)](./mobile-services-javascript-backend-windows-phone-get-started-push.md)
> - [(Android | .NET)](./mobile-services-dotnet-backend-android-get-started-push.md)
> - [(Android | Javascript)](./mobile-services-javascript-backend-android-get-started-push.md)
> - [(Xamarin iOS | Javascript)](./partner-xamarin-mobile-services-ios-get-started-push.md)
> - [(Xamarin Android | Javascript)](./partner-xamarin-mobile-services-android-get-started-push.md)

Dieser Code wird wie folgt gerendert:

Tiefgestellt und Hochgestellt

Sie sollten tief- und hochgestelle Zeichen nur verwenden, wenn dies aus Gründen der technischen Genauigkeit erforderlich ist, z. B. beim Schreiben mathematischer Formeln. Verwenden Sie diesen Zeichentyp nicht für nicht standardmäßige Stile, wie z. B. Fußnoten.

Verwenden Sie sowohl für tiefgestellte als auch hochgestellte Zeichen HTML:

Hello <sub>This is subscript!</sub>

Dies wird wie folgt gerendert:

Hello This is subscript!

Goodbye <sup>This is superscript!</sup>

Dies wird wie folgt gerendert:

Goodbye This is superscript!

Tabellen

Die einfachste Möglichkeit zum Erstellen einer Tabelle in Markdown ist die Verwendung von senkrechten Strichen und Unterstrichen. Fügen Sie unter der ersten Zeile Unterstriche ein, um eine Standardtabelle mit Kopfzeile zu erstellen:

|This is   |a simple   |table header|
|----------|-----------|------------|
|table     |data       |here        |
|it doesn't|actually   |have to line up nicely!|

Dies wird wie folgt gerendert:

This is a simple table header
Tisch data hier
it doesn't actually have to line up nicely!

Sie können die Spalten mithilfe von Doppelpunkten ausrichten:

| Fun                  | With                 | Tables          |
| :------------------- | -------------------: |:---------------:|
| left-aligned column  | right-aligned column | centered column |
| $100                 | $100                 | $100            |
| $10                  | $10                  | $10             |
| $1                   | $1                   | $1              |

Dieser Code wird folgendermaßen gerendert:

Fun With Tabellen
left-aligned column right-aligned column centered column
$100 $100 $100
10 USD 10 USD 10 USD
$1 $1 $1

Tipp

Die Learn Authoring-Erweiterung für VS Code erleichtert das Hinzufügen grundlegender Markdowntabellen!

Sie können auch den Tables Generator verwenden.

Zeilenumbrüche innerhalb von Wörtern in einer Tabellenzelle

Lange Wörter in einer Markdowntabelle können dazu führen, dass die Tabelle in den rechten Navigationsbereich hineinreicht und nicht mehr lesbar ist. Sie können dies lösen, indem Sie beim Rendern bei Bedarf automatisch Zeilenumbrüche in Wörter einfügen können. Dafür müssen Sie die Tabelle nur mit der benutzerdefinierten Klasse [!div class="mx-tdBreakAll"] umschließen.

Im Folgenden finden Sie ein Markdownbeispiel einer Tabelle mit drei Zeilen, die von einem div-Element mit dem Klassennamen mx-tdBreakAll umschlossen wird.

> [!div class="mx-tdBreakAll"]
> |Name|Syntax|Mandatory for silent installation?|Description|
> |-------------|----------|---------|---------|
> |Quiet|/quiet|Yes|Runs the installer, displaying no UI and no prompts.|
> |NoRestart|/norestart|No|Suppresses any attempts to restart. By default, the UI will prompt before restart.|
> |Help|/help|No|Provides help and quick reference. Displays the correct use of the setup command, including a list of all options and behaviors.|

Dieser Code wird wie folgt gerendert:

Name Syntax Erforderlich für die unbeaufsichtigte Installation? Beschreibung
Quiet /quiet Ja Runs the installer, displaying no UI and no prompts.
NoRestart /norestart No Unterdrückt alle Neustartversuche. Standardmäßig wird vor dem Neustart auf der Benutzeroberfläche eine Eingabeaufforderung angezeigt.
Hilfe /help Nein Stellt Hilfe und eine Kurzübersicht bereit. Displays the correct use of the setup command, including a list of all options and behaviors.

Zeilenumbrüche innerhalb von Wörtern in Tabellenzellen der zweiten Spalte

Möglicherweise möchten Sie, dass Zeilenumbrüche innerhalb von Wörtern nur in der zweiten Spalte einer Tabelle automatisch eingefügt werden. Um Zeilenumbrüche auf die zweite Spalte zu beschränken, wenden Sie die Klasse mx-tdCol2BreakAll wie oben gezeigt mithilfe der div-Wrappersyntax an.

Inkonsistente Spaltenbreiten zwischen Tabellen

Möglicherweise stellen Sie fest, dass die Spaltenbreiten der Tabellen in Ihren Artikeln uneinheitlich oder inkonsistent aussehen. Dieses Verhalten tritt auf, weil die Länge des Texts in den Zellen das Layout der Tabelle bestimmt. Leider gibt es keine Möglichkeit, das Rendern der Tabellen zu steuern. Dies ist eine Einschränkung von Markdown. Auch wenn Tabellenspalten mit konsistenter Breite besser aussehen, hat dies einige Nachteile:

  • Das Mischen von HTML-Code und Markdown macht Themen komplizierter und hält die Community von Beiträgen ab.
  • Eine Tabelle, die für eine bestimmte Bildschirmgröße gut geeignet ist, kann bei anderen Bildschirmgrößen unlesbar sein, da sie nicht dynamisch gerendert wird.

Datenmatrixtabellen

Eine Datenmatrixtabelle weist sowohl einen Header als auch eine gewichtete erste Spalte auf, sodass eine Matrix mit einer leeren Zelle in der oberen linken Ecke erstellt wird. Microsoft Learn verfügt über ein benutzerdefiniertes Markdown für Datenmatrixtabellen:

|                  |Header 1 |Header 2|
|------------------|---------|--------|
|**First column A**|Cell 1A  |Cell 2A |
|**First column B**|Cell 1B  |Cell 2B |

Das Beispiel wird wie folgt gerendert:

Kopfzeile 1 Kopfzeile 2
Erste Spalte A Zelle 1A Zelle 2A
Erste Spalte B Zelle 1B Zelle 2B

Jeder Eintrag in der ersten Spalte muss fett formatiert sein (**bold**); andernfalls sind die Tabellen nicht für Sprachausgaben zugänglich oder für Microsoft Learn gültig.

Tipp

Das Learn Authoring Pack für VS Code enthält eine Funktion zum Konvertieren einer regulären Markdowntabelle in eine Datenmatrixtabelle. Wählen Sie einfach die Tabelle aus, klicken Sie mit der rechten Maustaste darauf, und wählen Sie In Datenmatrixtabelle konvertieren aus.

HTML-Tabellen

HTML-Tabellen werden für Microsoft Learn nicht empfohlen. Sie können in der Quelle nicht von Menschen gelesen werden, was jedoch ein wichtiges Merkmal von Markdown ist.