Använda Markdown i Azure DevOps

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

I den här artikeln beskrivs den grundläggande syntaxen för att använda Markdown-format (.md) med Azure DevOps-funktioner, inklusive Wiki-sidor. Med Markdown-syntax kan du lägga till särskild formatering i sidinnehållet, till exempel rubriker, listor, tabeller och bilder. Använd Markdown för att formatera README-filer, instrumentpaneler, innehållet i pull-begäranden och mer.

Det finns två formateringsalternativ: vanliga Markdown-konventioner och Markdown-tillägg för GitHub.

Stöd för Azure DevOps-funktioner

Med Markdown-syntaxen kan du formatera innehåll med rubriker, referenslänkar, fet text och bifogade filer. Alla Markdown-syntaxer fungerar inte med alla funktioner i Azure DevOps. Viktiga funktioner som stöder Markdown-syntax är:

• Kriterier för Definition of Done (tavla) för projektmilstolpar.
• Teammål och mått med Markdown-widgeten.
• Hämta begäranden för projektfiler på en Git-lagringsplats.
• README-filer i en Git-lagringsplats för att hjälpa deltagare.
• Wiki-filer för sidinnehåll i en gruppprojekt-wiki.

I följande lista visas vilka Markdown-element som varje funktion stöder och länkar till syntaxavsnitt i den här artikeln:

Headers

Strukturera ditt innehåll med hjälp av Markdown-huvuden. Sidhuvuden separerar långa delar av sidinnehållet i avsnitt som är lättare att läsa. Du kan lägga till rubriker i en definition av klar (tavla), Markdown-widgeten, pull-förfrågningar, README-filer och wiki-filer.

Om du vill definiera en rubrik på den översta nivån startar du en rad med ett enda hash-tecken # följt av rubriktexten, till exempel # Get started on the project. Organisera dina kommentarer med underrubriker genom att starta raden med fler än ett hash-tecken som ## Request permissions eller ### Send feedback. Du kan använda upp till sex hash-markeringar för att skapa storleksnivåer för rubriker.

Exempel: Skapa rubriker i Markdown

Följande Markdown skapar en rubrik på den översta nivån (H1) och fyra nivåer av underrubriker (H2, H3, H4 och H5):

# This is a top-level (H1) header
## This is a subheader (H2)
### This is a lower subheader (H3)
#### This is an H4 header
##### This is an H5 header

Följande bild visar den publicerade vyn av Markdown:

Stycken och radbrytningar

Dela upp långa avsnitt i mindre stycken eller infoga radbrytningar för att göra texten enklare att läsa.

Lägg till stycken och radbrytningar i ett definieringsdokument (tavla), Markdown-widgeten, pullförfrågningar, Readme-filer och wiki-filer.

Exempel: Lägga till pauser i Markdown och pull-begäranden

Kommentarer i en pull-begäran accepterar Markdown, till exempel fetstil och kursiv stil för text. Använd returnyckeln för att infoga en radbrytning för att starta ny text på nästa rad eller lägga till avstånd mellan rader.

Om du vill skapa en radbrytning i ett stycke i Azure DevOps lägger du till två blanksteg i slutet av raden innan du trycker på Retur:

This is the first line with two spaces at the end.  
This is the second line, which will appear directly below the first.

Detta återges som:

Det här är den första raden med två blanksteg i slutet.
Det här är den andra raden som visas direkt under den första.

Om du trycker på Retur utan två avslutande blanksteg kombineras raderna till ett enda stycke i de publicerade utdata.

Om du vill skapa ett nytt stycke (med en tom rad mellan) trycker du på Retur två gånger:

This is the first paragraph.

This is the second paragraph.

Följande bild visar den publicerade vyn av Markdown för avstånd i en pull-begärandekommentare:

Exempel: Lägga till pauser i Markdown-filer eller widgetar

I en Markdown-fil eller Markdown-widget separerar du textrader för att skapa nya stycken. Lägg till två blanksteg (Mellanslagstangenten) innan radbrytningen och tryck på Retur för att starta ett nytt stycke.

Add two **Space** characters before the end of the line and then press **Enter**.
The next paragraph starts on a new line. The two paragraphs are separated by a blank line.

Följande bild visar den publicerade vyn av Markdown för avstånd i en widget:

Blockera citattecken

Citat kommentarer eller text för att skapa kontext för din nya kommentar eller text. Den citerade texten är indragen från vänstermarginalen och har en lodrät linje längs det citerade avsnittet.

Du kan lägga till blockcitat i en definition av klar (tavla), Markdown-widgeten, pull-förfrågningar, README-filer och wiki-filer.

Om du vill citera en enskild textrad eller ett styckeblock infogar du en höger vinkelparentes > före den första texten.

Om du vill skapa ett kapslat citattecken infogar du två eller flera hakparenteser före texten. Det kapslade citatet är indraget längre från vänstermarginalen och har dubbla lodräta linjer längs det citerade avsnittet.

Exempel: Citattext med hakparenteser

> Insert a bracket ">" before the text to quote the line of text.

This text references the quoted sentence.

> To quote a paragraph, insert a bracket ">" before the first text. The other lines in the paragraph are also included in the block quote. Notice the entire paragraph is indented from the left margin and highlighted with a vertical line.

This text references the quoted paragraph.

>> Insert two or more brackets ">>" before the text to create a nested quote.

>>> Nested quotes can also be multiple lines of text. Notice the nested quote text is indented further from the left margin and a vertical line is drawn for each level of bracket you insert.

This text references the nested block quotes.

Följande bild visar den publicerade vyn av Markdown för citerad text:

Vågräta regler

Separera innehåll och sidavsnitt med vågräta linjer. Du kan lägga till avgränsare i en Definition of Done (tavla), Markdown-widgeten, pull requests, readme-filer och wiki-filer.

Om du vill lägga till en horisontell linje anger du en tom rad och sedan en annan rad med tre bindestreck. ---

Exempel: Infoga vågräta avgränsare

Följande Markdown skapar två vågräta regler:

Text **above** a horizontal rule
<!-- Blank -->
---
Text **between** horizontal rules
<!-- Blank -->
---
Text **under** a horizontal rule

Följande bild visar den publicerade vyn av Markdown för vågräta regler.

Betoning (fetstil, kursiv, genomstrykning)

Med Markdown kan du framhäva text på flera sätt:

Kombinera dessa formatmallar för att lägga till betoning. Du kan använda betoningsformat i en Definition of Done (tavla), Markdown-widget, pullrequester, Readme och wiki.

Exempel: Framhäv text

Här är några Markdown som visar hur du framhäver text med olika och kombinerade format:

**Italics** highlights text in a larger block like _new terminology_.

**Bold** (strong) adds presence to text, such as **Important!**

**Strikethrough** is useful for corrections like "Send feedback ~~to the team~~."

Combine styles for other effects, such as ~~__Content removed__~~ and **_Milestones_**.

Nästa bild visar hur Markdowns textbetoningsformat ser ut när de publiceras:

Kodmarkering

Markera textblock eller infogad text som kod med hjälp av kodmarkeringar. Du kan lägga till kodmarkering i pull-begäranden, Readme-filer och wiki-filer.

Om du vill formatera ett textblock som kod omger du blocket inom tre backtick-tecken (```). De backticks som inleder och avslutar avsnittet måste finnas på en separat rad från kodblocket för att framhäva.

Du kan också formatera en del av texten i ett större textblock som ett infogat kodsegment. För det här formatet omsluter du infogad kod i enskilda bakåtvända apostrofer. Backticks är infogade i texten och inte på separata rader.

Kodmarkering i Markdown-widgeten återger kod som vanlig föroformatterad text.

Exempel: Markera kodblock i Markdown-widget

Det här exemplet visar hur du markerar ett textblock som kod i Markdown-widgeten:

<!-- ```  Three backticks to start block " -->
sudo npm install vsoagent-installer -g
<!-- ```  Three backticks to end block -->

Det här exemplet visar den publicerade vyn av Markdown för ett textblock markerat som kod:

sudo npm install vsoagent-installer -g

Exempel: Markera infogad kod i Markdown-widgeten

Det här exemplet visar hur du markerar en del av texten som ett infogat kodsegment i Markdown-widgeten:

To install the Microsoft Cross Platform Build and Release Agent, run the following: <!-- ` - Single backtick --> $ sudo npm install vsoagent-installer -g <!-- ` - Single backtick -->

Den här bilden visar den publicerade vyn av Markdown för en del av texten markerad som ett infogat kodsegment:

Exempel: Konvertera text till kod, identifiera kodspråk

Det finns ett annat sätt att konvertera ett textblock till kod. När en textrad i Markdown börjar med fyra blanksteg i vänstermarginalen konverteras texten automatiskt till ett kodblock. Det här exemplet visar det här beteendet:

    This article is a Markdown file (_.md_). This line of text automatically formats as code because the line starts with four spaces in the left margin.

Den föredragna metoden är att omsluta texten inom tre backticks så att du kan ange språkidentifieraren. Identifieraren tillämpar syntaxmarkering på koden enligt konventionerna för det angivna språket. Identifieraretiketter är tillgängliga för de flesta programmeringsspråk, till exempel JavaScript (js), C# (csharp) och Markdown (md). Listan över språk som stöds finns i GitHub-lagringsplatsen highlightjs .

De här exemplen visar hur du identifierar ett textblock som JavaScript eller C#. Lägg till språkidentifieraretiketten efter de tre första bakåtvinklarna, som i ```md.

JavaScript

<!-- ```js       - Three backticks and identifier 'js' -->
const count = records.length;
<!-- ```         - Three backticks -->

Det här är den publicerade vyn av JavaScript-koden:

const count = records.length;

C#

<!-- ```csharp   - Three backticks and identifier 'csharp' -->
Console.WriteLine("Hello, World!");
<!-- ```         - Three backticks -->

Det här är den publicerade vyn av C#-koden:

Console.WriteLine("Hello, World!");

Föreslå ändring

GitHub-pull-begäranden stöder kommentarsfunktionen , som gör att deltagare kan ange indata och föreslå ändringar. Lägg till en kommentar för en specifik rad eller flera rader i en fil. Pull-begärandeförfattaren tillämpar den föreslagna ändringen i en kommentar genom att välja Tillämpa ändring. Den här åtgärden genomför ändringen av pull-begäran och startar en version.

När du lägger till en kommentar som innehåller kodmarkering i Markdown-widgeten visas koden i ett skillnadersformat. Ändringarna på den ändrade raden kommenteras för att visa skillnaderna. Minussymbolen - anger borttaget innehåll och plussymbolen + markerar nytt innehåll.

Exempel: Föreslå ändringar i en pull-begärandekommentare

Det här exemplet visar hur du föreslår kodändringar på en pull-begäran i Markdown-widgeten. I det här scenariot använder kodblocket identifieraren suggestion:

<!-- ```suggestion   - Three backticks and identifier 'suggestion' -->
  for i in range(A, B+100, C):
<!-- ```         - Three backticks -->

Följande bild visar skillnadsvyn med kommentarsförslaget.

Mer information finns i Föreslå ändringar i kommentarer.

Tables

Organisera strukturerade data med Markdown-tabeller. Lägg till tabeller i Markdown-widgeten, pull-begäranden, Readme-filer och wiki-filer. Tabeller är särskilt användbara för att beskriva funktionsparametrar, objektmetoder och andra data med en tydlig namn-till-beskrivning-mappning.

Här följer några punkter om hur du arbetar med tabeller i Markdown:

• Skapa varje rad på en separat rad och avsluta varje rad med en vagnretur (CR) eller radmatning (LF).
• Skapa kolumner med bindestreck - och pipe-symbolen |, till exempel |---|---|---|.
• Definiera kolumnrubrikerna på den första raden, till exempel | First | Middle | Last |.
• Ange kolumnjusteringen (vänster, mitten, höger) med hjälp av kolon : på den andra raden, till exempel |:--|:--:|--:|.
• Fly från pipetecknet med ett omvänt snedstreck \| när du använder det i tabelltext, som | Describe the pipe \| symbol. |
• Lägg till radbrytningar i en cell med hjälp av HTML-bryttaggen <br/>. Den här metoden fungerar i en wiki men inte någon annanstans.
• Lägg till ett mellanslag före och efter ett arbetsobjekt eller en pull-begäran som anges i tabelltext.

Exempel: Skapa en tabell

I följande exempel visas hur du skapar en tabell med tre kolumner och fem rader i Markdown:

| Feature | Prerelease | Release target |  
|:---|:---:|---:|
| Calculator | No | 10/27/2025 |
| Graphs | Yes | 8/18/2025 |
| Mail | No | 2/16/2025 |
| Tables | Yes | 10/27/2025 |
| Search | No | 1/5/2026 |

Så här ser Markdown-tabellen ut när den publiceras:

Lists

Ordna relaterade objekt med hjälp av olika typer av listor. Använd en ordnad lista för att visa ordningen eller sekvensen med objekt. Använd punktpunkter för relaterade objekt som inte behöver vara i ordning. Lägg till liststilar i en Definition of Done (tavla), Markdown-widgeten, pull-begäranden, Readme-filer och wiki-filer.

Här följer några punkter om hur du arbetar med listor i Markdown:

• Ange varje listobjekt på en separat rad.
• Starta varje objekt i en ordnad lista med ett tal följt av en punkt, till exempel 1. First item 1. Next item. Publiceringssystemet numrerar automatiskt listan.
• Starta varje objekt i en osorterad lista med ett bindestreck - eller en asterisk *, till exempel - First point - Next point.
• Kontrollera avståndet före och efter-listorna i en Markdown-fil eller widget:
  • För den första listan lägger du till en tom rad före och efter listan.
  • Använd rätt indrag för kapslade listor. Du behöver inte extra radbrytningar före eller efter kapslade listor.

Exempel: Skapa en numrerad (ordnad) lista

Det här exemplet visar hur du skapar en numrerad lista för objekt i en sekvens med markdown:

<!-- Blank -->
1. First step in the procedure.
1. Second step.
1. Third step.
<!-- Blank -->

Här är den publicerade vyn av den ordnade Markdown-listan:

1. Första steget i proceduren.
2. Andra steget.
3. Tredje steget.

Exempel: Skapa en punktlista (osorterad)

Det här exemplet visar hur du skapar en osorterad lista över relaterade objekt med markdown:

<!-- Blank -->
- First item in the list.
- Next item.
- Last item.
<!-- Blank -->

Här är den publicerade vyn av den osorterade Markdown-listan:

• Första objektet i listan.
• Nästa objekt.
• Sista objektet.

Exempel: Kapslade listor

Skapa listor i listor och blanda formatmallarna.

Det här exemplet visar hur du skapar en numrerad lista med kapslade punktlistor i Markdown:

<!-- Blank -->
1. First step in the procedure.
   - First item in a nested list.
   - Next item.
   - Last item.
1. Second step.
   - First item in a nested list.
      - First item in a subnested list.
      - Next item.
   - Last item.
1. Third step.
   1. First substep.
   1. Next substep.
   1. Last substep.
<!-- Blank -->

Här är den publicerade vyn av listan med kapslade listor:

1. Första steget i proceduren.
   • Första objektet i en kapslad lista.
   • Nästa objekt.
   • Sista objektet.
2. Andra steget.
   • Första objektet i en kapslad lista.
     • Första punkten i en underordnad lista.
     • Nästa objekt.
   • Sista objektet.
3. Tredje steget.
   1. Första understeget.
   2. Nästa understeg.
   3. Sista understeget.

Links

Länka till arbetsobjekt genom att ange hash-märket # följt av ett arbetsobjekts-ID och välj sedan arbetsobjektet i listan. Lägg till olika typer av länkar i en definition av klar (tavla), Markdown-widgeten, pull-begäranden, Readme-filer och wiki-filer.

Här följer några punkter om hur du arbetar med länkar i Markdown:

• Standardsyntaxen för Markdown för en länk är [Link display text](Link path).

• I pull-begärandekommenter och wikis formateras URL:er som börjar med HTTP eller HTTPS automatiskt som länkar.

• Om du använder hash-märket # på andra sätt, till exempel hexkoder för färg, kan du undvika automatiska förslag på arbetsobjekt genom att prefixa hash-märket # med ett omvänt snedstreck \.

• I Markdown-filer och widgetar skapar du textlänkar för en URL med hjälp av standardsyntaxen för Markdown-länkar. Link path Kan vara relativ eller absolut.

  I följande exempel visas hur du anger en relativ länk i Markdown. Texten återges som en hyperlänk:

  For more information, see the [C# language reference](/dotnet/csharp/language-reference/).
  

  Här är den publicerade vyn av länken:

  Mer information finns i C#-språkreferensen.

Länkar som stöds

När du länkar till en annan Markdown-sida på samma Git- eller Team Foundation Version Control-lagringsplats (TFVC) anger du länkmålet som en relativ eller absolut sökväg.

I följande avsnitt visas exempel på olika Markdown-scenarier.

Exempel: Relativa länkar för välkomstsidan

Här är några exempel på relativa länkar på välkomstsidan för en wiki:

• Relativ sökväg: [Display text](target.md)

• Absolut sökväg i Git: [Display text](/folder/target.md)

• Absolut sökväg i TFVC: [Display text]($/project/folder/target.md)

• URL: [Display text](http://address.com)

Exempel: Relativa länkar för Markdown-widget

I följande exempel visas en relativ länk i en Markdown-widget:

• URL: [Display text](http://address.com)

Exempel: Relativa länkar för Wiki-sidor

Här är några exempel på relativa länkar på en wiki-sida:

• Absolut sökväg för wiki-sidor: [Display text](/parent-page/child-page)
• URL: [Display text](http://address.com)

Relativa länkar för källkontroll

Relativa länkar till källkontrollfiler tolkas på olika sätt på en välkomstsida och en Markdown-widget:

Exempel: Relativa länkar för välkomstsidan

Relativa länkar på en välkomstsida är relativa till roten på källkontrolllagringsplatsen där välkomstsidan finns. Här följer några exempel:

• /BuildTemplates/AzureContinuousDeploy.11.xaml
• ./page-2.md

Exempel: Relativa länkar för Markdown-widget

Relativa länkar i en Markdown-widget är relativa till url-basen för gruppprojektsamlingen. Här följer några exempel:

• /DefaultCollection/Fabrikam/versionControl#path=$/TFVC-Welcome/BuildTemplates/AzureContinuousDeploy.11.xaml
• /DefaultCollection/Fabrikam/versionControl#path=$/TFVC-Welcome/page-2.md

Fästpunktslänkar

När en Markdown-fil återges som HTML tilldelar systemet ett fästpunkts-ID till varje sidhuvud på sidan. ID:t är en konverterad form av rubriktexten. Systemet tillämpar följande ändringar för att skapa ID:t:

• Ersätt blanksteg i rubriktexten med bindestreck -
• Ändra versaler till gemener
• Ignorera de flesta specialtecken, till exempel #, @, $
• Ignorera de flesta skiljetecken, till exempel :, ", ?

Använd hash-märket # för att länka till rubriken i dokumentet, som i [Display text](#<header-anchor>).

I följande exempel visas en rubrik och en länk till dess fästpunkts-ID:

#### Team #1 : Release Wiki!

Welcome to the Release wiki. For more information, [Visit the Project Wiki](#team-1--release-wiki).

Här är den publicerade vyn:

Team #1: Release Wiki!

Välkommen till release-wikin. Mer information finns i Project Wiki.

Länka till en rubrik i en annan Markdown-fil genom att ange filnamnet med fästpunkts-ID:t i länken:

[Set up a project wiki](about-readme-wiki.md#set-up-a-project-wiki).

En wiki-sida är också en Markdown-fil. Referera till en rubrik på en sida i wikin från en annan sida:

Welcome to the Wiki!

- [Get Started](/get-started-page)
- [Contribute content](/get-started-page#contribute)
- [Send Feedback](/contact-page#send-feedback)

Images

Använd bilder och animerade GIF-filer för att demonstrera begrepp och lägga till visuellt intresse för ditt innehåll. Lägg till bilder i Markdown-widgeten, pull-begäranden, Readme-filer och wiki-filer.

Använd markdown-standardsyntaxen för en bild eller animerad GIF: ![Image alt text](Image path). Den här syntaxen liknar en länk, men raden börjar med ett utropstecken ! .

Image alt text beskriver bilden och visas när användaren hovrar över bilden i den publicerade vyn. Image path identifierar avbildningsplatsen.

Här är ett exempel som lägger till en bild i en Markdown-fil:

![Illustration to use for new users](https://azurecomcdn.azureedge.net/cvt-779fa2985e70b1ef1c34d319b505f7b4417add09948df4c5b81db2a9bad966e5/images/page/services/devops/hero-images/index-hero.jpg)

Bildsökväg

Sökvägen till bildfilen kan vara en relativ sökväg eller en absolut sökväg i Git eller TFVC, precis som sökvägen till en annan Markdown-fil i en länk.

• Relativ sökväg: ![Image alt text](./image.png)
• Absolut sökväg i Git: ![Image alt text](/media/markdown-guidance/image.png)
• Absolut sökväg i TFVC: ![Image alt text]($/project/folder/media/markdown-guidance/image.png)

Bildstorlek

Ange bildstorleken med syntaxen Image-path =Image-widthxImage-height :

• Bokstaven x representerar "by" i uttrycket "width-by-height".
• Lägg inte till ett blanksteg före eller efter bokstaven x.
• Inkludera ett blanksteg före likhetstecknet = .
• Om du bara vill ange bredden använder du Image-path =Image-widthx. Du måste fortfarande inkludera bokstaven x.

Här är ett exempel på Markdown-syntax för en bild med en bredd på 500 och en höjd på 250:

![Image alt text](./image.png =500x250)

Checklista eller uppgiftslista

Spåra förloppet för dina tilldelningar och åtgärdsobjekt med enkla uppgiftslistor. Lägg till checklistor eller uppgiftslistor i pull-begäranden och wiki-filer. Den här funktionen är användbar i beskrivningen av pull-begäran för att spåra indata från granskare eller på en wiki-projektsida för att spåra uppgiftsstatus.

Exempel: Skapa checklista i Markdown

Skapa en checklista direkt i Markdown:

• Använd tomma hakparenteser [<space>] för att skapa en ny uppgift.
• Visa en uppgift som slutförd genom att inkludera bokstaven x inom hakparenteserna [x].
• Föregå varje aktivitet med ett bindestreck och blanksteg -<space>[<space>] eller ett tal och blanksteg 1.<space>[<space>]. Använd alla siffror.
• Använd inte en checklista i en Markdown-tabell.

I följande exempel skapas en checklista med fyra objekt, där det första objektet markeras som slutfört:

- [x] Project plan
- [ ] Draft 1 code
- [ ] Draft 2 code
- [ ] Test plan

Här är den publicerade vyn av checklistan:

När checklistan har publicerats markerar användarna ett objekt som slutfört genom att markera kryssrutan objekt i listan.

Exempel: Använd aktivitetslistan Markdown på markerad text

Välj befintlig text i webbportalen och använd åtgärder i Markdown-verktygsfältet för att tillämpa checklistformatet. När du har lagt till en checklista eller uppgift på det här sättet redigerar du listan eller aktiviteten i Markdown.

Följande bild visar hur du använder formatmallen Uppgiftslista i markdown-verktygsfältet för markerad text:

Markera en uppgift som slutförd genom att markera aktivitetsrutan i listan:

Emojireaktioner

Lägg till emojireaktioner i pull-begäranden och wiki-filer. Använd emojireaktioner för att lägga till tecken och reagera på kommentarer i begäran.

Ange namnet på en känsla eller ett uttryck som smile och omslut texten i kolontecken : . I den publicerade vyn av Markdown konverteras dina indata till motsvarande emojigrafik. Markdown i Azure DevOps har stöd för de flesta GitHub-emojigrafiker. Den stöder inte den anpassade emojin som :bowtie:.

Exempel: Lägga till emojireaktioner i en pull-begäran

Det här exemplet visar hur du lägger till reaktioner med emoji med Markdown i en kommentar till en pull-begäran.

The code review received :+1::+1: and the team is :smile:

Den här bilden visar den publicerade vyn över emojireaktionerna:

Exempel: Escape emoji syntax i Markdown

Det här exemplet visar hur du undflyr emojisyntax med tecknet för omvänt snedstreck \ i Markdown:

Markdown syntax for some emoji reactions:
- **Happy** \:smile:
- **Angry** \:angry:
- **Sad** \:cry:

Den här bilden visar den publicerade vyn av Markdown som visar emojisyntaxen:

I en kommentar till en pull-förfrågan använder du två omvänt snedstreck \\ för att undvika att emoji-syntaxen konverteras.

Specialtecken som literaltext

Använd omvänt snedstreck \ som ett escape-tecken i Markdown för att publicera specialtecken som literaltext. Backslash instruerar publiceringssystemet att visa specialtecknet som bokstavlig text och inte tolka eller konvertera det.

Använd ignore- och escape-syntax i en Definition of Done (board), Markdown-widgeten, pull-begäranden, README-filer och wiki-filer.

Exempel: Publicera specialtecken

Markdown-syntaxen "Omslut text i backticks" visas som Enclose text in backticks i den publicerade vyn. Publiceringssystemet tillämpar formatet på inline code texten i backticks (') och publicerar inte backticks.

Om du prefixar backtick (') med ett omvänt snedstreck (\), ändras inte textformatet i backticks och backticks publiceras. Det här beteendet fungerar för de flesta specialtecken, inklusive parenteser(), hakparenteser[], understreck_, bindestreck-, hashmarkering#, asterisk*, backtick `, och själva omvänt snedstreck\.

Följande Markdown använder backslash \ för att visa specialtecken som bokstavlig text.

\\\ Code comment

Show the **\_\_**underscores**\_\_**

\# Code comment and not a **Heading** 

**\(** Include the **parentheses \)**

Show the __\*__asterisks__\*__ and don't change to *italics*

Här är den publicerade vyn av Markdown:

\\ Kodkommentar

Visa __understreck__

# Kodkommentare och inte en rubrik

( Inkludera parenteserna )

* Visa asterisker* och ändra inte till kursiv stil

Attachments

Bifoga filer i kommentarer i pull-begäranden och på wiki-sidor. Bifogade filer kan illustrera din punkt eller ge information om dina förslag. Bifogade filer stöder följande filformat:

Bifoga bilder eller filer

Du kan bifoga en bild eller fil i en kommentarsruta för pull-begäran eller på en wiki-sida i fönstret Redigera på flera sätt:

• Dra en fil till kommentaren eller till wiki-sidan.

• Klistra in en bild från Urklipp i kommentaren eller på wiki-sidan. Bilden visas direkt i kommentaren eller på wiki-sidan.

• Välj ikonen Bifoga (gem) i kommentaren eller i fönstret Format på wiki-sidan och välj den fil som ska bifogas:

  

När du bifogar en icke-bildfil skapar systemet en länk till filen i en kommentar eller på en wiki-sida. Ändra länkvisningstexten inom hakparenteserna, som i [Updated link display text](LINK URL). När du publicerar sidan eller kommentaren väljer användaren länken för att komma åt den bifogade filen.

Matematisk notation och tecken

Du kan använda matematisk notation och tecken i kommentarer och wiki-filer för pull-begäranden. Både infogad och blockera KaTeX-notation stöds, vilket omfattar följande element:

• Symbols
• Grekiska bokstäver
• Matematiska operatorer
• Krafter och index
• Bråk och binomialer
• Andra KaTeX-element som stöds

I en Markdown-fil omges matematisk notation av dollartecken $ . Om du vill skapa ett uttryck infogat med annan text omger du notationen med enkla dollartecken, $ A + B = C $. För ett blockuttryck börjar och avslutar du blocket med två dollartecken, $$ A = 1 \ B = 2 \ C = A + B $$.

Exempel: Visa grekiska tecken

I följande exempel visas grekiska tecken som används i matematisk notation genom att lägga till ett kodfragment i Markdown-filen. Observera att språkidentifieraren för kodfragmentet är KaTeX och inte Markdown md:

$
\alpha, \beta, \gamma, \delta, \epsilon, \zeta, \eta, \theta, \kappa, \lambda, \mu, \nu, \omicron, \pi, \rho, \sigma, \tau, \upsilon, \phi, ...
$  

$\Gamma,  \Delta,  \Theta, \Lambda, \Xi, \Pi, \Sigma, \Upsilon, \Phi, \Psi, \Omega$

Här är den publicerade vyn över de grekiska tecknen:

Exempel: Använd algebraisk notation

I följande exempel används en infogad notation och ett algebraiskt blockuttryck:

Area of a circle is $\pi r^2$

And, the area of a triangle is:

$$
A_{triangle}=\frac{1}{2}({b}\cdot{h})
$$

Här är den publicerade vyn av notationen i Markdown-filen:

Exempel: Visa summor och integraler

I följande exempel används två blockuttryck för att beräkna summor och integraler:

$$
\sum_{i=1}^{10} t_i
$$

$$
\int_0^\infty \mathrm{e}^{-x}\,\mathrm{d}x
$$     

Här är den publicerade vyn av uttrycken i Markdown-filen:

Markdown i en Azure DevOps-wiki

Det finns många sätt att använda Markdown för att förbättra din Azure DevOps-wiki. Följande avsnitt innehåller syntaxexempel för olika uppgifter:

• Lägga till Mermaid-diagram som sekvenser, flödesscheman och användarflöden
• Skapa en innehållsförteckning (TOC) för sidor och undersidor
• Konfigurera komprimerbara sidavsnitt
• Bädda in videor och Azure Boards-frågeresultat
• Länka till arbetsobjekt med hash-märket #
• Använda @<alias> omnämnanden för användare och grupper
• Inkludera HTML-element som <font> för rik text
• Kontrollera antalet sidbesök

Tillgängligheten för dessa funktioner beror på din version av Azure DevOps.

::: mermaid
<diagram type>
   <diagam information>
:::

::: mermaid
sequenceDiagram
    Christie->>Josh: Hello Josh, how are you?
    Josh-->>Christie: Great!
    Christie->>Josh: See you later!
:::

::: mermaid
gantt
    title A Gantt chart
    dateFormat YYYY-MM-DD
    excludes 2022-03-16,2022-03-18,2022-03-19
    section Section

    A task          :a1, 2022-03-07, 7d
    Another task    :after a1 , 5d
:::

:::mermaid
graph LR;
    A[Hard edge] -->|Link text| B(Round edge) --> C{Decision}
    C -->|One| D[Result one]
    C -->|Two| E[Result two]
:::

:::mermaid
classDiagram
    Creature <|-- Superman
    Creature <|-- Vampire
    Creature <|-- Diavolo
    Creature: +int size
    Creature: +int weight
    Creature: +isBenign()
    Creature: +power()
    class Superman{
        +String currentName
        +fly()
        +heal()
    }
    class Vampire{
        -int age
        -canBite()
    }
    class Diavolo{
        +bool is_serving
        +heat()
    }
:::

:::mermaid
stateDiagram-v2
    [*] --> Active
    state Active {
        [*] --> NumLockOff
        NumLockOff --> NumLockOn : EvNumLockPressed
        NumLockOn --> NumLockOff : EvNumLockPressed
        --
        [*] --> CapsLockOff
        CapsLockOff --> CapsLockOn : EvCapsLockPressed
        CapsLockOn --> CapsLockOff : EvCapsLockPressed
        --
        [*] --> ScrollLockOff
        ScrollLockOff --> ScrollLockOn : EvScrollLockPressed
        ScrollLockOn --> ScrollLockOff : EvScrollLockPressed
    }
:::

:::mermaid
journey
    title Home office day
    section Go to work
      Wake up: 1: Me, Dog
      Take shower: 2: Me
      Go downstairs: 3: Me, Dog
      Make coffee: 4: Me
      Have a breakfast: 5: Me, Dog
      Go upstairs: 3: Me, Dog
      Do work: 1: Me, Dog
    section Go home
      Go downstairs: 3: Me, Dog
      Sit down: 5: Me
:::

:::mermaid
pie title Fishermen in countries
    "Norway" : 684
    "Sweeden" : 234
    "Switzerland" : 10
:::

:::mermaid
requirementDiagram
    requirement development_req {
    id: 1
    text: requirements spec.
    risk: medium
    verifymethod: test
    }
    element test_suite {
    type: manual test
    }
    test_suite - verifies -> development_req
:::

::: mermaid
gitGraph
  commit id: "Initial commit"
  branch develop
  commit id: "Develop commit 1"
  commit id: "Develop commit 2"
  checkout main
  commit id: "Main commit 1"
  merge develop id: "Merge develop into main"
  branch feature
  checkout feature
  commit id: "Feature commit 1"
  checkout develop
  commit id: "Develop commit 3"
  checkout feature
  merge develop id: "Merge develop into feature"
:::

::: mermaid
erDiagram
  CUSTOMER {
    string name
    string address
  }
  ORDER {
    int orderNumber
    string product
  }
  CUSTOMER ||--o{ ORDER : places
:::

::: mermaid
timeline
  title Project Development Timeline
  section Planning
    Project kickoff : 2025-01-01
    Requirements gathering : 2025-01-15
  section Development
    Initial development : 2025-02-01
    First prototype : 2025-03-01
  section Testing
    Alpha testing : 2025-04-01
    Beta testing : 2025-05-01
  section Release
    Public release : 2025-06-01
:::

# A collapsible section with Markdown syntax
<details>
  <summary>Click to expand!</summary>

  ## Heading
  1. A numbered
  2. list
     * With some
     * Sub bullets
</details>

Watch the following video:

::: video
<iframe width="640" height="360" src="https://www.youtube.com/embed/OtqFyBA6Dbk" allowfullscreen style="border:none"></iframe>
:::

Results from the Azure Boards query:

:::
query-table 6ff7777e-8ca5-4f04-a7f6-9e63737dddf7
:::

HTML-taggar på wiki-sidor

Skapa omfattande innehåll med hjälp av HTML-taggar på wiki-sidor, till exempel <font> och <span>. I Azure DevOps Server 2019.1 och senare kan du även klistra in omfattande innehåll som bilder och video som HTML.

Exempel: Använd Markdown-syntax i HTML

I följande exempel visas hur du använder Markdown-syntax i ett HTML-element på en wiki-sida. Lägg till en tom rad efter det inledande HTML-elementet och före Markdown:

<p>

This article describes how to **get started** with an Azure DevOps wiki.

For more information, see the [Wikis, search, & navigation documentation](https://free.blessedness.top/azure/devops/project/) for Azure DevOps.
</p>

Exempel: Bädda in en video med HTML

I följande exempel visas hur du bäddar in en video på en wiki-sida med hjälp <video> av HTML-elementet med en URL till videon:

<video src="https://sec.ch9.ms/ch9/7247/7c8ddc1a-348b-4ba9-ab61-51fded6e7247/vstswiki_high.mp4" width=400 controls>
</video>

Exempel: Använd RTF-format

I följande exempel visas hur du använder RTF-format för HTML på en wiki-sida:

<p>This text needs to <del>strikethrough</del> <ins>since it is redundant</ins>!</p>
<p><tt>This text is teletype text.</tt></p>
<font color="blue">Colored text</font>
<center>This text is center-aligned.</center>
<p>This text contains <sup>superscript</sup> text.</p>
<p>This text contains <sub>subscript</sub> text.</p>
<p>The project status is <span style="color:green;font-weight:bold">GREEN</span> even though the bug count / developer might be shown as <span style="color:red;font-weight:bold">red.</span> - Capability of span
<p><small>Disclaimer: Wiki also supports showing small text</small></p>
<p><big>Bigger text</big></p>

Följande bild visar den publicerade vyn av HTML-riktextinnehållet på en wiki-sida, som visas i standardvyn för ljust tema:

Här är samma publicerade sida i temavyn Mörk:

Relaterat innehåll

• Projektsida eller välkomstsidor
• Widgetkatalog
• Lägga till och redigera Wiki-sidor