Markdown-reference til dokumenter

Denne artikel indeholder en alfabetisk reference til skrivning af Markdown til docs.microsoft.com (dok.).

Markdown er et letvægts sprog med almindelige syntakser til tekstformatering. Dokumenter understøtter CommonMark -kompatible Markdown, der er fortolket via Markdig -parsing-programmet. Dokumenter understøtter også brugerdefinerede Markdown-udvidelser, der giver bedre indhold på webstedet dokumenter.

du kan bruge en vilkårlig teksteditor til at skrive Markdown, men vi anbefaler Visual Studio kode med dokumentets redigerings pakke. Dokumentets oprettelses pakke indeholder redigeringsværktøjer og visningsfunktioner, som du kan bruge til at se, hvordan dine artikler vil se ud, når de gengives på dokumenter.

Beskeder (Bemærk, Tip, Vigtigt, Forsigtigt, Advarsel)

Vigtige beskeder er en Markdown-udvidelse til oprettelse af blok tilbud, der gengives i dokumenter med farver og ikoner, der angiver betydningen af indholdet.

Undgå noter, tip og vigtige bokse. Læsere har tendens til at springe over dem. Det er bedre at sætte disse oplysninger direkte ind i artikel teksten.

Hvis du har brug for at bruge vigtige beskeder, kan du begrænse dem til en eller to pr. artikel. Der skal aldrig være flere noter ud for hinanden i en artikel.

Følgende beskedtyper understøttes:

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

Disse beskeder ser sådan ud på dokumenter:

Vinkelparenteser

Hvis du bruger vinkelparenteser i teksten i filen (f. eks. for at angive en pladsholder), skal du kode vinkelparenteserne manuelt. Ellers opfattes de som en del af en HTML-kode i Markdown.

Du kan f. eks. kode <script name> som <script name> eller \<script name> .

Vinkelparenteser behøver ikke at være Escape i tekst, der er formateret som indbygget kode eller i kodeblokke.

Apostroffer og anførselstegn

Hvis du kopierer fra Word til en Markdown-editor, indeholder teksten muligvis "smarte" (krøllede) apostroffer eller anførselstegn. Disse skal enten kodes eller ændres til grundlæggende apostroffer eller anførselstegn. Ellers kan du ende med indhold som dette, når filen udgives: It’s

Her er kodningerne for de "smarte" versioner af følgende tegnsætningstegn:

• Venstre anførselstegn (startanførselstegn): “
• Højre anførselstegn (slutanførselstegn): ”
• Højre enkelt anførselstegn eller apostrof (sluttegn): ’
• Venstre enkelt anførselstegn (starttegn) (bruges sjældent): ‘

Blokcitater

Blokcitater fremstilles ved hjælp af >-tegnet:

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

Det foregående eksempel gengiver følgende:

Dette er en blockquote. Det gengives normalt som indrykket og med en anden baggrundsfarve.

Fed og kursiv tekst

Hvis du vil formatere tekst som fed, skal du omslutte den med to stjerner:

This text is **bold**.

Hvis du vil formatere tekst som kursiv, skal du omslutte den med en enkelt stjerne:

This text is *italic*.

Hvis du vil formatere tekst både til fed og kursiv, skal du omslutte den med tre stjerner:

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

Du kan finde retningslinjer for, hvornår du skal bruge fed og kursiv tekst, i retningslinjer for tekstformatering.

Kodestykker

Dokumenter Markdown understøtter placeringen af kodestykker både indbygget i en sætning og som en separat "Hegns blok" mellem sætninger. Du kan finde flere oplysninger under Sådan føjes kode til dokumenter.

Kolonner

Markdown - udvidelsen giver dokument udviklere muligheden for at tilføje kolonne baseret indholdslayout, der er mere fleksible og effektive end Basic Markdown-tabeller, som kun er egnet til data i sand format. Du kan tilføje op til fire kolonner og bruge den valgfrie span attribut til at flette to eller flere kolonner.

Selvom udvidelse af kolonner stadig fungerer, anbefaler vi ikke længere, at du opretter brugerdefinerede layouts. Vi har registreret, at mange brugerdefinerede kolonnelayout har problemer med hjælp til handicappede eller på anden måde overtræder retningslinjer for dokumentation. Opret ikke brugerdefinerede layout. Brug standard dokumenterings funktioner.

Syntaksen for kolonner er følgende:

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

Kolonner bør kun indeholde Basic-Markdown, herunder billeder. Overskrifter, tabeller, faner og andre komplekse strukturer skal ikke medtages. En række kan ikke have indhold uden for kolonnen.

Følgende Markdown opretter f. eks. en kolonne, der spænder over to kolonnebredder og én standardkolonne (Nej 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:::

Dette gengives på følgende måde:

Kommentarer

Dokumenter understøtter HTML-kommentarer, hvis du skal kommentere afsnit i din artikel:

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

Overskrifter

Docs understøtter seks niveauer af Markdown-overskrifter:

# This is a first level heading (H1)

## This is a second level heading (H2)

...

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

• Der skal være et mellemrum mellem # og overskriftsteksten.
• Hver Markdown-fil skal have én og kun én H1-overskrift.
• H1-overskriften skal være det første indhold i filen efter metadata blokken YML.
• H2-overskrifter vises automatisk i menuen til højre navigering i den publicerede fil. Overskrifter på lavere niveauer vises ikke, så brug H2S strategisk til at hjælpe læsere med at navigere i dit indhold.
• HTML-overskrifter, f. eks. <h1> , anbefales ikke, og i nogle tilfælde vil det medføre, at der genereres advarsler.
• Du kan oprette forbindelse til enkelte overskrifter i en fil via bogmærke links.

HTML

Selvom Markdown understøtter indbygget HTML, anbefales det, at HTML ikke er at udgive til dokumenter, og med undtagelse af en begrænset liste over værdier kan der opstå Build-fejl eller-advarsler.

Billeder

Følgende filtyper understøttes som standard for billeder:

• .jpg
• .png

Hvis du vil understøtte andre billedtyper, f. eks .gif, skal du tilføje dem som ressourcer i docfx. JSON:

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

Grundlæggende standardbilleder (Markdown-standard)

Den grundlæggende Markdown-syntaks til integration af et billede er:

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

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

Hvor <alt text> er en kort beskrivelse af billedet, og <folder path> er en relativ sti til billedet. Der kræves alternativ tekst til skærmlæsere til synshandicappede. Det er også nyttigt, hvis der er en fejl på webstedet, hvor billedet ikke kan gengives.

Understregningstegn i alternativ tekst gengives ikke korrekt, medmindre du undgår dem ved at foranstille dem med en skråstreg \_ (). Kopiér dog ikke filnavne, der skal bruges som alternativ tekst. I stedet for f.eks.:

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

Skriv dette:

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

Grundlæggende standardbilleder (Docs Markdown)

Den brugerdefinerede :::image::: Docs-udvidelse understøtter standardbilleder, komplekse billeder og ikoner.

For standardbilleder fungerer den ældre Markdown-syntaks stadig, men den nye udvidelse anbefales, fordi den understøtter mere effektive funktioner, f.eks. angivelse af et lokaliseringsomfang, der ikke er det overordnede emne. Andre avancerede funktioner, f.eks. valg fra det delte billedgalleri i stedet for at angive et lokalt billede, vil være tilgængelige i fremtiden. Den nye syntaks er som følger:

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

Hvis type="content" (standard), både source og er alt-text påkrævet.

Komplekse billeder med lange beskrivelser

Du kan også bruge denne udvidelse til at tilføje et billede med en lang beskrivelse, der læses af skærmlæsere, men som ikke gengives visuelt på den publicerede side. Lange beskrivelser er et tilgængelighedskrav til komplekse billeder, f.eks. grafer. Syntaksen er følgende:

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

Hvis type="complex" , , , en lang beskrivelse og mærket er alle sourcealt-text:::image-end::: påkrævet.

Når dine ændringer er i prøveversion eller publiceret, kan du kontrollere, om den lange beskrivelse findes, ved at højreklikke på billedet og vælge Undersøg (når du bruger Microsoft Edge-browser, selvom andre browsere har lignende funktioner). Med denne handling kommer du til billedkilden i HTML-koden, hvorunder du kan finde en visuelt skjult klasse. Udvid rullemenuen for denne klasse, så finder du din lange beskrivelse:

Automatiske kanter

Udvidelsen :::image::: understøtter også egenskaben border , som automatisk tilføjer en grå kant på 1 pixel rundt om billedet. Egenskaben er som standard for billederne og , så du får automatisk kant, medmindre du udtrykkeligt border tilføjer egenskaben med værdien truecontentcomplexfalse . Egenskaben border er som standard til falseicon billeder.

Egenskaben border er den anbefalede måde at tilføje en kant på. Opret ikke dine egne kanter manuelt.

Angivelse af loc-scope

Nogle gange er lokaliseringsomfanget for et billede anderledes end det i artiklen eller modulet, der indeholder det. Dette kan medføre en dårlig global oplevelse: Hvis et skærmbillede af et produkt f.eks. ved et uheld lokaliseres til et sprog, som produktet ikke er tilgængeligt på. Du kan forhindre dette ved at angive den valgfri attribut i billeder af typer og og er påkrævet til skærmbilleder, der viser et produkt med et andet lokaliseringsomfang end den artikel eller det modul, der indeholder loc-scopecontentcomplex det.

Ikoner

Billedudvidelsen understøtter ikoner, der er dekorative billeder, og som ikke må have alternativ tekst. Syntaksen for ikoner er:

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

Hvis type="icon" , source skal angives, alt-text men ikke skal angives.

Egenskaben border er som standard for false ikoner. Hvis dit dekorative billede kræver standardbilledekanter, skal du føje border="true" det til :::image::: koden.

Inkluderede Markdown-filer

Hvis Markdown-filer skal gentages i flere artikler, kan du bruge en "include"-fil. Funktionen "include"-filer instruerer Docs i at erstatte referencen med indholdet af "include"-filen på build tidspunktet. Du kan bruge "includes" på følgende måder:

• Indbygget: Genbrug et almindeligt tekst kodestykke indbygget i en sætning.
• Element på blokniveau: Genbrug en hel Markdown-fil som et element på blokniveau indlejret i et afsnit i en artikel.

En "include"-fil med et indbygget gitter eller blokdiagram er en Markdown-fil (.md). Den kan indeholde enhver gyldig Markdown. "Include"-filer findes typisk i en fælles "include"-undermappe i roden af lageret. Når artiklen udgives, integreres "include"-filen automatisk i den.

Medtager syntaks

Inkludering af blokering findes på sin egen linje:

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

Indbygget "include"-er inden for en linje:

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

Hvor <title> er navnet på filen, og er den relative sti til <filepath> filen. INCLUDE skal stå med stort, og der skal være et mellemrum før <title> .

Her er nogle krav og overvejelser for "include"-filer:

• Brug "include"-filer på blokniveau til store mængder indhold – et eller to afsnit, en delt procedure eller et delt afsnit. Brug ikke "them" til mindre end en sætning.
• "Includes" gengives ikke i den GitHub-gengivet-visning af din artikel, fordi de er afhængige af Docs-udvidelser. De gengives først efter udgivelsestidspunktet.
• Skriv al tekst i en "include"-fil i komplette sætninger eller fraser, der ikke afhænger af forudgående eller følgende tekst i den artikel, som refererer til "include"-filen. Hvis denne vejledning ignoreres, oprettes der en streng i artiklen, der ikke kan oversættes.
• Medtag ikke "include"-filer i andre "include"-filer.
• /Includes Mapper er ekskluderet fra build. Billeder, der er gemt i mapper og /includes refereret til i inkluderede filer, vises derfor ikke i publiceret indhold. Store billeder i en /media mappe uden for /includes mappen.
• På samme måde som med almindelige artikler frarådes det at dele medier mellem "include"-filer. Brug en separat fil med et entydigt navn til hver "include"-fil og artikel. Gem mediefilen i en mediemappe, som ikke er knyttet til "include"-filen.
• Brug ikke en "include"-fil som det eneste indhold i en artikel. "Include"-filer er tiltænkt som supplement til det øvrige indhold i artiklen.

Indrykning

I Markdown bestemmer mellemrum før det første tegn på en linje linjens justering i forhold til de foregående linjer. Indrykningen påvirker især opstillinger med tal og punkttegn for at gengive flere niveauer af indlejring i et hierarkisk format eller konturformat.

Hvis du vil indrykke tekst for at justere efter et foranstående afsnit eller et element på en punktopstilling med tal eller punkttegn, skal du bruge mellemrum.

Følgende to eksempler viser, hvordan indrykkede afsnit gengives baseret på deres relation til andre afsnit.

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.

Ovenstående eksempel gengives som:

1. Dette er et eksempel på en nummereret liste (ét mellemrum efter perioden før bogstavet T).

   Denne sætning indrykkes med tre mellemrum.

   This code block is indented three spaces.
   

• Dette er et eksempel på en punktopstilling (ét mellemrum efter punkttegnet før bogstavet T).

  Denne sætning indrykkes to mellemrum.

  Tip

  Dette tip er indrykket to mellemrum.

  • Dette er et punkttegn på andet niveau (indrykket to mellemrum med ét mellemrum efter punkttegnet før bogstavet T).

    Denne sætning indrykkes med fire mellemrum.

    Denne anførselstegnsblok indrykkes fire mellemrum.

Links

Du kan finde oplysninger om syntaks for links under Brug links i dokumentation.

Lister (nummereret liste, punktopstilling, kontrolliste)

Nummereret liste

Hvis du vil oprette en nummereret liste, kan du bruge alle 1'er. Tallene gengives i stigende rækkefølge som en sekventiel liste, når de publiceres. Du kan forøge dine lister manuelt for at få øget kildelæsbarhed.

Brug ikke bogstaver på lister, herunder indlejrede lister. De gengives ikke korrekt, når de publiceres til Docs. På indlejrede lister, hvor der bruger tal, gengives disse som små bogstaver, når listen publiceres. Eksempel:

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

Dette gengives på følgende måde:

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

Punktopstilling

Hvis du vil oprette en punktopstilling, - skal du bruge eller efterfulgt af et mellemrum i begyndelsen af hver * linje:

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

Dette gengives på følgende måde:

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

Uanset hvilken syntaks du bruger, - eller , bruges den konsekvent i en * artikel.

Kontrolliste

Kontrollister er tilgængelige til brug på Docs via en brugerdefineret Markdown-udvidelse:

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

Dette eksempel gengives på Følgende måde i Docs:

Brug kontrollister i begyndelsen eller slutningen af en artikel for at opsummere indhold fra "Det lærer du" eller "Det har du lært". Tilføj ikke vilkårlige kontrollister i dine artikler.

Handling i næste trin

Du kan bruge en brugerdefineret udvidelse til at føje en knap til handlingen i næste trin til Docs-sider.

Syntaksen er følgende:

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

Eksempel:

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

Dette gengives på følgende måde:

Du kan bruge et hvilket som helst understøttet link i en handling i næste trin, herunder et Markdown-link til en anden webside. I de fleste tilfælde er linket til næste handling et relativt link til en anden fil i det samme dokumentsæt.

Ikke-lokaliserede strenge

Du kan bruge den no-loc brugerdefinerede Markdown-udvidelse til at identificere indholdsstrenge, som lokaliseringsprocessen skal ignorere.

Der vil være store og små bogstaver i alle strenge, der kommer frem. det vil sige, at strengen skal matche præcist for at blive ignoreret i forbindelse med lokalisering.

Hvis du vil markere en enkelt streng som ikke-lokaliserelig, skal du bruge denne syntaks:

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

I følgende eksempel ignoreres kun den enkelte forekomst Document af under lokaliseringsprocessen:

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

Du kan også bruge metadata i YAML-headeren til at markere alle forekomster af en streng i den aktuelle Markdown-fil som ikke-lokaliserelig:

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

I følgende eksempel ignoreres ordet både i metadataene og title i Document Markdown-headeren under lokaliseringsprocessen.

I metadataene description og Markdown-hovedindholdet document lokaliseres ordet, fordi det ikke starter med en kapital D .

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

Selektorer

Selektorer er elementer i brugergrænsefladen, som gør det muligt for brugeren at skifte mellem flere varianter af samme artikel. De bruges i nogle dokumentationssæt til at imødekomme implementeringsforskelle på tværs af teknologier eller platforme. Selektorer er typisk mest relevante for udviklere af indhold til vores mobilplatform.

Eftersom der anvendes den samme Markdown-selektor i alle de artikelfil, der bruger selektoren, anbefaler vi, at du placerer selektoren i en "include"-fil. Du kan derefter referere til "include"-filen i alle de artikelfiler, hvor der bruges den samme selektor.

Der findes to typer selektorer: en enkelt selektor og en multi-selektor.

Enkeltselektor

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

... gengives på følgende måde:

Multiselektor

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

... gengives på følgende måde:

Sænket og hævet skrift

Du bør kun bruge subscript eller superscript, når det er nødvendigt af tekniske hensyn, f.eks. når du skriver om matematiske formler. Brug dem ikke til typografier, der ikke er standard, f.eks. fodnoter.

Brug HTML til både subscript og superscript:

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

Dette gengives på følgende måde:

Hello _{This is subscript!}

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

Dette gengives på følgende måde:

Goodbye ^{This er megetscript!}

Tables

Den mest enkle måde at oprette en tabel på i Markdown er at bruge pipetegn og linjer. Hvis du vil oprette en standardtabel med en overskrift, skal den første linje efterfølges af en stiplet linje:

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

Dette gengives på følgende måde:

Du kan justere kolonnerne ved hjælp af kolon:

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

Dette gengives på følgende måde:

Linjeskift i ord i en vilkårlig tabelcelle

Lange ord i en Markdown-tabel kan gøre tabellen udvidet til højre navigation og blive ulæselig. Du kan løse problemet ved at gøre det muligt for gengivelse af dokumenter automatisk at indsætte linjeskift inden for ord, når det er nødvendigt. Ombryd blot tabellen med den brugerdefinerede klasse [!div class="mx-tdBreakAll"].

Her er et Markdown-eksempel på en tabel med tre rækker, der ombrydes af en div med klassenavnet 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.|

Den gengives på følgende måde:

Linjeskift i ord i anden kolonne i tabelceller

Det kan også være, at linjeskift automatisk indsættes i ord i den anden kolonne i en tabel. Hvis du vil begrænse pauser til den anden kolonne, skal du anvende klassen mx-tdCol2BreakAll ved hjælp af div wrapper syntaksen som vist tidligere.

Inkonsekvente kolonnebredder mellem tabeller

Du bemærker muligvis, at kolonnebredden i tabellerne i dine artikler ser ens ud eller er inkonsekvente. Denne funktionsmåde forekommer, fordi længden af teksten i cellerne bestemmer layoutet af tabellen. Det er desværre ikke muligt at styre, hvordan tabellerne gengives. Dette er en begrænsning i Markdown. Selvom det ville se ud, som om bredden af tabelkolonner er konsekvent, så vil det være en fordel for Nicer.

• Skærminterlacing af HTML-kode med Markdown gør emner mere komplicerede og fraråder community-bidrag.
• En tabel, som du får set, er velegnet til en bestemt skærmstørrelse, kan blive ved med at kunne se, at den ikke kan læses i forskellige skærmstørrelser, da den tilsidesætter gengivelses funktionen.

Data matrix tabeller

En data matrix tabel har både en overskrift og en vægtet første kolonne, der opretter en matrix med en tom celle øverst til venstre. Dokumenter indeholder brugerdefinerede Markdown for data matrix tabeller:

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

Eksemplet gengives som:

Alle indtastninger i den første kolonne skal formateres som fed ( **bold** ). ellers kan tabellerne ikke være tilgængelige for skærmlæsere eller til gyldige dokumenter.

HTML-tabeller

Det anbefales ikke at have HTML-tabeller til dokumenter. De er ikke humant læsbare i kilden, som er et nøgle princip for Markdown.