Naslag voor Docs Markdown

Dit artikel bevat alfabetische naslag voor het schrijven van Markdown voor docs.microsoft.com (Docs).

Markdown is een lichtgewicht opmaaktaal met opmaaksyntaxis voor tekst zonder opmaak. Docs biedt ondersteuning voor Markdown die compatibel is met CommonMark en is geparseerd via de parseer-engine van Markdig. Docs ondersteunt ook aangepaste Markdown-extensies die uitgebreidere inhoud bieden op de Docs-site.

U kunt elke teksteditor gebruiken om Markdown te schrijven, maar we raden u Visual Studio code te gebruiken met het Docs Authoring Pack. Het Docs Authoring Pack biedt bewerkingsprogramma's en preview-functionaliteit waarmee u kunt zien hoe uw artikelen eruit zien wanneer deze worden weergegeven in Docs.

Waarschuwingen (Opmerking, Tip, Belangrijk, Let op, Waarschuwing)

Waarschuwingen zijn een Markdown-extensie voor het maken van blokcitaten die in Docs worden weergegeven met kleuren en pictogrammen die het belang van de inhoud aangeven.

Vermijd notities, tips en belangrijke vakken. Lezers slaan deze meestal over. Het is beter om die informatie rechtstreeks in de artikeltekst te zetten.

Als u waarschuwingen wilt gebruiken, beperkt u deze tot één of twee per artikel. In een artikel mogen nooit meerdere notities naast elkaar worden gemaakt.

De volgende typen waarschuwingen worden ondersteund:

> [!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.

Deze waarschuwingen zien er als volg uit in Docs:

Punthaken

Als u vierkante haken in tekst in uw bestand gebruikt (bijvoorbeeld om een tijdelijke aanduiding aan te geven), moet u de hoekhaken handmatig coderen. Anders zal Markdown deze aanzien voor HTML-code.

Codeer bijvoorbeeld <script name> als <script name> of \<script name> .

Hoekhaken hoeven niet te worden omkaderd in tekst die is opgemaakt als inlinecode of in codeblokken.

Apostroffen en aanhalingstekens

Als u tekst vanuit Word in een Markdown editor kopieert, bevat deze mogelijk gekrulde apostroffen of aanhalingstekens. Deze moeten worden gecodeerd of gewijzigd in rechte apostroffen of aanhalingstekens. Anders ziet de tekst er misschien zo uit wanneer u het bestand gaat publiceren: It’s

Hieronder vindt u de codering voor de gekrulde versies van deze leestekens:

• Linker dubbel aanhalingsteken (openen): “
• Rechter dubbel aanhalingsteken (sluiten): ”
• Rechter enkel aanhalingsteken of apostrof (sluiten): ’
• Linker enkel aanhalingsteken (openen) (wordt zelden gebruikt): ‘

Blockquotes

Blokcitaten worden gemaakt met het teken >:

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

Het voorbeeld hierboven wordt als volgt weergegeven:

Dit is een blockquote. Deze wordt meestal ingesprongen weergegeven en heeft een andere achtergrondkleur.

Vetgedrukte en cursieve tekst

Als u tekst wilt opmaken als vet,sluit u deze in twee sterretjes in:

This text is **bold**.

Als u tekst als italisch wilt opmaken,sluit u deze om in één sterretje:

This text is *italic*.

Als u tekst zowel vet als italisch wiltopmaken, sluit u deze om in drie sterretjes:

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

Zie richtlijnen voor tekstopmaak voor hulp bij het gebruik van vet en italisch tekst.

Codefragmenten

Docs Markdown ondersteunt de plaatsing van codefragmenten inline in een zin en als een afzonderlijk 'omheind' blok tussen zinnen. Zie Code toevoegen aan docs voor meer informatie.

Kolommen

De Markdown-extensie voor kolommen biedt Docs-auteurs de mogelijkheid om op kolommen gebaseerde inhoudsindelingen toe te voegen die flexibeler en krachtiger zijn dan eenvoudige Markdown-tabellen, die alleen geschikt zijn voor echte tabelgegevens. U kunt maximaal vier kolommen toevoegen en het optionele kenmerk gebruiken span om twee of meer kolommen samen te voegen.

Hoewel de kolommenextensie nog steeds werkt, wordt deze niet meer aanbevolen voor het maken van aangepaste indelingen. We hebben geconstateerd dat veel aangepaste kolomindelingen toegankelijkheidsproblemen hebben of anderszins richtlijnen voor docs-stijl schenden. Maak geen aangepaste indelingen. Standaard Docs-functies gebruiken.

De syntaxis voor kolommen is als volgt:

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

Kolommen mogen alleen eenvoudige Markdown bevatten, met inbegrip van afbeeldingen. Koppen, tabellen, tabbladen en andere complexe structuren mogen niet worden opgenomen. Een rij mag geen inhoud buiten de kolom hebben.

Met de volgende Markdown wordt bijvoorbeeld één kolom gemaakt die twee kolombreedten en één standaardkolom (geen span ) omvat:

:::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:::

Dit wordt weergegeven als:

Opmerkingen

Docs ondersteunt HTML-opmerkingen als u opmerkingen moet toevoegen aan secties van uw artikel:

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

Koppen

Docs ondersteunt zes niveaus Markdown-koppen:

# This is a first level heading (H1)

## This is a second level heading (H2)

...

###### This is a sixth level heading (H6)

• Tussen de laatste # en de koptekst moet een spatie staan.
• Elk Markdown-bestand moet één H1-kop hebben.
• De H1-kop moet de eerste inhoud in het bestand zijn na het YML-metagegevensblok.
• H2-koppen worden automatisch weergegeven in het navigatiemenu aan de rechterkant van het gepubliceerde bestand. Koppen op een lager niveau worden niet weergegeven, dus gebruik H2s strategisch om lezers te helpen door uw inhoud te navigeren.
• HTML-koppen, zoals , worden niet aanbevolen en veroorzaken in sommige gevallen <h1> buildwaarschuwingen.
• U kunt een koppeling maken naar afzonderlijke koppen in een bestand via bladwijzerkoppelingen.

HTML

Hoewel Markdown inline HTML ondersteunt, wordt HTML niet aanbevolen voor het publiceren naar Docs, en met uitzondering van een beperkte lijst met waarden worden build-fouten of -waarschuwingen veroorzaakt.

Installatiekopieën

De volgende bestandstypen worden standaard voor afbeeldingen ondersteund:

• .jpg
• .png

Ter ondersteuning van andere typen afbeeldingen, zoals .gif, moet u ze toevoegen als resources in docfx.json:

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

Standaard conceptuele afbeeldingen (standaard Markdown)

De basissyntaxis van Markdown voor het insluiten van een afbeelding is:

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

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

Hierbij is <alt text> een korte beschrijving van de afbeelding en <folder path> een relatief pad naar de afbeelding. Voor schermlezers voor visueel gehandicapten is alternatieve tekst nodig. Het is ook handig als er een sitebug is waarbij de afbeelding niet kan worden weergegeven.

Onderstrepingstekens in alternatieve tekst worden niet correct weergegeven, tenzij u ze vooraf laat gaan door een backslash () als voorvoegsel te \_ gebruiken. Kopieer echter geen bestandsnamen voor gebruik als alternatieve tekst. In plaats van dit bijvoorbeeld:

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

Schrijf dit:

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

Standaard conceptuele afbeeldingen (Docs Markdown)

De aangepaste :::image::: Docs-extensie ondersteunt standaardafbeeldingen, complexe afbeeldingen en pictogrammen.

Voor standaardafbeeldingen werkt de oudere Markdown-syntaxis nog steeds, maar de nieuwe extensie wordt aanbevolen omdat deze krachtigere functionaliteit ondersteunt, zoals het opgeven van een ander lokalisatiebereik dan het bovenliggende onderwerp. Andere geavanceerde functionaliteit, zoals het selecteren uit de galerie met gedeelde afbeeldingen in plaats van het opgeven van een lokale afbeelding, is in de toekomst beschikbaar. De nieuwe syntaxis is als volgt:

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

Als type="content" (de standaardinstelling), source zijn zowel als alt-text vereist.

Complexe afbeeldingen met lange beschrijvingen

U kunt deze extensie ook gebruiken om een afbeelding toe te voegen met een lange beschrijving die wordt gelezen door schermlezers, maar niet visueel wordt weergegeven op de gepubliceerde pagina. Lange beschrijvingen zijn een toegankelijkheidsvereiste voor complexe afbeeldingen, zoals grafieken. De syntaxis is als volgt:

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

Als type="complex" , , , een lange beschrijving en de tag zijn allemaal sourcealt-text:::image-end::: vereist.

Wanneer uw wijzigingen in preview of gepubliceerd zijn, kunt u controleren of de lange beschrijving bestaat door met de rechtermuisknop op de afbeelding te klikken en Inspecteren te selecteren (wanneer u Microsoft Edge-browser gebruikt, hoewel andere browsers vergelijkbare functies hebben). Met deze actie gaat u naar de afbeeldingsbron in de HTML-code, waaronder u een visueel verborgen klasse vindt. Vouw de vervolgkeuzecategorie voor deze klasse uit. Hier vindt u de lange beschrijving:

Automatische randen

De extensie ondersteunt ook de eigenschap , waarmee automatisch een grijze rand van :::image:::border 1 pixel rond uw afbeelding wordt toegevoegd. De eigenschap is standaard voor - en -afbeeldingen, dus u krijgt de rand automatisch, tenzij u de eigenschap expliciet toevoegt bordertrue met de waarde contentcomplexfalse . De border eigenschap is standaard voor falseicon afbeeldingen.

De border eigenschap is de aanbevolen manier om een rand toe te voegen. Maak niet handmatig uw eigen randen.

Loc-scope opgeven

Soms verschilt het lokalisatiebereik voor een afbeelding van dat van het artikel of de module die deze bevat. Dit kan leiden tot een slechte algemene ervaring: bijvoorbeeld als een schermopname van een product per ongeluk is gelokaliseerd in een taal waarin het product niet beschikbaar is. U kunt dit voorkomen door het optionele kenmerk op te geven in afbeeldingen van typen en . En is vereist voor schermopnamen waarin een product met een ander lokalisatiebereik wordt weer te geven dan het artikel of de module die het loc-scopecontentcomplex bevat.

Pictogrammen

De afbeeldingsextensie ondersteunt pictogrammen, die decoratieve afbeeldingen zijn en geen alternatieve tekst mogen bevatten. De syntaxis voor pictogrammen is:

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

Als type="icon" moet source worden opgegeven, maar alt-text niet.

De border eigenschap is standaard voor false pictogrammen. Als voor uw decoratieve afbeelding de standaardafbeeldingsrand is vereist, voegt u expliciet border="true" toe aan de tag :::image::: .

Opgenomen Markdown-bestanden

Als Markdown-bestanden in meerdere artikelen moeten worden herhaald, kunt u een insluitingsbestand gebruiken. De functie bevat instrueert Docs om de verwijzing te vervangen door de inhoud van het in te bouwen bestand. U kunt bevat op de volgende manieren gebruiken:

• Inline: Gebruik een algemeen tekstfragment inline met binnen een zin.
• Blok: een volledig Markdown-bestand als blok hergebruiken, genest in een sectie van een artikel.

Een inline- of blokopsluitingsbestand is een Markdown-bestand (.md). Deze kunnen elke geldige Markdown bevatten. Include-bestanden bevinden zich doorgaans in een algemene include-submap, in de hoofdmap van de opslagplaats. Als het artikel wordt gepubliceerd, wordt het ingesloten bestand vervolgens naadloos geïntegreerd.

Bevat syntaxis

Opnemen blokkeren staat op een eigen regel:

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

Inline opnemen valt binnen een regel:

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

Waarbij <title> de naam van het bestand is en het relatieve pad naar het bestand <filepath> is. INCLUDE moet een hoofdletter hebben en er moet een spatie zijn vóór <title> de .

Dit zijn de vereisten en overwegingen voor insluitingsbestanden:

• Gebruik blokinsluitingen voor aanzienlijke hoeveelheden inhoud: enkele alinea’s, een gedeelde procedure of een gedeelde sectie. Gebruik ze niet voor iets kleiners dan een zin.
• In- en uitingen worden niet weergegeven in GitHub weergave van uw artikel omdat ze afhankelijk zijn van Docs-extensies. Ze worden pas weergegeven na publicatie.
• Schrijf alle tekst in een include-bestand in volledige zinnen die niet afhankelijk zijn van voorafgaande of volgende tekst in het artikel dat verwijst naar de include. Als u deze richtlijnen negeert, wordt er een niet-tetaal tekenreeks in het artikel gemaakt.
• Sluit geen insluitbestanden in andere insluitbestanden in.
• /Includes mappen worden uitgesloten van build. Daarom worden afbeeldingen die zijn opgeslagen in mappen en waarnaar wordt verwezen in opgenomen bestanden, niet /includes weergegeven in gepubliceerde inhoud. Sla afbeeldingen op in /media een map buiten de map /includes .
• Net als bij gewone artikelen dient u geen media te delen tussen insluitingsbestanden. Gebruik een afzonderlijk bestand met een unieke naam voor elke insluiting en elk artikel. Sla het mediabestand op in de mediamap die is gekoppeld aan de insluiting.
• Zorg ervoor dat een artikel meer inhoud bevat dan alleen een insluiting. Insluitingen dienen als aanvulling op de inhoud in de rest van het artikel.

Inspringing

In Markdown bepalen spaties vóór het eerste teken van een regel de uitlijning van de regel ten opzichte van de voorgaande regels. Inspringing is met name van invloed op genummerde lijsten en lijsten met opsommingstekens om meerdere nestniveaus weer te geven in een hiërarchische indeling of omtrekindeling.

Als u tekst wilt inspringen om uit te lijnen met een voorgaande alinea of een item in een genummerde of lijst met opsommingstekens, gebruikt u spaties.

De volgende twee voorbeelden laten zien hoe ingesprongen alinea's worden weergegeven op basis van hun relatie met andere alinea's.

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.

Het bovenstaande voorbeeld wordt weergegeven als:

1. Dit is een voorbeeld van een genummerde lijst (één spatie na de periode vóór de letter T).

   Deze zin is drie spaties ingesprongen.

   This code block is indented three spaces.
   

• Dit is een voorbeeld van een lijst met opsommingstekens (één spatie achter de opsommingsteken vóór de letter T).

  Deze zin is ingesprongen in twee spaties.

  Tip

  Deze tip is ingesprongen in twee spaties.

  • Dit is een opsommingsteken op het tweede niveau (ingesprongen twee spaties, met één spatie achter de opsomming vóór de letter T).

    Deze zin is ingesprongen in vier spaties.

    Dit prijsopgaveblok is vier spaties ingesprongen.

Koppelingen

Zie Koppelingen gebruiken in de documentatie voor meer informatie over de syntaxis voor koppelingen.

Lijsten (Genummerd, Met opsommingstekens, Controlelijst)

Genummerde lijst

Als u een genummerde lijst wilt maken, kunt u alle enen gebruiken. De getallen worden in oplopende volgorde weergegeven als een sequentiële lijst wanneer ze worden gepubliceerd. Voor betere leesbaarheid van bronnen kunt u uw lijsten handmatig verhogen.

Gebruik geen letters in lijsten, inclusief geneste lijsten. Ze worden niet correct weergegeven wanneer ze naar Docs worden gepubliceerd. Geneste lijsten met cijfers worden weergegeven als kleine letters wanneer ze worden gepubliceerd. Bijvoorbeeld:

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

Dit wordt weergegeven als:

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

Lijst met opsommingstekens

Als u een lijst met opsommingstekens wilt maken, gebruikt u of gevolgd door een -* spatie aan het begin van elke regel:

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

Dit wordt weergegeven als:

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

Welke syntaxis u ook gebruikt, - of , gebruik deze consistent in een * artikel.

Controlelijst

Controlelijsten zijn beschikbaar voor gebruik in Docs via een aangepaste Markdown-extensie:

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

Dit voorbeeld wordt als het volgende weergegeven in Docs:

Gebruik controlelijsten aan het begin of eind van een artikel om inhoud voor 'Wat gaat u leren' of 'Wat hebt u geleerd' samen te vatten. Voeg geen willekeurige controlelijsten ergens anders in een artikel toe.

Actie volgende stap

U kunt een aangepaste extensie gebruiken om een actieknop voor de volgende stap toe te voegen aan Docs-pagina's.

De syntaxis is als volgt:

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

Bijvoorbeeld:

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

Dit wordt weergegeven als:

U kunt elke ondersteunde koppeling in een volgende stapactie gebruiken, met inbegrip van een Markdown-koppeling naar een andere webpagina. In de meeste gevallen is de volgende actiekoppeling een relatieve koppeling naar een ander bestand in dezelfde docset.

Niet-gelokaliseerde tekenreeksen

U kunt de aangepaste Markdown-extensie gebruiken om tekenreeksen met inhoud te identificeren die door het no-loc lokalisatieproces moeten worden genegeerd.

Alle tekenreeksen die worden genoemd, zijn casegevoelig; Dat wil zeggen dat de tekenreeks exact moet overeenkomen om te worden genegeerd voor lokalisatie.

Als u een afzonderlijke tekenreeks wilt markeren als niet-lokizeerbaar, gebruikt u deze syntaxis:

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

In het volgende voorbeeld wordt bijvoorbeeld slechts één exemplaar van genegeerd Document tijdens het lokalisatieproces:

# Heading 1 of the Document

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

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

U kunt ook metagegevens in de YAML-header gebruiken om alle exemplaren van een tekenreeks in het huidige Markdown-bestand als niet-lokaleerbaar te markeren:

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

In het volgende voorbeeld wordt zowel in de metagegevens als de Markdown-header het woord genegeerd titleDocument tijdens het lokalisatieproces.

In de description metagegevens en de hoofdinhoud van Markdown wordt het woord gelokaliseerd, omdat het document niet met een hoofdletter D begint.

---
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.

Selectors

Selectors zijn UI-elementen die de gebruiker kunnen laten schakelen tussen meerdere varianten van hetzelfde artikel. Ze worden in sommige documentensets gebruikt om de verschillen in implementatie tussen technologieën of platformen aan te pakken. Selectors zijn doorgaans het meest van toepassing op de inhoud van ons mobiele platform voor ontwikkelaars.

Omdat dezelfde selector Markdown in elk artikelbestand wordt geplaatst dat gebruikmaakt van de selector, raden we u aan de selector voor uw artikel in een insluitingsbestand te plaatsen. Vervolgens kunt u verwijzen naar dat include-bestand in al uw artikelbestanden die gebruikmaken van dezelfde selector.

Er zijn twee typen selectors: één selector en een meervoudige selector.

Single selector

> [!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/)

... wordt als volgt weergegeven:

Multi-selector

> [!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)

... wordt als volgt weergegeven:

Subscript en superscript

Gebruik alleen subscripts of superscripts wanneer dat nodig is voor technische nauwkeurigheid, zoals bij het schrijven over wiskundige formules. Gebruik deze niet voor niet-standaardstijlen, zoals voetnoots.

Gebruik HTML voor zowel subscript als superscript:

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

Dit wordt weergegeven als:

Hallo, _{dit is een subscript.}

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

Dit wordt weergegeven als:

Tot ^{ziens: dit is superscript!}

Tables

De eenvoudigste manier om een tabel in Markdown te maken is gebruik te maken van pipes en regels. Als u een standaardtabel met een kop wilt maken, laat u de eerste regel volgen door een stippellijn:

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

Dit wordt weergegeven als:

U kunt de kolommen uitlijnen met behulp van dubbele punten:

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

Wordt weergegeven als:

Regelbreaks binnen woorden in een tabelcel

Lange woorden in een Markdown-tabel kunnen ervoor zorgen dat de tabel naar rechts wordt uitgebreid en onleesbaar wordt. U kunt dit oplossen door docs-rendering toe te staan om automatisch regeluitbreken in woorden in te voegen wanneer dat nodig is. U laat eenvoudig de tabel teruglopen met de aangepaste klasse [!div class="mx-tdBreakAll"].

Hier ziet u een Markdown-voorbeeld van een tabel met drie rijen die teruglopen door gebruik te maken van een div met de klassenaam mx-tdBreakAll.

> [!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.|

Deze wordt als volgt weergegeven:

Regelbreaks binnen woorden in tabelcellen in de tweede kolom

Mogelijk wilt u dat regeluitbreekingen alleen in de tweede kolom van een tabel automatisch worden ingevoegd in woorden. Als u de onderbrekingen wilt beperken tot de tweede kolom, moet u de klasse toepassen met behulp van de mx-tdCol2BreakAlldiv wrapper-syntaxis, zoals eerder is weergegeven.

Inconsistente kolombreedten tussen tabellen

Mogelijk ziet u dat de kolombreedten van de tabellen in uw artikelen er oneven of inconsistent uitzien. Dit gedrag treedt op omdat de lengte van de tekst in de cellen de indeling van de tabel bepaalt. Helaas is er geen manier om te bepalen hoe de tabellen worden weergegeven. Dit is een beperking van Markdown. Hoewel het zou lijken alsof de breedte van tabelkolommen consistent zou zijn, zou dit ook enkele nadelen hebben:

• Door HTML-code te interveren met Markdown worden onderwerpen gecompliceerder en worden bijdragen van de community afgeraden.
• Een tabel die u ziet er goed uit voor een specifieke schermgrootte, ziet er mogelijk onleesbaar uit op verschillende schermgrootten, omdat responsieve rendering wordt voorkomen.

Gegevensmatrixtabellen

Een gegevensmatrixtabel heeft zowel een kop als een gewogen eerste kolom, waardoor een matrix met een lege cel linksboven wordt gemaakt. Docs heeft aangepaste Markdown voor gegevensmatrixtabellen:

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

Het voorbeeld wordt weergegeven als:

Elke vermelding in de eerste kolom moet vet zijn ( ); anders zijn de tabellen niet toegankelijk voor schermlezers of zijn ze geldig **bold** voor Docs.

HTML-tabellen

HTML-tabellen worden niet aanbevolen voor Docs. Ze kunnen niet door mensen worden gelezen in de bron. Dit is een belangrijk principe van Markdown.