Markdown használata az Azure DevOpsban

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

Important

Válassza ki a cikk platformjának és verziójának megfelelő verzióját. A verzióválasztó a tartalomjegyzék felett található. Keresse meg az Azure DevOps-platformot és -verziót.

Ez a cikk a Markdown (.md) formátum Azure DevOps-funkciókkal való használatának alapszintaxisát ismerteti, beleértve a wikilapokat is. A Markdown szintaxissal speciális formázást adhat a lap tartalmához, például címsorokat, listákat, táblázatokat és képeket. A Markdown használatával formázhatja a README-fájlokat, irányítópultokat, lekéréses kérelmek tartalmát stb.

Két formázási lehetőség érhető el: gyakori Markdown-konvenciók és Markdown-bővítmények a GitHubhoz.

Jótanács

Az AI használatával segíthet az Azure DevOps-feladatokban. Az első lépésekhez tekintse meg az Azure DevOps MCP Serverrel kapcsolatos AI-segítség engedélyezése című témakört.

Az Azure DevOps funkcióinak támogatása

A Markdown szintaxissal fejlécekkel, hivatkozásokkal, félkövér szöveggel és fájlmellékletekkel formázhatja a tartalmat. Nem minden Markdown-szintaxis működik az Azure DevOps minden funkciójával. A Markdown szintaxist támogató főbb funkciók a következők:

• A projekt mérföldköveihez tartozó Kész (tábla) definíciójának feltételei.
• Csapatcélok és metrikák a Markdown widgettel.
• Lekéréses kérelmek projektfájlokhoz egy Git-adattárban.
• README-fájlok a Git-adattárban a közreműködők segítségére.
• Wikifájlok laptartalmakhoz egy csapatprojekt wikijében.

Note

Az Azure DevOps Markdown nem támogatja a JavaScript- vagy iframe-eket. Például nem ágyazhat be interaktív elemeket, például visszaszámláló időzítőket.

Az alábbi lista bemutatja, hogy az egyes funkciók mely Markdown-elemeket támogatják, és melyek a jelen cikkben szereplő szintaxisszakaszokra mutató hivatkozások:

Markdown-típus	Done	Widget	PR	README	Wiki
Headers	✓	✓	✓	✓	✓
bekezdések és sortörések	✓	✓	✓	✓	✓
Idézőjelek blokkolása	✓	✓	✓	✓	✓
Vízszintes szabályok	✓	✓	✓	✓	✓
Emphasis	✓	✓	✓	✓	✓
Kódkiemelés			✓	✓	✓
Javaslat a módosításra			✓
Tables		✓	✓	✓	✓
Lists	✓	✓	✓	✓	✓
Links	✓	✓	✓	✓	✓
Images		✓	✓	✓	✓
ellenőrzőlista vagy feladatlista			✓		✓
Emojis			✓		✓
Markdown mellőzése vagy elkerülése	✓	✓	✓	✓	✓
Attachments			✓		✓
Matematikai jelölés			✓		✓

Headers

Tartalom strukturálása Markdown-fejlécek használatával. A fejezetek a laptartalom hosszú részeit könnyen olvasható szakaszokra bontják. Fejléceket a Kész (tábla) definícióban, a Markdown widgetben, a lekéréses kérelmekben, a Readme-fájlokban és a wikifájlokban adhat hozzá.

Felső szintű fejléc definiálásához kezdjen el egy sort egyetlen kivonatjellel # , majd a címsor szövegével, például # Get started on the project. A megjegyzéseket alfejlécekkel rendezheti úgy, hogy a sort egynél több hash jellel indítja el, például ## Request permissions vagy ### Send feedback. Legfeljebb hat kivonatjelet használhat a fejlécek méretszintjeinek létrehozásához.

Példa: Fejlécek létrehozása a Markdownban

A következő Markdown létrehoz egy felső szintű fejlécet (H1) és négy alfejlécszintet (H2, H3, H4 és 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

Az alábbi képen a Markdown közzétett nézete látható:

Bekezdések és sortörések

Important

Az Azure DevOps Markdown a többi Markdown-implementációtól eltérő módon kezeli a sortöréseket. Ha egy bekezdésen belül szeretne sortörést (helyreállítható visszatérést) létrehozni, az Enter billentyű lenyomása előtt adjon hozzá két szóközt a sor végéhez. Ha a két szóköz nélkül nyomja le az Enter billentyűt , a közzétett kimenet nem tartalmaz sortörést.

A hosszú szakaszokat kisebb bekezdésekre bonthatja, vagy sortöréseket szúrhat be, hogy könnyebben olvasható legyen a szöveg.

Bekezdések és sortörések hozzáadása a Kész (tábla) definícióhoz, a Markdown widgethez, a lekéréses kérelmekhez, a Readme-fájlokhoz és a wikifájlokhoz.

Példa: Törések hozzáadása a Markdownban és pull requestek

A pull request megjegyzései elfogadják a Markdownt, például a félkövér és dőlt stílust a szöveghez. Az Enter billentyűvel beszúrhat egy sortörést, hogy új szöveget kezdjen a következő sorban, vagy térközt adjon hozzá a sorok között.

Az Azure DevOpsban egy bekezdésen belüli sortörés létrehozásához adjon hozzá két szóközt a sor végéhez, mielőtt lenyomja az Enter billentyűt:

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

Ez a Markdown a következőképpen jelenik meg:

Ez az első sor két szóközzel a végén.
Ez a második sor, amely közvetlenül az első alatt jelenik meg.

Ha két záró szóköz nélkül nyomja le az Enter billentyűt , a sorok egyetlen bekezdésbe egyesülnek a közzétett kimenetben.

Új bekezdés létrehozásához (üres sor között) nyomja le kétszer az Enter billentyűt :

This is the first paragraph.

This is the second paragraph.

Az alábbi képen a Markdown közzétett nézete látható egy pull request megjegyzésben a térközök beállítására vonatkozóan.

Példa: Törések hozzáadása Markdown-fájlokban vagy widgetekben

Egy Markdown-fájlban vagy Markdown-vezérlőben külön szövegsorokat hozhat létre új bekezdések létrehozásához. Adjon hozzá két szóközt (szóközbillentyűt ) a sortörés előtt, és nyomja le az Enter billentyűt egy új bekezdés indításához.

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.

Az alábbi képen egy widgetben a térköz Markdown közzétett nézete látható.

Idézőjelek blokkolása

Idézz megjegyzéseket vagy szöveget, hogy megteremtsd az új megjegyzésed vagy szöveged kontextusát. Az idézett szöveg a bal margóról behúzva jelenik meg, az idézett szakasz mentén függőleges vonallal.

Blokk idézőjeleket adhat hozzá a Definition of Done (tábla)-ban, a Markdown widgetben, pull-kérelmekben, a Readme fájlokban és a wiki fájlokban.

Ha egyetlen szövegsort vagy bekezdésblokkot szeretne idézni, szúrjon be egy szögletes zárójelet > az első szöveg elé.

Beágyazott idézet létrehozásához szúrjon be két vagy több szögletes zárójelet a szöveg elé. A beágyazott idézőjel a bal margótól távolabb van behúzva dupla függőleges vonallal az idézett szakasz mentén.

Példa: Idézet készítése szögletes zárójelek használatával

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

Az alábbi képen az idézett szöveg Markdown-nézetének közzétett nézete látható:

Vízszintes szabályok

Tartalom és oldalszakaszok aláhúzása vagy elkülönítése vízszintes szabályokkal. Elválasztó elemeket adhat hozzá a Kész (tábla) definíciójában, a Markdown widgetben, a lekéréses kérelmekben, a Readme-fájlokban és a wikifájlokban.

Vízszintes szabály hozzáadásához írjon be egy üres sort, majd egy másik, három kötőjelet (kötőjelet) ---tartalmazó sort.

Példa: Vízszintes elválasztójelek beszúrása

A következő Markdown két vízszintes szabályt hoz létre:

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

Az alábbi képen a Markdown közzétett nézete látható a vízszintes szabályok esetében.

Kiemelés (félkövér, dőlt, áthúzott)

A Markdown több módon is lehetővé teszi a szöveg kiemelését:

Style	Example	Markdown
Italics	Dőlt szöveg	Szöveget csillag * vagy aláhúzásjel _ karakterbe ágyazza.
Félkövér (erős)	Félkövér szöveg	Helyezze szöveget dupla csillagok közé ** vagy aláhúzásjelek közé __.
Strikethrough	Áthúzott szöveg	Szöveg beágyazása dupla tildesbe ~~.

A stílusok kombinálásával kiemelést adhat hozzá. A kiemelési stílusokat használhatja a Kész (tábla) definícióban, a Markdown widgetben, a lekéréses kérelmekben, a Readme-fájlokban és a wikifájlokban.

Note

A Markdown nem rendelkezik a szöveg aláhúzására szolgáló szintaxissal. Egy wikilapon a HTML aláhúzási <u> elem használatával aláhúzhatja a szöveget.

Példa: Szöveg kiemelése

Íme néhány Markdown, amely bemutatja, hogyan hangsúlyozhatja a szöveget különböző és kombinált stílusok használatával:

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

A következő képen a Markdown szöveg kiemelési stílusai jelennek meg közzétételkor:

Kódkiemelés

Szövegblokkok vagy beágyazott szöveg kiemelése kódként a kódkiemelések használatával. A lekéréses kérelmekben, a Readme-fájlokban és a wikifájlokban kódot emelhet ki.

Ha kódként szeretne formázni egy szövegblokkot, zárja a blokkot három backtick (```) karakter közé. A szakaszt elindító és záró háttérsávoknak külön sorban kell lenniük a kódblokktól a kiemeléshez.

A nagyobb szövegterületen belüli szövegrészeket beágyazott kódszegmensként is formázhatja. Ehhez a stílushoz zárja be az inline kódot egyes backtickek közé. A fordított aposztrófok sorba illeszkednek a szöveggel, és nincsenek külön sorba helyezve.

A Markdown widgetben kiemelt kód egyszerű előre formázott szövegként jeleníti meg a kódot.

Példa: Kódblokk kiemelése a Markdown widgetben

Ez a példa bemutatja, hogyan emelhet ki egy szövegblokkot kódként a Markdown widgetben:

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

Ez a példa egy kódként kiemelt szövegblokk Markdown-nézetének közzétett nézetét mutatja be:

sudo npm install vsoagent-installer -g

Példa: Beágyazott kód kiemelése a Markdown widgetben

Ez a példa bemutatja, hogyan emelheti ki a szöveg egy részét beágyazott kódszegmensként a Markdown widgetben:

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

Ez a kép a Markdown közzétett nézetét jeleníti meg a szöveg egy részének beágyazott kódszegmensként kiemelve:

Példa: Szöveg átalakítása kódmá, kódnyelv azonosítása

Egy szövegblokkot egy másik módszerrel kódmá alakíthat. Amikor a Markdownban egy szövegsor négy szóközzel kezdődik a bal margón, a szöveg automatikusan kódblokkmá alakul. Ez a példa a következő viselkedést mutatja be:

    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.

Az előnyben részesített megközelítéssel a szöveget három háttérbe ágyazhatja, hogy meg tudja adni a nyelvi azonosítót. Az azonosító a megadott nyelv konvencióinak megfelelően a kódra emeli ki a szintaxist. Az azonosítócímkék a legtöbb programozási nyelvhez elérhetők, például JavaScript (js), C# (csharp) és Markdown (md). A támogatott nyelvek listáját a highlightjs GitHub-adattárban találja.

Ezek a példák bemutatják, hogyan azonosíthat egy szövegblokkot JavaScript vagy C# néven. Adja hozzá a nyelvi azonosító címkét az első három fordított aposztróf után, a következőképpen: ```md.

JavaScript

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

Ez a JavaScript-kód közzétett nézete:

const count = records.length;

C#

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

Ez a C#-kód közzétett nézete:

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

Javaslat a módosításra

A GitHub lekéréses kérelmei támogatják a Megjegyzés funkciót, amellyel a közreműködők bemenetet biztosítanak, és módosításokat javasolnak. Megjegyzés hozzáadása egy adott sorhoz vagy egy fájl több sorához. A lekéréses kérelem szerzője a Módosítás alkalmazása gombra kattintva alkalmazza a javasolt módosítást egy megjegyzésben. Ez a művelet véglegesíti a lekéréses kérelem módosítását, és elindít egy buildet.

Amikor a Markdown widgetben kódkiemelést tartalmazó megjegyzést ad hozzá, a kód különbségformátumban jelenik meg. A módosított sor módosításait a rendszer széljegyzetekkel jeleníti meg a különbségek megjelenítéséhez. A mínusz szimbólum - az eltávolított tartalmat jelzi, a pluszjel + pedig az új tartalmat emeli ki.

Példa: Módosítások ajánlása egy lekéréses kérelem megjegyzésében

Ez a példa bemutatja, hogyan javasolhat kódmódosításokat egy lekéréses kérelemre a Markdown widgetben. Ebben az esetben a kódblokk a következő azonosítót suggestionhasználja:

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

Az alábbi képen a megjegyzésjavaslat különbségnézete látható.

További információkért lásd: Javaslatok a megjegyzésekben történő módosításokra.

Tables

Strukturált adatok rendszerezése Markdown-táblák használatával. Táblák hozzáadása a Markdown widgethez, a lekéréses kérelmekhez, a Readme-fájlokhoz és a wikifájlokhoz. A táblák különösen hasznosak a függvényparaméterek, az objektummetódusok és az egyéb adatok egyértelmű név-leírás leképezésével történő leírásához.

Íme néhány pont a táblák Markdownban való használatával kapcsolatban:

• Létrehozzon minden sort külön sorban, és az egyes sorokat zárja le kocsivisszával (CR) vagy soros visszatérítéssel (LF).
• Oszlopok létrehozása kötőjelekkel - és a csőszimbólummal |( például |---|---|---|.
• Adja meg az első sor oszlopfejléceit, például | First | Middle | Last |.
• Állítsa be az oszlop igazítását (balra, középre, jobbra) a második sorban lévő kettőspontokkal : , például |:--|:--:|--:|.
• A pipe szimbólumot a visszaperrel kell megjelölni \|, amikor táblázatszövegben, például | Describe the pipe \| symbol. | használja.
• Sortörések hozzáadása egy cellában a HTML-töréscímkével <br/>. Ez a megközelítés wikiben működik, máshol azonban nem.
• Adjon hozzá üres szóközt egy munkaelem vagy lekéréses kérelem előtt és után, amelyet a táblázat szövege említ.

Példa: Tábla létrehozása

Az alábbi példa bemutatja, hogyan hozhat létre három oszlopból és öt sorból álló táblát a Markdownban:

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

A Markdown-tábla így néz ki a közzétételkor:

Feature	Prerelease	Kiadási cél
Calculator	No	10/27/2025
Graphs	Yes	8/18/2025
Mail	No	2/16/2025
Tables	Yes	10/27/2025
Kereső	No	1/5/2026

Lists

A kapcsolódó elemek rendszerezése különböző típusú listák használatával. Rendezett lista használatával megjelenítheti az elemek sorrendjét. Olyan kapcsolódó elemekhez használjon listajeleket, amelyeknek nem kell sorrendben lenniük. Listastílusok hozzáadása a Kész (tábla) definícióhoz, a Markdown-vezérlőhez, a lekéréses kérelmekhez, a Readme-fájlokhoz és a wikifájlokhoz.

Íme néhány pont a listák Markdownban való használatával kapcsolatban:

• Adja meg az egyes listaelemeket egy külön sorban.
• A rendezett listában minden elemet egy számmal, majd egy ponttal kell kezdeni, például 1. First item 1. Next item. a közzétételi rendszer automatikusan számozza a listát.
• Kezdje el az egyes elemeket rendezetlen listában egy kötőjellel - vagy csillaggal *, például - First point - Next point.
• Ellenőrizze a lista előtti és utáni térközt egy Markdown-fájlban vagy widgetben:
  • Az első listához adjon hozzá egy üres sort a lista előtt és után.
  • Beágyazott listák esetén használja a megfelelő behúzást. Nincs szükség további sortörésekre a beágyazott listák előtt vagy után.

Példa: Számozott (rendezett) lista létrehozása

Ez a példa bemutatja, hogyan hozhat létre számozott listát a sorozat elemeihez a Markdown használatával:

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

A Markdown sorszámozott listájának megjelenítése:

1. Az eljárás első lépése.
2. Második lépés.
3. Harmadik lépés.

Példa: Felsorolásos (rendezetlen) lista létrehozása

Ez a példa bemutatja, hogyan hozhat létre rendezetlen listát a kapcsolódó elemekről a Markdown használatával:

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

A Markdown rendezetlen listájának közzétett nézete:

• A lista első eleme.
• Következő elem.
• Utolsó elem.

Példa: Beágyazott listák

Listákat hozhat létre a listákban, és keveri a stílusokat.

Ez a példa bemutatja, hogyan hozhat létre számozott listát beágyazott listajeles listákkal a Markdownban:

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

A lista közzétett nézete beágyazott listákkal:

1. Az eljárás első lépése.
   • Beágyazott lista első eleme.
   • Következő elem.
   • Utolsó elem.
2. Második lépés.
   • Beágyazott lista első eleme.
     • Az albeágyazott lista első eleme.
     • Következő elem.
   • Utolsó elem.
3. Harmadik lépés.
   1. Első al-lépés.
   2. Következő részsztep.
   3. Utolsó részsztep.

Links

A munkaelemekre mutató hivatkozáshoz írja be a kivonatjelet # , majd egy munkaelem-azonosítót, majd jelölje ki a munkaelemet a listából. Adjon hozzá különböző típusú hivatkozásokat a Kész (tábla) definíciójában, a Markdown widgetben, a lekéréses kérelmekben, a Readme-fájlokban és a wikifájlokban.

Íme néhány pont a Markdown hivatkozásaival kapcsolatos tudnivalókról:

• A hivatkozások szokásos Markdown-szintaxisa.[Link display text](Link path)

• A lekéréses kérelmek megjegyzéseiben és wikiiben a HTTP-vel vagy HTTPS-lel kezdődő URL-címek automatikusan hivatkozásként formázódnak.

• Ha más módon használja a hash jelet #, például szín hexakódokban, akkor a hash jelet # előzze meg egy fordított perjellel \, hogy elkerülje a munkaelemekre vonatkozó automatikus javaslatokat.

• Markdown-fájlokban és widgetekben hozzon létre szöveges hivatkozásokat egy URL-címhez a Szokásos Markdown-hivatkozás szintaxisával. Lehet Link path relatív vagy abszolút.

  Az alábbi példa bemutatja, hogyan adhat meg relatív hivatkozást a Markdownban. A szöveg hivatkozásként jelenik meg:

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

  A hivatkozás közzétett nézete:

  További információkért tekintse meg a C# nyelvi referenciát.

Támogatott hivatkozások

Ha ugyanabban a Git- vagy Team Foundation-verziókövetési (TFVC) adattárban egy másik Markdown-lapra hivatkozik, relatív vagy abszolút elérési útként adja meg a hivatkozáscélt.

Note

Biztonsági okokból nem használhat fájlmegosztásokon (file://...) tárolt dokumentumokra mutató hivatkozásokat.

Az alábbi szakaszok különböző Markdown-forgatókönyvekre mutatnak be példákat.

Példa: Üdvözlőoldal relatív hivatkozásai

Íme néhány példa a wiki kezdőlapján található relatív hivatkozásokra:

• Relatív elérési út: [Display text](target.md)

• Abszolút elérési út a Gitben: [Display text](/folder/target.md)

• Abszolút elérési út a TFVC-ben: [Display text]($/project/folder/target.md)

• URL-cím: [Display text](http://address.com)

Példa: Markdown widget relatív hivatkozások

Az alábbi példa egy relatív hivatkozást mutat egy Markdown-vezérlőben:

• URL-cím: [Display text](http://address.com)

Példa: Wikilapok relatív hivatkozásai

Íme néhány példa egy wikilap relatív hivatkozásaira:

• A wikilapok abszolút elérési útja: [Display text](/parent-page/child-page)
• URL-cím: [Display text](http://address.com)

Forrásvezérlő relatív hivatkozásai

Az üdvözlőlap és a Markdown-vezérlő eltérően értelmezi a forrásvezérlő fájlokra mutató relatív hivatkozásokat:

Példa: Üdvözlőoldal relatív hivatkozásai

Az üdvözlőoldalak relatív hivatkozásai annak a forrásvezérlő-tárháznak a gyökeréhez vannak viszonyítva, ahol az üdvözlőlap létezik. Íme néhány példa:

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

Példa: Markdown widget relatív hivatkozások

A Markdown widgetben a relatív hivatkozások a csapatprojekt-gyűjtemény URL-alapjához viszonyítva értendők. Íme néhány példa:

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

Horgonyhivatkozások

Amikor egy Markdown-fájl HTML-ként jelenik meg, a rendszer egy horgonyazonosítót rendel a lap minden fejlécéhez. Az azonosító a fejlécszöveg konvertált formája. A rendszer a következő módosításokat alkalmazza az azonosító létrehozásához:

• Cserélje le a fejléc szöveg szóközeit kötőjelekre -.
• Módosítsa a nagybetűket kisbetűsre.
• A legtöbb speciális karaktert és írásjelet kötőjelekké alakíthatja, beleértve a :, ", ?, @, #' karaktereket.
• Távolítsa el vagy konvertálja az egyéb speciális karaktereket a renderelő motor szabályainak megfelelően.

Használja a kivonatjelet # a dokumentum fejlécére mutató hivatkozáshoz, ahogyan az a dokumentumban is szerepel [Display text](#<header-anchor>).

Az alábbi példa egy címsort és a horgonyazonosítójára mutató hivatkozást mutat be:

#### Team #1 : Release Wiki!

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

A közzétett nézet a következő:

1. csapat: Wiki kiadása!

Üdvözöljük a Release wikiben. További információ : Project Wiki.

Jótanács

A fejléc pontos horgonyazonosítójának meghatározásához vizsgálja meg a renderelt HTML-t, vagy használja a böngésző fejlesztői eszközeit a tényleges id attribútum megtalálásához, amely a fejléc elemhez van rendelve.

Hivatkozás egy címsorra egy másik Markdown-fájlban a hivatkozásban található horgonyazonosítóval rendelkező fájlnév megadásával:

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

A wikilap egyben Markdown-fájl is. Hivatkozás egy címsorra a wiki egyik lapján egy másik oldalról:

Welcome to the Wiki!

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

Images

Képek és animált GIF-fájlok használatával bemutathatja a fogalmakat, és vizuális érdeklődést adhat a tartalomhoz. Képek hozzáadása a Markdown widgethez, a lekéréses kérelmekhez, a Readme-fájlokhoz és a wikifájlokhoz.

Használja a szabványos Markdown-szintaxist egy képhez vagy animált GIF-hez: ![Image alt text](Image path). Ez a szintaxis hasonló a hivatkozáshoz, de a sor felkiáltójellel ! kezdődik.

Image alt text leírja a képet, és megjeleníti, amikor a felhasználó a közzétett nézetben rámutat a képre. Image path azonosítja a kép helyét.

Íme egy példa, amely egy Illusztrációt ad hozzá egy Markdown-fájlhoz:

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

Kép elérési útja

A képfájl elérési útja lehet relatív vagy abszolút elérési út a Gitben vagy a TFVC-ben, ugyanúgy, mint egy hivatkozás egy másik Markdown-fájljának elérési útja.

• Relatív elérési út: ![Image alt text](./image.png)
• Abszolút elérési út a Gitben: ![Image alt text](/media/markdown-guidance/image.png)
• Abszolút elérési út a TFVC-ben: ![Image alt text]($/project/folder/media/markdown-guidance/image.png)

Képméret

A képméret beállítása a Image-path =Image-widthxImage-height szintaxis használatával:

• A betű x a "by" jelentését képviseli a szélesség-szer-magasság kifejezésben.
• Ne adjon hozzá szóközt a betű xelőtt vagy után.
• Adjon meg egy szóközt az egyenlőségjel = előtt.
• Ha csak a szélességet szeretné megadni, használja a következőt Image-path =Image-widthx: . Önnek még tartalmaznia kell a x betűt.

Íme egy példa egy 500 szélességű és 250 magasságú kép Markdown-szintaxisára:

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

Ellenőrzőlista vagy feladatlista

A feladatok és a műveletelemek előrehaladásának nyomon követése egyszerű feladatlisták használatával. Ellenőrzőlisták vagy feladatlisták hozzáadása lekéréses kérelmekhez és wikifájlokhoz. Ez a funkció hasznos a lekéréses kérelmek leírásában a véleményezők bemenetének nyomon követéséhez vagy egy wikiprojekt oldalán a tevékenység állapotának nyomon követéséhez.

Példa: Ellenőrzőlista létrehozása a Markdownban

Hozzon létre egy ellenőrzőlistát közvetlenül a Markdownban:

• Új feladat létrehozásához használjon üres szögletes zárójeleket [ ] .
• A feladat megjelölése késznek, ha a szögletes zárójelek x közé betesszük a [x] betűt.
• Az egyes feladatokat kötőjellel és szóközzel - [ ] vagy számmal és szóközzel előzheti meg 1. [ ]. Használjon bármilyen számot.
• Ne használjon ellenőrzőlistát Markdown-táblában.

Az alábbi példa egy négy elemet tartalmazó ellenőrzőlistát hoz létre, amelyben az első elem befejezettként van megjelölve:

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

Az ellenőrzőlista közzétett nézete a következő:

Az ellenőrzőlista közzététele után a felhasználók befejezettként jelölnek meg egy elemet a listában lévő elem jelölőnégyzetének bejelölésével.

Példa: Feladatlista markdown alkalmazása a kijelölt szövegre

Jelölje ki a meglévő szöveget a webportálon, és használja a Markdown eszköztár műveleteit az ellenőrzőlista formátumának alkalmazásához. Miután ilyen módon felvett egy ellenőrzőlistát vagy feladatot, szerkessze a listát vagy a tevékenységet a Markdownban.

Az alábbi kép bemutatja, hogyan alkalmazhatja a Feladatlista stílust a Markdown eszköztáron a kijelölt szövegre:

A feladatot jelölje meg befejezettként a lista feladat mezőjének bejelölésével:

Emoji-reakciók

Emoji-reakciók hozzáadása lekéréses kérelmekhez és wikifájlokhoz. Emoji-reakciók használatával karaktert adhat hozzá, és reagálhat a kérésben szereplő megjegyzésekre.

Írja be egy érzelem vagy kifejezés nevét, és smile tegye a szöveget kettőspontok : közé. A Markdown közzétett nézetében a bemenet a megfelelő emoji-ábrává alakul. Az Azure DevOps Markdownja támogatja a legtöbb GitHub-emoji-ábrát. Nem támogatja az egyéni hangulatjeleket , mint a :bowtie:.

Példa: Emoji-reakciók hozzáadása lekéréses kérelemben

Ez a példa bemutatja, hogyan adhat hozzá emoji-reakciókat Markdownnal egy lekéréses kérelem megjegyzésében:

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

A képen az emoji-reakciók közzétett nézete látható:

Példa: Kivétel az emoji szintaxisnál a Markdownban

Ez a példa bemutatja, hogyan kerülheti el az emoji szintaxist a Markdown fordított perjel \ karakterével:

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

Ez a kép a Markdown közzétett nézetét mutatja, amely az emoji szintaxist mutatja:

Egy pull request megjegyzésében használjon két fordított perjelet \\ az emoji-szintaxis konvertálásának megakadályozásához.

Speciális karakterek literális szövegként

A Markdownban a fordított perjelet \ használva speciális karaktereket tehet közzé literális szövegként. A fordított perjel arra utasítja a közzétételi rendszert, hogy a speciális karaktert literális szövegként jelenítse meg, és ne értelmezze vagy konvertálja.

Használja a ignore és escape szintaxist a Definition of Done (board)-ban, a Markdown widget-ben, pull kérésekben, Readme fájlokban és wiki fájlokban.

Példa: Speciális karakterek közzététele

A Markdown-szintaxis `Szöveget visszafelé dőlt ékezetek közé zárni` a közzétett nézetben Enclose text in backticks jelenik meg. A közzétételi rendszer alkalmazza a inline code formátumot a backticks (') szövegére, és nem teszi közzé a backtickeket.

Ha egy backtick (`) meg van előzve egy fordított perjellel (\), a backtick-ek közötti szövegformátum nem változik, és a közzétételi rendszer tartalmazza a backtick-eket. Ez a viselkedés a legtöbb speciális karakternél működik, beleértve a zárójeleket(), szögletes zárójeleket[], aláhúzásjelet_, kötőjelet-, hash mark#, csillagot*, visszafelé mutató aposztrófot és magát a fordított perjelet\.

Az alábbi Markdown a fordított perjel \ karaktert használja a speciális karakterek literális szövegként való megjelenítéséhez:

\\\ Code comment

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

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

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

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

A Markdown közzétett nézete a következő:

\\ Kód megjegyzése

A __aláhúzásjelek megjelenítése__

# Kód megjegyzése és nem címsor

( A zárójelek belefoglalása )

* A csillagjelek megjelenítése*, és ne változzon dőltté

Note

Néhány Markdown esetében a fordított perjelhez tartozó HTML-kódot \ írja be a karakterszimbólum \ helyett.

Attachments

Fájlok csatolása lekéréses kérelmek megjegyzéseihez és wikilapjaihoz. A mellékletek segíthetnek a pont szemléltetésében vagy a javaslatok részleteinek megadásában. A mellékletek a következő fájlformátumokat támogatják:

Melléklet típusa

Fájlformátumok

Code

C# (.cs), Extensible Markup Language (.xml), JavaScript Object Notation (.json), Hypertext Markup Language (.html, .htm), Layer (.lyr), Windows PowerShell-szkript (.ps1), Roshal Archive (.rar), Távoli asztali kapcsolat (.rdp), Strukturált lekérdezési nyelv (.sql)

Megjegyzés: A kódmellékletek nem támogatottak a lekéréses kérelmek megjegyzéseiben.

Tömörített fájlok

ZIP (.zip), GZIP (.gz)

Documents

Markdown (.md), Microsoft Office Message (.msg), Microsoft Project (.mpp), Word (.doc, .docx), Excel (.xls, .xlsx, .csv), PowerPoint (.ppt, .pptx), Egyszerű szöveg (.txt), Hordozható dokumentumformátum (.pdf)

Images

PNG (.png), GIF (.gif), JPEG (.jpeg, .jpg), Ikonok (.ico)

Visio

VSD (.vsd, .vsdx)

Video

MOV (.mov), MP4 (.mp4)

Note

A lekéréses kérelmek megjegyzései nem támogatják az összes fájlformátumot mellékletként. A Microsoft Office-üzenetfájlok (.msg) például nem támogatottak.

Képek vagy fájlok csatolása

Képeket vagy fájlokat a lekéréses kérelem Megjegyzés mezőjébe vagy a Szerkesztés panel wikilapjára többféleképpen csatolhat:

• Húzza a fájlt a megjegyzésbe vagy a wikilapra.

• Illessze be a vágólapról a képet a megjegyzésbe vagy a wikilapra. A kép közvetlenül a megjegyzésben vagy a wikilapon jelenik meg.

• Válassza a Csatolás (papírcsatolás) ikont a megjegyzésben vagy a Wikilap Formátum panelén, és válassza ki a csatolni kívánt fájlt:

  

Ha nem képzendő fájlt csatol, a rendszer létrehoz egy hivatkozást a fájlra a megjegyzésben vagy a wikilapon. Módosítsa a hivatkozás megjelenítendő szövegét a szögletes zárójeleken belül, a [Updated link display text](LINK URL)következőképpen: . Amikor közzéteszi a lapot vagy a megjegyzést, a felhasználó kiválasztja a hivatkozást a melléklet eléréséhez.

Matematikai jelölés és karakterek

A lekéréses kérelmek megjegyzéseiben és wikifájljaiban matematikai jelöléseket és karaktereket használhat. A beágyazott és a blokk KaTeX-jelölés is támogatott, amely a következő elemeket tartalmazza:

• Symbols
• Görög betűk
• Matematikai operátorok
• Hatáskörök és indexek
• Törtek és binomok
• Egyéb KaTeX-támogatott elemek

Egy Markdown-fájlban a matematikai jelölés a dollárjelek $ közé tartozik. Ha más szöveggel beágyazott kifejezést szeretne létrehozni, a jelölést egy dollárjellel kell befoglalnia. $ A + B = C $ Blokkkifejezés esetén kezdje el és fejezd be a blokkot két dollárjellel. $$ A = 1 \ B = 2 \ C = A + B $$

Példa: Görög karakterek listázása

Az alábbi példa a matematikai jelölésben használt görög karaktereket sorolja fel egy kódrészlet hozzáadásával a Markdown-fájlban. Vegye észre, hogy a kódrészlet nyelvi azonosítója KaTeX, és nem 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$

Íme a görög karakterek közzétett nézete:

Példa: Algebrai jelölés használata

Az alábbi példa beágyazott jelölést és algebrai blokkkifejezést használ:

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

And, the area of a triangle is:

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

Íme, a Markdown-fájlban található jelölés közzétett nézete:

Példa: Összegek és integrálok megjelenítése

Az alábbi példa két blokkkifejezéssel számítja ki az összegeket és az integrálokat:

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

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

A Markdown-fájlban lévő kifejezések közzétett nézete:

Markdown egy Azure DevOps-wikiben

A Markdown számos módon használható az Azure DevOps-wiki továbbfejlesztéséhez. A következő szakaszok szintaxisbeli példákat nyújtanak a különböző feladatokhoz:

• Mermaid diagramokat, például szekvenciákat, folyamatábrákat és felhasználói útvonalakat adhat hozzá.
• Tartalomjegyzék (TOC) létrehozása lapokhoz és aloldalakhoz.
• Összecsukható oldalszakaszok konfigurálása.
• Videók és Azure Boards-lekérdezések eredményeinek beágyazása.
• A munkaelemekre mutató hivatkozás a kivonatjel #használatával.
• Használja az @<alias> említéseket a felhasználók és csoportok számára.
• Olyan HTML-elemeket is tartalmazhat, mint a <font> rich text.
• Ellenőrizze az oldallátogatás számát.

Ezeknek a funkcióknak a rendelkezésre állása az Azure DevOps verziójától függ.

Hableány-diagramok

A Hableány lehetővé teszi diagramok és vizualizációk létrehozását szöveg és kód használatával. Az Azure DevOps wiki a következő Hableány-diagramtípusokat támogatja:

• Szekvenciadiagramok
• Gantt-diagramok
• Flowcharts
• Osztálydiagram
• Állapotdiagram
• Felhasználói út
• Kördiagram
• Követelmények diagramja
• Gitgraph-diagramok
• Entitáskapcsolati diagramok
• Idővonal-diagramok

További információkért lásd a Hableány kibocsátási megjegyzéseit.

Limitations

Ha a Hableány-diagrammal dolgozik az Azure DevOpsban, tartsa szem előtt az alábbi korlátozásokat:

• Az Azure DevOps korlátozott szintaxistámogatást biztosít a Hableány-diagramtípusokhoz. A nem támogatott szintaxis tartalmazza a legtöbb HTML-címkét, a Font Awesome-t, a flowchart szintaxist (használja helyette a graph elemet), a LongArrow ----> és még sok mást.

• Az Internet Explorer nem támogatja a Hableányt. Ha a wikiben Hableány-diagramokat használ, a diagramok nem jelennek meg az Internet Explorerben.

Példa: Hableány-diagram hozzáadása a wikilaphoz

Ha egy Hableány-diagramot szeretne hozzáadni egy wikilaphoz, kezdje el és fejezhesse be a jelölést három kettősponttal :. Adja meg a kulcsszót mermaid , a diagram típusát( például sequenceDiagram), és adja meg az ábrázolni kívánt információkat. A diagram adatai behúzásos szakaszként lesznek megadva a szintaxisban.

Az alábbi példa bemutatja, hogyan adhat hozzá Hableány-diagramot egy wikilaphoz:

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

Példa: Szekvenciadiagram

A szekvenciadiagram (típus sequenceDiagram) egy interakciós ábra, amely bemutatja, hogyan működnek a folyamatok egymással, és milyen sorrendben.

Az alábbi példa bemutatja, hogyan adhat hozzá szekvenciadiagramot egy wikilaphoz:

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

A szekvenciadiagram közzétett nézete:

Példa: Gantt-diagram

A Gantt-diagram (típus gantt) az egyes ütemezett feladatokat egy folytonos sávként rögzíti, amely balról jobbra terjed. A x tengely az időt jelöli. A y tengely rögzíti a tevékenységeket és azok befejezési sorrendjét.

Ha kizár egy adott tevékenységhez tartozó dátumot, napot vagy dátumgyűjteményt, a Gantt-diagram alkalmazkodik a változásokhoz. A diagram a feladaton belüli rés létrehozása helyett egyenlő számú nappal jobbra terjed ki.

Az alábbi példa bemutatja, hogyan vehet fel Gantt-diagramot egy wikilapra:

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

A Gantt-diagram közzétett nézete:

Példa: Folyamatábra

A folyamatábra (típus graph) csomópontokból, geometriai alakzatokból és élekből, valamint nyilakból vagy vonalakból áll. A diagram típusának graph azonosítása után adja meg a diagram információinak áramlási irányát, például TB; felülről lefelé.

Az alábbi példa létrehoz egy folyamatábrát a graph típussal. A gráfadatok balról jobbra LR; haladnak.

Note

Az Azure DevOps nem támogatja a flowchart diagram típusát, a nyíl ----> szintaxisát, illetve a subgraph diagramtípusra mutató és azokból származó hivatkozásokat.

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

A folyamatábra grafikonjának közzétett nézete a következő:

Példa: Osztálydiagram

Az osztálydiagram (típus classDiagram) az objektumorientált programozási modell alapvető része. A diagram az attribútumokkal és metódusokkal rendelkező objektumokat, valamint az objektumok közötti öröklést ismerteti.

Az alábbi példa bemutatja, hogyan adhat hozzá osztálydiagramot egy wikilaphoz:

:::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()
    }
:::

Az osztálydiagram közzétett nézete:

Példa: Állapotdiagram

Az állapotdiagram (típus stateDiagram) azt ismerteti, hogyan változhatnak a rendszerállapotok, amikor egyik állapotról a másikra váltanak.

Az alábbi példa bemutatja, hogyan adhat hozzá állapotdiagramot egy wikilaphoz. Ez a példa az állapotdiagram típusának 2. verzióját használja (típus stateDiagram-v2).

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

Az állapotdiagram közzétett nézete:

Példa: Felhasználói folyamatábra

A felhasználói folyamat (típus journey) diagramja leírja, hogy milyen lépések szükségesek egy adott magasabb szintű művelet vagy feladat elvégzéséhez.

Az alábbi példa bemutatja, hogyan vehet fel egy felhasználói folyamatábrat egy wikilapra:

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

A felhasználói folyamatábra közzétett nézete:

Példa: Kördiagram

A kördiagram (típus pie) diagram segít megjeleníteni a kördiagramon lévő információk százalékos arányát. A diagramtípus azonosítása pie után adja meg a title kördiagram címével ellátott kulcsszót.

Az alábbi példa egy kördiagramot hoz létre a következő címmel Fishermen in countries:

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

A kördiagram közzétett nézete a következő:

Példa: Követelmények diagramja

A követelmények diagramja (típus requirementDiagram) a követelmények és azok kapcsolatainak vizualizációját hozza létre.

Az alábbi példa bemutatja, hogyan adhat hozzá követelménydiagramot egy wikilaphoz:

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

A követelmények diagramjának közzétett nézete a következő:

Példa: Gitgraph-diagram

Git-diagram (típus gitGraph) használatával jeleníthet meg Git-műveleteket, például véglegesítéseket, ágakat és egyesítéseket.

Az alábbi példa bemutatja, hogyan adhat hozzá gitgráfdiagramot egy wikilaphoz:

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

A git gráf diagram közzétett nézete:

Példa: Entitáskapcsolat diagramja

Egy entitáskapcsolati diagram (típus erDiagram) használatával modellezheti a rendszer entitásai közötti kapcsolatokat, például adatbázist vagy alkalmazást. Ezek a diagramok segítenek megérteni és megtervezni az adatok szerkezetét és összefüggéseit.

Az alábbi példa bemutatja, hogyan adhat hozzá entitáskapcsolati diagramot egy wikilaphoz:

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

Az entitáskapcsolati diagram közzétett nézete:

Példa: Idővonal-diagram

Idősordiagram (típus timeline) használatával időrendi sorrendben jelenítheti meg az eseményeket, így könnyebben nyomon követheti az előrehaladást vagy az előzményeseményeket.

Az alábbi példa bemutatja, hogyan adhat hozzá ütemtervdiagramot egy wikilaphoz:

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

Az ütemtervdiagram közzétett nézete a következő:

Wikilap tartalomjegyzéke

Hozzon létre egy tartalomjegyzéket (TOC) a wikilaphoz a [[_TOC_]] szintaxiscímkével. Amikor a közzétételi rendszer találkozik a címkével, és legalább egy címsort megtalál a wikilapon, létrehozza a lap toC-jét. A tartalomjegyzék címe a lapon a "Tartalom".

A TOC létrehozásához vegye fel a [[_TOC_]] szintaxiscímkét a wikilapra a Markdownban, vagy válassza a További beállítások (...) lehetőséget. >Tartalomjegyzék a lap Szerkesztés nézetében .

A TOC hozzáadásához vegye figyelembe az alábbi szempontokat:

• A [[_TOC_]] címke szintaxisa kis- és nagybetű-érzékeny. Ha kisbetűvel [[_toc_]]adja meg a szintaxist, előfordulhat, hogy a TOC nem jelenik meg.
• A közzétételi rendszer megjeleníti a TOC-ját a [[_TOC_]] címke első példányának a Markdown lapon. Figyelmen kívül hagyja a címke más példányait ugyanazon az oldalon.
• A címkét [[_TOC_]] bárhol elhelyezheti a Markdownban. A rendszer megjeleníti a TOC-t azon a helyen, ahol a címkét elhelyezte a Markdownban.
• A rendszer csak a kettős kereszt # szintaxisával azonosított Markdown-stílusú fejléceket erősíti meg. Figyelmen kívül hagyja a HTML-stíluscímkéket.
• A rendszer csak a címsorszöveget használja a TOC-bejegyzés létrehozásához. Figyelmen kívül hagyja az összes további HTML- és Markdown-szintaxist.

Az alábbi példa bemutatja, hogy a publikálási rendszer hogyan hagyja figyelmen kívül a címsorok további formázását, amikor létrehozza a TOC, vagyis a tartalomjegyzék bejegyzését. A címsor dőlt betűvel formázja a "Flagship" szót, de a címsor TOC-bejegyzése eltávolítja az extra stílust.

Wikilap aloldalainak táblázata

A wikilaphoz aloldalakat tartalmazó táblázatot adhat hozzá a [[_TOSP_]] szintaxiscímke használatával. A lap táblázatának címe "Gyermekoldalak". A táblázat tartalmaz egy bejegyzést a wikilap egyes aloldalaihoz.

Az aloldalak táblázatának létrehozásához vegye fel a [[_TOSP_]] szintaxiscímkét a wikilapra a Markdownban, vagy válassza a További beállítások (...) lehetőséget. >Melléklapok táblázata a lap Szerkesztés nézetében .

Íme néhány pont az aloldalak táblázatának hozzáadásáról:

• A [[_TOSP_]] címke szintaxisa kis- és nagybetű-érzékeny. Ha kisbetűvel [[_tosp_]]adja meg a szintaxist, előfordulhat, hogy az aloldalak táblázata nem jelenik meg.
• A közzétételi rendszer az aloldalak táblázatát jeleníti meg a [[_TOSP_]] címke első előfordulásánál a Markdown oldalon. Figyelmen kívül hagyja a címke más példányait ugyanazon az oldalon.
• A címkét [[_TOSP_]] bárhol elhelyezheti a Markdownban. A rendszer az aloldalak táblázatát azon a helyen jeleníti meg, ahol a címkét elhelyezte a Markdownban.

Összecsukható szakaszok egy wikilapon

A HTML-szintaxis <details><summary> használatával összecsukható szakaszt adhat hozzá egy wikilaphoz. Összecsukható szakasz használatával korlátozhatja a lap adott tartalmainak láthatóságát, például elavult vagy archivált adatokat, vagy beállíthat egy kérdés- és válaszforgatókönyvet.

A wikilap megnyitásakor az összecsukható szakasz bezárul (összecsukva), de a szakasz összegzése látható. A felhasználók kiválaszthatják a címet a kibontáshoz (megnyitáshoz), és szükség szerint összecsukhatják a szakaszt.

Íme néhány pont az összecsukható szakasz hozzáadásáról:

• Adja meg a címkéken belüli <summary>Title</summary> szakasz címét. Az összegzés mindig látható az oldalon.
• Adjon hozzá egy üres sort a záró </summary> címke után. Ha nem adja hozzá az üres sort, a szakasz nem jelenik meg megfelelően.
• Adja meg a fő tartalmat az üres sor után. A fő tartalom formázásához Markdown-szintaxist és HTML-t használhat.
• Ha több összecsukható szakaszt hoz létre a lapon, minden egyes záró </details> címke után adjon hozzá egy üres sort.

Az alábbi példa egy összecsukható szakaszt hoz létre egy wikilapon:

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

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

Beágyazott videók

Videók beágyazása a YouTube-ról és a Microsoft Streamsből egy wikilapra a ::: video ::: szintaxis használatával. A deklarációban video definiáljon egy blokkot <iframe> a videóhoz. Adjon meg egy hivatkozást a videóra, és adja meg az előnyben részesített szélességet és magasságot. Más attribútumokat is beállíthat, például szegélyeket és teljes képernyős módot. A záró kettőspontra ::: van szükség a lap törésének megakadályozásához.

Az alábbi példa egy videót ágyaz be a wikilapra:

Watch the following video:

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

A wikilap közzétett nézete beágyazott videóval:

Beágyazott Azure Boards-lekérdezés eredményei

Az Azure Boards-lekérdezés beágyazása egy wikioldalt eredményez táblázatként a query-table lekérdezésazonosítóval rendelkező szintaxis használatával:

Results from the Azure Boards query:

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

A További beállítások (...) > lehetőséget is választhatjaLekérdezési eredmények az eszköztáron:

A Lekérdezés eredményei párbeszédpanelen jelölje ki a lekérdezés eredményeit, majd a Beszúrás gombra kattintva ágyazza be az eredményeket táblázatként a wikilapra.

A lekérdezés URL-címének másolásával kapcsolatos további információkért, amely a lekérdezés GUID azonosítót biztosít, olvassa el Lekérdezéselemek e-mail küldése vagy a lekérdezés URL-címének megosztásacímű témakört.

Értesítések @ említésekkel

** Említéseket hozhat létre felhasználók vagy csoportok számára az at szimbólum használatával @, mint a következő példában @<user-alias>. Amikor beírja a "at" szimbólumot@ , megnyílik az Automatikus frissítés párbeszédpanel, ahol kiválaszthatja a felhasználókat vagy csoportokat az e-mail-értesítések fogadásához:

Választhatja a További beállítások (...) >@ Említés lehetőséget is az eszköztáron:

Ha közvetlenül a kódban szerkeszted a lapokat, használd az alábbi mintát, @<{identity-guid}>.

Wikilap oldallátogatásainak száma

Adjon hozzá egy automatikusan összesített oldallátogatási számot a wiki minden oldalához az elmúlt 30 napban. Az oldallátogatás egy adott felhasználó által 15 perces időközzel végzett oldalnézet.

A batch API pagesBatch használatával megtekintheti a lapszámozott nézetben lévő összes oldal látogatásainak napi számát. A nézet nincs a látogatások száma szerint rendezve.

30 naposnál régebbi adatok esetén a REST API-val lekérheti az összes oldallátogatás listáját. Rendezze a lapokat a látogatások száma alapján, és határozza meg a 100 legjobbat. A látogatásokat irányítópulton vagy adatbázisban tárolhatja.

Az alábbi képen egy közzétett wikilap lapszáma látható:

HTML-címkék wikilapokon

Hozzon létre gazdag tartalmat a wikioldalakon olyan HTML-címkék használatával, mint például a <font> és <span>. Az Azure DevOps Server 2019.1-ben és újabb verzióiban html formátumban is beilleszthet gazdag tartalmakat, például képeket és videókat.

Példa: Markdown-szintaxis használata HTML-ben

Az alábbi példa bemutatja, hogyan használható Markdown-szintaxis egy HTML-elemen belül egy wikilapon. Adjon hozzá egy üres sort a nyitó HTML-elem és a Markdown előtt:

<p>

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

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

Példa: Videó beágyazása HTML-lel

Az alábbi példa bemutatja, hogyan ágyazhat be egy videót egy wikilapra a <video> HTML-elem és a videó URL-címének használatával:

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

Példa: Rich Text formátum használata

Az alábbi példa bemutatja, hogyan használható HTML rich text formátum egy wikilapon:

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

Az alábbi képen a HTML-rich text tartalom közzétett nézete látható egy wikilapon, ahogy az a Standard Light témanézetben is látható:

Ez ugyanaz a közzétett lap a Sötét téma nézetben.

Kapcsolódó tartalom

• Projektoldal vagy Üdvözlőlapok
• Widget-katalógus
• Wikilapok hozzáadása és szerkesztése