Partilhar via


Utilizar Markdown no Azure DevOps

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Importante

Selecione uma versão no seletor de Versão de Conteúdo do Azure DevOps.

Selecione a versão deste artigo que corresponde à sua plataforma e versão. O seletor de versão está acima do índice. Procure a sua plataforma e versão do Azure DevOps.

Este artigo descreve a sintaxe básica para usar o formato Markdown (.md) com recursos do Azure DevOps, incluindo páginas Wiki. A sintaxe de marcação permite adicionar formatação especial ao conteúdo da página, como cabeçalhos, listas, tabelas e imagens. Use Markdown para formatar os seus ficheiros README, painéis, conteúdo de pull request, e assim por diante.

Você tem duas opções de formatação: convenções comuns de Markdown e extensões de Markdown para o GitHub.

Suporte para recursos do Azure DevOps

A sintaxe Markdown abrange uma ampla gama de opções de formatação, como cabeçalhos de conteúdo, links de referência, ênfase de texto como negrito e anexos de arquivo. Nem toda sintaxe de Markdown está disponível para todos os recursos no Azure DevOps. Alguns dos recursos significativos que suportam a sintaxe Markdown incluem:

Observação

Markdown no Azure DevOps não suporta JavaScript ou iframes. Por exemplo, não é possível incorporar elementos interativos, como temporizadores de contagem regressiva, diretamente.

A tabela a seguir descreve o suporte a recursos para diferentes elementos Markdown e fornece links para as seções de sintaxe neste artigo. A tabela usa a notação Definição de Concluído, Markdown Widget, pull requests (PR), arquivos README e arquivos Wiki.

Tipo de Markdown Concluído Widget Relações Públicas LEIA-ME Plataforma Wiki
Cabeçalhos ✔️ ✔️ ✔️ ✔️ ✔️
Parágrafos e quebras de linha ✔️ ✔️ ✔️ ✔️ ✔️
Citações em bloco ✔️ ✔️ ✔️ ✔️ ✔️
Regras horizontais ✔️ ✔️ ✔️ ✔️ ✔️
Ênfase ✔️ ✔️ ✔️ ✔️ ✔️
Destaque de código ✔️ ✔️ ✔️
Sugerir alteração ✔️
Tabelas ✔️ ✔️ ✔️ ✔️
Listas ✔️ ✔️ ✔️ ✔️ ✔️
Ligações ✔️ ✔️ ✔️ ✔️ ✔️
Imagens ✔️ ✔️ ✔️ ✔️
Lista de verificação ou lista de tarefas ✔️ ✔️
Emojis ✔️ ✔️
Ignorar ou fugir do Markdown ✔️ ✔️ ✔️ ✔️ ✔️
Anexos ✔️ ✔️
Notação matemática ✔️ ✔️

Cabeçalhos

Estruture seu conteúdo usando cabeçalhos Markdown. Os cabeçalhos ajudam a separar partes longas do conteúdo da página em seções mais fáceis de ler. Você pode adicionar cabeçalhos em uma Definição de Concluído (quadro), o widget Markdown, pull requests, arquivos Readme e arquivos wiki.

Para definir um cabeçalho de nível superior, inicie uma linha com uma única marca # de hash seguida pelo texto do título, como # Get Started on the Project. Organize seus comentários com subcabeçalhos iniciando a linha com mais de uma marca de hash como ## Request Permissions ou ### Send Feedback. Você pode usar até seis marcas de hash para criar níveis de tamanho de cabeçalhos.

Exemplo: Criar cabeçalhos em Markdown

A Markdown a seguir cria um cabeçalho de nível superior (H1) e quatro níveis de subcabeçalhos (H2, H3, H4 e 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

A imagem a seguir mostra a exibição publicada do Markdown:

Captura de ecrã que mostra uma vista publicada da sintaxe Markdown para cinco níveis de cabeçalhos.

Parágrafos e quebras de linha

Facilite a leitura do texto dividindo partes longas em parágrafos menores ou inserindo quebras de linha para criar espaços entre linhas de texto.

Você pode adicionar parágrafos e quebras de linha em um Definition of Done (board), widget Markdown, pull requests, arquivos Readme e arquivos wiki.

Exemplo: Adicionar as quebras no Markdown e os pull requests

Os comentários em um pedido de pull aceitam Markdown, tal como o estilo negrito e o itálico para texto. Você também pode usar a tecla Enter para inserir uma quebra de linha para iniciar um novo texto na próxima linha ou adicionar espaçamento entre linhas.

No Markdown a seguir, o autor usa a tecla Enter para iniciar a segunda frase em uma nova linha:

_Markdown_ lets you separate long lines of text by using the **Enter** key in a pull request comment. <!-- Select Enter -->
Select **Enter** once to start text on a new line. <!-- Select Enter twice -->
Select **Enter** twice to insert a blank line between lines of text.

A imagem a seguir mostra a exibição publicada do Markdown para espaçamento de um comentário de pull request:

Captura de ecrã que mostra uma vista publicada da sintaxe Markdown para quebras de linha e parágrafo.

Exemplo: Adicionar quebras em ficheiros ou widgets Markdown

Em um arquivo Markdown ou widget Markdown, você pode separar linhas de texto para criar novos parágrafos. Adicione dois espaços (tecla de espaço ) antes da quebra de linha e selecione Enter para iniciar um novo parágrafo.

Add two **Space** characters before the end of the line and then select **Enter**. <!-- Select Space twice, Selet Enter -->
The next paragraph starts on a new line. The two paragraphs are separated by a blank line.

A seguinte imagem mostra a visualização publicada do Markdown para configurar o espaçamento num widget.

Captura de ecrã que mostra uma vista publicada da sintaxe Markdown para as teclas Enter e Space.

Citações em bloco

Cite comentários ou texto para definir o contexto do seu novo comentário ou texto. O texto citado é exibido recuado a partir da margem esquerda, com uma linha vertical ao longo da secção citada.

Você pode adicionar aspas de bloco numa Definição de Concluído (quadro), no widget Markdown, pedidos de pull, arquivos Leia-me e arquivos wiki.

Para citar uma única linha de texto ou um bloco de parágrafo, insira um colchete > angular reto antes do primeiro texto.

Para criar uma citação aninhada, insira dois ou mais colchetes antes do texto. A citação aninhada é mais afastada da margem esquerda com linhas verticais duplas ao longo da secção citada.

Exemplo: Citar texto usando colchetes

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

A imagem a seguir mostra a exibição publicada do Markdown para o texto citado:

Captura de ecrã que mostra uma vista publicada da sintaxe Markdown para citar blocos de texto.

Regras horizontais

Sublinhe ou separe o conteúdo e as seções da página com regras horizontais. Você pode adicionar separadores numa Definição de Pronto (quadro), o widget Markdown, pedidos de pull, ficheiros Leiame e ficheiros wiki.

Para adicionar uma regra horizontal, insira uma linha em branco e, em seguida, outra linha com três hífenes (traços). ---

Exemplo: Inserir separadores horizontais

O Markdown a seguir cria duas regras horizontais:

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

A imagem a seguir mostra a exibição publicada do Markdown para regras horizontais:

Captura de ecrã que mostra uma vista publicada da sintaxe Markdown para regras horizontais.

Ênfase (negrito, itálico, rasurado)

Markdown fornece várias opções de estilo para enfatizar o texto:

Estilo Exemplo Markdown (linguagem de marcação)
Itálico Texto em itálico Coloque o texto dentro de um único asterisco * ou caracteres sublinhados _ .
Ousado (Forte) Texto em negrito Coloque o texto dentro de caracteres duplos de asterisco ** ou sublinhado __ .
Tachado Texto riscado Coloque o texto entre caracteres de til duplo ~~.

Você pode combinar esses estilos para aplicar ênfase ao texto. Os estilos de ênfase estão disponíveis em uma Definição de Concluído (quadro), o widget Markdown, solicitações pull, arquivos Leiame e arquivos wiki.

Observação

Não há sintaxe Markdown para sublinhar texto. Em uma página wiki, você pode sublinhar o texto usando o elemento sublinhado HTML <u> .

Exemplo: enfatizar texto

A Markdown a seguir mostra como enfatizar o texto usando estilos diferentes e combinando estilos:

**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 imagem a seguir mostra a exibição publicada do Markdown para estilos de ênfase de texto:

Captura de ecrã que mostra uma vista publicada da sintaxe Markdown para estilos de ênfase de texto.

Realce de código

Realce blocos de texto ou texto embutido como código usando realces de código. Você pode adicionar realce de código em pull requests, arquivos Readme e arquivos wiki.

Para formatar um bloco de texto como código, coloque-o entre três acentos graves (```). Os backticks que iniciam e terminam a seção devem estar em uma linha separada do bloco de código para realçar.

Você também pode formatar uma parte do texto dentro de um bloco de texto maior como um segmento de código embutido. Para neste estilo, coloque o código embutido em backticks únicos. Os backticks estão integrados com o texto e não em linhas separadas.

O realce de código inserido no widget Markdown renderiza o código como texto pré-formatado sem formatação.

Exemplo: Realçar bloco de código no widget Markdown

O exemplo a seguir mostra como realçar um bloco de texto como código no widget Markdown:

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

O exemplo a seguir mostra a visualização publicada do Markdown para um bloco de texto formatado como código.

sudo npm install vsoagent-installer -g

Exemplo: realçar código embutido no widget Markdown

O exemplo a seguir mostra como realçar uma parte do texto como um segmento de código embutido no widget Markdown:

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

A imagem a seguir mostra a exibição publicada do Markdown para uma parte do texto realçada como um segmento de código embutido:

Captura de ecrã que mostra uma vista publicada da sintaxe Markdown para uma parte do texto realçada como um segmento de código embutido.

Exemplo: Converter texto em código, identificar linguagem de código

Há um método alternativo para converter um bloco de texto em código. Quando uma linha de texto no Markdown começa com quatro espaços na margem esquerda, o texto é convertido automaticamente em um bloco de código. O exemplo a seguir demonstra esse comportamento:

    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.

A abordagem preferida é incluir o texto em três backticks para que você possa especificar o identificador de idioma. O identificador aplica realce de sintaxe ao código de acordo com as convenções da linguagem especificada. Os rótulos de identificador estão disponíveis para a maioria das linguagens de programação, como JavaScript (js), C# (csharp) e Markdown (md). Para obter a lista de idiomas suportados, consulte o repositório GitHub highlightjs .

Os exemplos a seguir mostram como identificar um bloco de texto como JavaScript ou C#. Você adiciona o rótulo do identificador de idioma após os três primeiros backticks, como em ```md.

Javascript

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

Aqui está a visualização publicada do código JavaScript:

const count = records.length;

C#

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

Aqui está a exibição publicada do código C#:

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

Sugerir alteração

As solicitações pull do GitHub suportam o recurso Comentário , onde os colaboradores podem fornecer informações e sugerir alterações. Você pode adicionar um comentário para uma linha específica ou várias linhas em um arquivo. O autor da solicitação pull pode aplicar a alteração sugerida em um comentário selecionando Aplicar alteração. Esta ação confirma a alteração para a solicitação pull e inicia uma compilação.

Se adicionar um comentário que inclua destacar código na ferramenta Markdown, o código será renderizado no formato de diferenças. As alterações na linha modificada são anotadas para mostrar as diferenças. O símbolo - de menos indica o conteúdo removido e o símbolo + de adição realça o novo conteúdo.

Exemplo: sugerir alterações em um comentário de pull request

O exemplo a seguir mostra como sugerir alterações de código em uma solicitação pull no widget Markdown. Nesse cenário, o bloco de código usa o identificador suggestion:

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

A imagem a seguir mostra a visão de diferenças com a sugestão de comentário:

Captura de tela que mostra um exemplo de uma alteração sugerida para o código em um comentário de solicitação pull.

Para obter mais informações, consulte Sugerir alterações nos comentários.

Tabelas

Organize dados estruturados com tabelas Markdown. Você pode adicionar tabelas no widget Markdown, em pull requests, arquivos README e arquivos wiki. As tabelas são especialmente úteis para descrever parâmetros de função, métodos de objeto e outros dados com um mapeamento claro de nome para descrição.

Aqui estão alguns pontos sobre como trabalhar com tabelas no Markdown:

  • Crie cada linha em uma linha separada e termine cada linha com um retorno de carro (CR) ou alimentação de linha (LF).
  • Crie colunas com hífenes - e o símbolo pipe |, como em |---|---|---|.
  • Defina os cabeçalhos de coluna na primeira linha, como em | First | Middle | Last |.
  • Defina o alinhamento da coluna (esquerda, centro, direita) usando dois pontos : na segunda linha, como em |:--|:--:|--:|.
  • Escape o símbolo de pipe usando uma barra invertida \| quando usado no texto da tabela, como em | Describe the pipe \| symbol. |
  • Adicione quebras de linha dentro de uma célula usando a tag de quebra HTML <br/>. Esta abordagem funciona dentro de um wiki, mas não em outro lugar.
  • Adicione um espaço em branco antes e depois de um item de trabalho ou pull request mencionado no texto da tabela.

Exemplo: Criar uma tabela

O exemplo a seguir mostra como criar uma tabela com três colunas e cinco linhas em 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 |

Aqui está a exibição publicada da tabela Markdown:

Característica Pré-lançamento Alvo de lançamento
Calculadora Não 27/10/2025
Gráficos Sim 8/18/2025
Correio Não 2/16/2025
Tabelas Sim 27/10/2025
Pesquisar Não 1/5/2026

Listas

Organize itens relacionados com diferentes tipos de listas. Crie uma lista ordenada para mostrar a precedência de itens ou itens em uma sequência. Crie listas de itens relacionados, mas não ordenados, usando marcadores. Você pode adicionar estilos de lista em uma Definição de Concluído (quadro), o widget Markdown, pull requests, arquivos README e arquivos wiki.

Aqui estão alguns pontos sobre como trabalhar com listas no Markdown:

  • Especifique cada item da lista em uma linha separada.
  • Inicie cada item em uma lista ordenada com um número seguido de um ponto, como em 1. First item 2. Next item. Você também pode iniciar cada item com 1. e deixar o sistema de publicação determinar a numeração para você.
  • Inicie cada item em uma lista não ordenada com um hífen - ou asterisco *, como em - First point - Next point.
  • Verifique o espaçamento antes e depois das listas em um arquivo ou widget Markdown:
    • Para a lista inicial, adicione uma linha em branco antes e depois da lista.
    • Para listas aninhadas, use o recuo correto. Não são necessárias quebras de linha adicionais antes e depois.

Exemplo: Criar uma lista numerada (ordenada)

O exemplo a seguir mostra como criar uma lista numerada para itens em uma sequência usando Markdown:

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

Aqui está a exibição publicada da lista ordenada de Markdown:

  1. Primeiro passo do procedimento.
  2. Segundo passo.
  3. Terceiro passo.

Exemplo: Criar uma lista de marcadores (não ordenada)

O exemplo a seguir mostra como criar uma lista não ordenada de itens relacionados usando Markdown:

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

Aqui está a exibição publicada da lista não ordenada de Markdown:

  • Primeiro item da lista.
  • Próximo ponto.
  • Último item.

Exemplo: listas aninhadas

Você também pode criar listas dentro de listas e misturar os estilos.

O exemplo a seguir mostra como criar uma lista numerada que tenha listas de marcadores aninhadas em 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 -->

Aqui está a exibição publicada da lista com listas aninhadas:

  1. Primeiro passo do procedimento.
    • Primeiro item numa lista aninhada.
    • Próximo ponto.
    • Último item.
  2. Segundo passo.
    • Primeiro item numa lista aninhada.
      • Primeiro item numa sublista.
      • Próximo ponto.
    • Último item.
  3. Terceiro passo.
    1. Primeira subetapa.
    2. Próxima subetapa.
    3. Última subetapa.

Vincule-se a itens de trabalho inserindo a marca # de hash seguida por uma ID de item de trabalho e selecione o item de trabalho na lista. Você pode adicionar diferentes tipos de links em uma Definição de Concluído (quadro), o widget Markdown, pedidos de pull, ficheiros Readme e ficheiros wiki.

Aqui estão alguns pontos sobre como trabalhar com links no Markdown:

  • A sintaxe Markdown padrão para um link é [Link display text](Link path).

  • Em comentários de pull request e wikis, URLs que começam com HTTP ou HTTPS são automaticamente formatadas como links.

  • Se você usar a marca # de hash de outras maneiras, como códigos hexadecimais coloridos, poderá evitar sugestões automáticas para itens de trabalho prefixando a marca # de hash com uma barra invertida \.

  • Em arquivos e widgets Markdown, você pode criar hiperlinks de texto para uma URL usando a sintaxe padrão do link Markdown. O Link path pode ser relativo ou absoluto.

    O exemplo a seguir mostra como especificar um link relativo em Markdown, onde o texto é renderizado como um hiperlink:

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

    Aqui está a visão publicada do link:

    Para obter mais informações, consulte a referência da linguagem C#.

Ao vincular a outra página de Markdown no mesmo repositório Git ou Team Foundation Version Control (TFVC), você pode especificar o destino do link como um caminho relativo ou absoluto.

Observação

Links para documentos em compartilhamentos de arquivos (file://...) não são suportados por motivos de segurança.

As seções a seguir fornecem exemplos para diferentes cenários de Markdown.

Aqui estão alguns exemplos de links relativos na página de boas-vindas de um wiki:

  • Caminho relativo: [Display text](target.md)

  • Caminho absoluto no Git: [Display text](/folder/target.md)

  • Caminho absoluto no TFVC: [Display text]($/project/folder/target.md)

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

O exemplo a seguir mostra um link relativo em um widget Markdown:

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

Aqui estão alguns exemplos de links relativos em uma página wiki:

  • Caminho absoluto das páginas Wiki: [Display text](/parent-page/child-page)

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

Os links relativos para arquivos de controle do código-fonte são interpretados de forma diferente em uma página de boas-vindas versus um widget Markdown:

Os links relativos numa página de boas-vindas são relativos à raiz do repositório de controlo de código-fonte onde a página de boas-vindas existe. Eis alguns exemplos:

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

Os links relativos em um widget Markdown são relativos à base de URL da coleção do projeto de equipe. Eis alguns exemplos:

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

Quando um arquivo Markdown é renderizado como HTML, o sistema atribui um ID de âncora a cada cabeçalho na página. O ID é uma forma convertida do texto do cabeçalho. O sistema aplica as seguintes alterações para criar o ID:

  • Substitua espaços no texto do cabeçalho por hífenes -
  • Alterar letras maiúsculas para minúsculas
  • Ignorar (não incluir) a maioria dos caracteres especiais, como #, @, $
  • Ignorar (não incluir) a maioria das pontuações, como :, ", ?

Utiliza a hashtag # para fazer a ligação ao cabeçalho no documento, como em [Display text](#<header-anchor>).

O exemplo a seguir mostra um título e um link com o seu ID de âncora.

#### Team #1 : Release Wiki!

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

Aqui está a visão publicada:

Equipe #1 : Release Wiki!

Bem-vindo ao wiki de lançamento. Para obter mais informações, visite o Wiki do projeto.

Você também pode vincular a um título em outro arquivo Markdown especificando o nome do arquivo com o ID da âncora no link:

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

Uma página wiki também é um arquivo Markdown. Você pode fazer referência a um título em uma página no wiki a partir de outra página:

Welcome to the Wiki!

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

Imagens

Demonstre conceitos e adicione interesse visual usando imagens e GIFs animados em seu conteúdo. Você pode adicionar imagens no widget Markdown, pull requests, ficheiros Readme e ficheiros wiki.

A sintaxe padrão de Markdown para uma imagem ou GIF animado é ![Image alt text](Image path). A sintaxe é semelhante à sintaxe de um link, mas a linha começa com um símbolo de ponto ! de exclamação.

O Image alt text valor descreve a imagem. O valor de texto alternativo é exibido quando o usuário passa o mouse sobre a imagem na exibição publicada. O Image path identifica a localização da imagem.

O exemplo a seguir adiciona uma ilustração a um arquivo Markdown:

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

Caminho da imagem

O caminho para o arquivo de imagem pode ser um caminho relativo ou o caminho absoluto no Git ou TFVC, assim como o caminho para outro arquivo Markdown em um link.

  • Caminho relativo: ![Image alt text](./image.png)
  • Caminho absoluto no Git: ![Image alt text](/media/markdown-guidance/image.png)
  • Caminho absoluto no TFVC: ![Image alt text]($/project/folder/media/markdown-guidance/image.png)

Tamanho da imagem

Você pode definir o tamanho da imagem com a Image-path =Image-widthxImage-height sintaxe:

  • A letra x representa a porção by na expressão de cálculo "largura por altura".
  • Não adicione um espaço antes ou depois da letra x.
  • Inclua um espaço antes do sinal de igual = .
  • Se preferir, você pode especificar o Image-width único, como em Image-path =Image-widthx. Observe que você ainda especifica a letra x.

O exemplo a seguir mostra a sintaxe Markdown para uma imagem onde você especifica uma largura de 500 e uma altura de 250:

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

Lista de verificação ou lista de tarefas

Acompanhe o progresso de suas atribuições e itens de ação com listas de tarefas leves. Você pode adicionar listas de verificação ou listas de tarefas em solicitações pull e arquivos wiki. Esse recurso é útil na descrição da solicitação pull para acompanhar a entrada dos revisores ou em uma página de projeto wiki para acompanhar o status da tarefa.

Exemplo: Criar lista de verificação no Markdown

Você pode criar uma lista de verificação diretamente no Markdown:

  • Use colchetes vazios [<space>] para criar uma nova tarefa.
  • Mostrar uma tarefa como concluída incluindo a letra x entre colchetes [x].
  • Preceda cada tarefa com um hífen e espaço -<space>[<space>] ou um número e espaço 1.<space>[<space>]. Você pode usar qualquer numeral.
  • Não use uma lista de verificação dentro de uma tabela Markdown.

O exemplo a seguir cria uma lista de verificação com quatro itens, onde o primeiro item é marcado como concluído:

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

Aqui está a exibição publicada da lista de verificação:

Captura de ecrã que mostra uma lista de verificação onde o primeiro item está marcado como concluído.

Depois que a lista de verificação for publicada, os usuários poderão marcar um item como concluído marcando a caixa de seleção do item na lista.

Exemplo: Aplicar Markdown da lista de tarefas ao texto selecionado

Você também pode selecionar o texto existente no portal da Web e usar ações na barra de ferramentas Markdown para aplicar o formato de lista de verificação. Depois de adicionar uma lista de verificação ou tarefa dessa maneira, você pode editar a lista ou tarefa no Markdown.

A imagem a seguir mostra como aplicar o estilo Lista de Tarefas ao texto selecionado na barra de ferramentas Markdown:

Captura de ecrã que mostra como aplicar o estilo Lista de Tarefas na barra de ferramentas Markdown ao texto selecionado num pedido de pull.

Uma tarefa é marcada como concluída marcando a caixa de tarefa na lista:

Captura de ecrã que mostra tarefas marcadas como concluídas na lista de tarefas.

Reações de emojis

Adicione reações emoji em solicitações pull e arquivos wiki. Você pode usar reações emoji para adicionar caráter e reagir a comentários na solicitação.

Insira o nome de uma emoção ou expressão como smile e coloque o texto entre dois caracteres : . Na visualização publicada do Markdown, sua entrada é convertida para o gráfico emoji correspondente. Markdown no Azure DevOps dá suporte à maioria dos gráficos emoji.

Exemplo: Adicionar reações de emoji em uma solicitação pull

O exemplo a seguir mostra como adicionar reações de emoji com Markdown num comentário de um pull request:

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

Aqui está a visão publicada das reações emoji:

Captura de ecrã que mostra a vista publicada de emojis num comentário de um pull request.

Exemplo: Escapar a sintaxe de emoji no Markdown

O exemplo seguinte mostra como escapar da sintaxe de emoji com o caractere de barra invertida \ em Markdown.

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

Aqui está a exibição publicada do Markdown que mostra a sintaxe do emoji:

Captura de tela que mostra como escapar da sintaxe de emoji em Markdown usando o caractere de barra invertida '\'.

Num comentário de pedido pull, é necessário usar duas barras invertidas \\ para escapar da conversão de sintaxe de emoji.

Caracteres especiais como texto literal

Publique caracteres especiais como texto literal usando a barra invertida \ como um caractere de escape na Markdown. A barra invertida faz com que o sistema de publicação ignore qualquer processo de interpretação e conversão para o caractere especial. O caractere especial é mostrado como texto literal na visualização publicada.

Você pode usar a sintaxe de ignorar e escapar em uma Definição de Pronto (quadro), o widget Markdown, pull requests, arquivos README e arquivos wiki.

Exemplo: publicar caracteres especiais

A sintaxe Markdown `Adicionar texto entre acentos graves` tem a visualização publicada Enclose text in backticks. O sistema de publicação aplica o formato inline code ao texto dentro dos backticks (`) e não publica os backticks.

Se você prefixar o backtick (') com uma barra invertida (\), o formato do texto dentro dos backticks não será alterado e os backticks serão publicados. Esse comportamento está disponível para a maioria dos caracteres especiais, incluindo parênteses (), colchetes []], sublinhado _, hífen -, marca de hash #, asterisco *, e a barra invertida backtick \` em si.

O Markdown a seguir usa a barra invertida \ para publicar caracteres especiais como texto literal.

\\\ Code comment

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

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

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

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

Aqui está a visualização publicada do Markdown:

\\ Comentário de código

Mostrar os __sublinhados__

# Comentário de código e não um título

( Incluir os parênteses )

Mostre os *asteriscos* e não mude para itálico

Observação

Para algumas sintaxes Markdown, pode-se inserir o código HTML &#92; da barra invertida em vez do símbolo de caractere \.

Anexos

Anexe arquivos em comentários de pull request e páginas wiki. Os anexos podem ajudar a ilustrar o seu ponto de vista ou fornecer detalhes sobre as suas sugestões. Os anexos suportam os seguintes formatos de ficheiro:

Tipo de anexo

Formatos de ficheiro

Código

C# (.cs), Extensible Markup Language (.xml), JavaScript Object Notation (.json), Hypertext Markup Language (.html, .htm), Layer (.lyr), Windows PowerShell script (.ps1), Roshal Archive (.rar), Remote Desktop Connection (.rdp), Structured Query Language (.sql)

Nota: Os anexos de código não são suportados em comentários de solicitação pull.

Arquivos compactados

ZIP (.zip), GZIP (.gz)

Documentação

Markdown (.md), Microsoft Office Message (.msg), Microsoft Project (.mpp), Word (.doc, .docx), Excel (.xls, .xlsx, .csv), PowerPoint (.ppt, .pptx), Texto simples (.txt), Formato de Documento Portátil (.pdf)

Imagens

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

Visio

VSD (.vsd, .vsdx)

Vídeo

MOV (.mov), MP4 (.mp4)

Observação

Nem todos os formatos de arquivo são suportados como anexos em comentários de solicitação pull, como arquivos de mensagem do Microsoft Office (.msg).

Anexar imagens ou ficheiros

Há várias maneiras de anexar uma imagem ou arquivo em uma caixa de comentário de solicitação pull ou em uma página wiki no painel Editar :

  • Arraste e solte um arquivo no comentário ou na página wiki.

  • Cole uma imagem na área de transferência no comentário ou na página wiki. A imagem é renderizada diretamente no comentário ou na página wiki.

  • Selecione o ícone Anexar (clipe de papel) no comentário ou no painel Formatar na página wiki e escolha o arquivo a ser anexado:

    Captura de tela que mostra como selecionar o ícone de clipe de papel para anexar um arquivo a uma página wiki.

Quando você anexa um arquivo sem imagem, o sistema cria um link para o arquivo no comentário ou na página wiki. Você pode alterar o texto de exibição do link entre colchetes, como em [Updated link display text](LINK URL). Quando você publica a página ou comentário, o usuário pode selecionar o link para acessar o anexo.

Notação matemática e caracteres

Você pode usar notação matemática e caracteres em comentários de solicitação pull e arquivos wiki. A notação KaTeX em linha e em bloco é suportada, o que inclui os seguintes elementos:

  • Símbolos
  • Letras gregas
  • Operadores matemáticos
  • Poderes e índices
  • Frações e binómios
  • Outros elementos suportados pelo KaTeX

Em um arquivo Markdown, a notação matemática é incluída dentro de símbolos de dólar $. Para criar uma expressão alinhada com outro texto, coloque a notação com cifrões únicos, $ A + B = C $. Para uma expressão de bloco, comece e termine o bloco com dois cifrões, $$ A = 1 \ B = 2 \ C = A + B $$.

Exemplo: Listar caracteres gregos

O exemplo a seguir lista caracteres gregos usados na notação matemática adicionando um trecho de código no arquivo Markdown. Observe que o identificador de idioma para o trecho é KaTeX e não 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$

Aqui está a visão publicada dos caracteres gregos:

Captura de tela que mostra a exibição publicada do trecho de código KaTex que lista caracteres gregos usados em notação matemática.

Exemplo: Usar notação algébrica

O exemplo a seguir usa uma notação embutida e uma expressão de bloco algébrico:

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

And, the area of a triangle is:

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

Aqui está a exibição publicada da notação no arquivo Markdown:

Captura de tela que mostra a exibição publicada do trecho de código KaTex que inclui notação embutida e uma expressão de bloco algébrico.

Exemplo: Mostrar somas e integrais

O exemplo a seguir usa duas expressões de bloco para calcular somas e integrais:

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

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

Aqui está a exibição publicada das expressões no arquivo Markdown:

Captura de tela que mostra a exibição publicada do trecho de código KaTex que usa duas expressões de bloco para calcular somas e integrais.

Markdown em um wiki do Azure DevOps

Há muitas maneiras de usar o Markdown para aprimorar seu wiki do Azure DevOps. As seções a seguir fornecem exemplos de sintaxe para várias tarefas:

  • Adicione diagramas Mermaid como sequências, fluxogramas e experiências do utilizador.
  • Criar um índice para páginas e subpáginas
  • Configurar seções de página recolhíveis
  • Incorporar vídeos e resultados de consulta do Azure Boards
  • Ligação para itens de trabalho com o símbolo de hash #
  • Usar @<alias> menções para usuários e grupos
  • Incluir elementos HTML como <font> para rich text
  • Verifique a contagem de visitas à página

A disponibilidade desses recursos depende da sua versão do Azure DevOps.

Trabalhar com diagramas de Sereia

Sereia permite criar diagramas e visualizações usando texto e código. O wiki do Azure DevOps dá suporte aos seguintes tipos de diagrama Sereia:

Para obter mais informações, consulte as notas de versão do Mermaid.

Limitações

Ao trabalhar com o diagrama Sereia no Azure DevOps, lembre-se das seguintes limitações:

  • Azure DevOps fornece suporte de sintaxe limitado para os tipos de diagrama Mermaid. A sintaxe sem suporte inclui a maioria das tags HTML, Font Awesome, a sintaxe flowchart (use o elemento graph em vez disso), LongArrow ---->, e muito mais.

  • O Internet Explorer não suporta Sereia. Se você usar diagramas de sereia em seu wiki, os diagramas não serão renderizados no Internet Explorer.

Exemplo: Adicionar diagrama Mermaid à página wiki

Para adicionar um diagrama Mermaid a uma página wiki, comece e termine a notação com três pontos :. Especifique a mermaid palavra-chave, o tipo de diagrama, como sequenceDiagram, e forneça as informações para ilustrar. As informações para diagramar são especificadas como uma seção recuada na sintaxe.

O exemplo a seguir mostra como adicionar um diagrama Sereia a uma página wiki:

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

Exemplo: diagrama de sequência

Um diagrama de sequência (tipo sequenceDiagram) é uma ilustração de interação que mostra como os processos operam uns com os outros e em que ordem.

O exemplo a seguir mostra como adicionar um diagrama de sequência a uma página wiki:

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

Aqui está a exibição publicada do diagrama de sequência:

Captura de ecrã do Mermaid Live Editor com o código para um diagrama de sequência e uma pré-visualização da vista publicada.

Exemplo: gráfico de Gantt

Um gráfico de Gantt (tipo gantt) registra cada tarefa agendada como uma barra contínua que se estende da esquerda para a direita. O x eixo representa o tempo. O y eixo registra as tarefas e sua ordem de conclusão.

Quando você exclui uma data, dia ou conjunto de datas específicas de uma tarefa, o gráfico de Gantt acomoda as alterações. O gráfico se estende por um número igual de dias para a direita, em vez de criar uma lacuna dentro da tarefa.

O exemplo a seguir mostra como adicionar um gráfico de Gantt a uma página wiki:

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

Aqui está a visão publicada do gráfico de Gantt:

Captura de ecrã do Mermaid Live Editor com o código de um gráfico de Gantt e uma pré-visualização da vista publicada.

Exemplo: Fluxograma

Um fluxograma (tipo graph) é composto por nós, formas geométricas e arestas, setas ou linhas. Depois de identificar o tipo de diagrama graph , especifique a direção do fluxo para as informações no gráfico, como TB; de cima para baixo.

O exemplo a seguir cria um fluxograma com o graph tipo. As informações do gráfico seguem uma direção da esquerda para a direita LR; .

Observação

O Azure DevOps não suporta o tipo de diagrama flowchart, a sintaxe de seta ----> ou links de e para tipo de diagrama subgraph.

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

Aqui está a visão publicada do fluxograma:

Captura de tela do Mermaid Live Editor com o código de um fluxograma e uma visualização da exibição publicada.

Exemplo: diagrama de classes

O diagrama de classes (tipo classDiagram) é a parte essencial do modelo de programação orientada a objetos. O diagrama descreve objetos com seus atributos e métodos, e a herança entre objetos.

O exemplo a seguir mostra como adicionar um diagrama de classe a uma página wiki:

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

Aqui está a exibição publicada do diagrama de classes:

Captura de ecrã do Mermaid Live Editor com o código de um diagrama de classes e uma pré-visualização da vista publicada.

Exemplo: Diagrama de estado

O diagrama de estado (tipo stateDiagram) descreve como os estados do sistema podem mudar quando transitam de um estado para outro.

O exemplo a seguir mostra como adicionar um diagrama de estado a uma página wiki. Este exemplo usa a versão 2 do tipo de diagrama de estado (type 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
    }
:::

Aqui está a exibição publicada do diagrama de estado:

Captura de ecrã do Mermaid Live Editor com o código para um diagrama de estado e uma pré-visualização da vista publicada.

Exemplo: diagrama de jornada do usuário

O diagrama de jornada do usuário (tipo journey) descreve quais etapas são necessárias para concluir uma ação ou tarefa específica de nível superior.

O exemplo a seguir mostra como adicionar um diagrama de jornada do usuário a uma página wiki:

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

Aqui está a exibição publicada do diagrama de jornada do usuário:

Captura de tela que mostra uma visualização publicada de um diagrama de jornada do usuário no Mermaid Live Editor.

Exemplo: gráfico de pizza

O diagrama circular (tipo pie) ajuda a visualizar as porcentagens de informações em um gráfico circular. Depois de identificar o tipo de diagrama pie, especifique a palavra-chave title com um título para o gráfico circular.

O exemplo a seguir cria um gráfico de pizza com o título Fishermen in countries:

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

Aqui está a exibição publicada do gráfico circular.

Captura de ecrã do Mermaid Live Editor com o código de um gráfico circular e uma pré-visualização da vista publicada.

Exemplo: Diagrama de requisitos

O diagrama de requisitos (tipo requirementDiagram) cria uma visualização dos requisitos e suas conexões.

O exemplo a seguir mostra como adicionar um diagrama de requisitos a uma página wiki:

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

Aqui está a exibição publicada do diagrama de requisitos:

Captura de ecrã do Mermaid Live Editor com o código para um diagrama de requisitos e uma pré-visualização da vista publicada.

Índice de uma página wiki

Crie um sumário (TOC) para sua página wiki usando a [[_TOC_]] marca de sintaxe. Quando o sistema de publicação encontra a tag e confirma pelo menos um título na página wiki, ele gera o sumário da página. O título do sumário na página é "Conteúdo".

Captura de ecrã que mostra como aplicar a tag de sintaxe TOC para gerar um TOC para uma página wiki.

Para criar o sumário, pode-se adicionar a etiqueta de [[_TOC_]] sintaxe à página wiki no Markdown ou selecionar Mais opções (...) >Sumário na vista Editar da página.

Aqui estão alguns pontos sobre como adicionar um sumário:

  • A sintaxe da tag [[_TOC_]] é sensível a maiúsculas e minúsculas. Se especificar a sintaxe usando minúsculas [[_toc_]], o índice pode não aparecer.
  • O sistema de publicação renderiza o sumário para a primeira instância da [[_TOC_]] tag na página Markdown. Ele ignora outras instâncias da tag na mesma página.
  • Você pode colocar a [[_TOC_]] tag em qualquer lugar no Markdown. O sistema renderiza o sumário na página no local onde você colocou a tag no Markdown.
  • O sistema confirma apenas cabeçalhos de estilo Markdown identificados pela sintaxe da marca # de hash. Elas ignoram etiquetas de cabeçalho de estilo HTML.
  • O sistema usa apenas o texto do título para criar a entrada do sumário. Ele ignora toda a sintaxe extra de HTML e Markdown.

O exemplo a seguir mostra como o sistema de publicação ignora a formatação extra para um título quando cria a entrada para o índice. O título formata a palavra "Flagship" com itálico, mas a entrada do sumário do título remove o estilo extra.

Captura de tela que mostra como o sistema de publicação ignora a formatação extra de um título quando cria a entrada para o sumário.

Tabela de subpáginas para uma página wiki

Adicione uma tabela de subpáginas para uma página wiki usando a marca de [[_TOSP_]] sintaxe. O título da tabela na página é "Páginas filhas". A tabela inclui uma entrada para cada subpágina da página wiki.

Para criar a tabela de subpáginas, você pode adicionar a [[_TOSP_]] marca de sintaxe à página wiki no Markdown ou selecionar Mais opções (...) >Tabela de Subpáginas na vista Editar da página.

Aqui estão alguns pontos sobre como adicionar uma tabela de subpáginas:

  • A sintaxe da tag [[_TOSP_]] é sensível a maiúsculas e minúsculas. Se você especificar a sintaxe usando minúsculas [[_tosp_]], a tabela de subpáginas pode não renderizar.
  • O sistema de publicação renderiza a tabela de subpáginas para a primeira instância da [[_TOSP_]] tag na página Markdown. Ele ignora outras instâncias da tag na mesma página.
  • Você pode colocar a [[_TOSP_]] tag em qualquer lugar no Markdown. O sistema renderiza a tabela de subpáginas na página no local onde você colocou a tag no Markdown.

Captura de tela que mostra como o sistema de publicação gera uma tabela de subpáginas para uma página wiki.

Seções dobráveis em uma página wiki

Adicione uma seção recolhível em uma página wiki com a sintaxe HTML <details><summary> . Você pode usar uma seção recolhível para limitar a visibilidade de conteúdo específico na página, como dados desatualizados ou arquivados, ou configurar um cenário de pergunta/resposta.

Quando a página wiki é aberta, a secção dobrável está fechada (recolhida), mas o resumo da secção está visível. Os usuários podem selecionar o título para expandir (abrir) e recolher a seção conforme necessário.

Aqui estão alguns pontos sobre como adicionar uma seção dobrável:

  • Forneça o título da seção dentro das <summary>Title</summary> tags. O resumo está sempre visível na página.
  • Adicione uma linha em branco após a tag de fechamento </summary> . Se você não adicionar a linha vazia, a seção não será renderizada corretamente.
  • Forneça o conteúdo principal após a linha em branco. Você pode usar a sintaxe Markdown e HTML para formatar o conteúdo principal.
  • Se você criar várias seções recolhíveis na página, adicione uma linha em branco após cada tag de fechamento </details> .

O exemplo a seguir cria uma seção recolhível em uma página wiki:

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

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

Captura de ecrã do Mermaid Live Editor com o código de uma secção dobrável e uma pré-visualização da vista publicada.

Vídeos incorporados

Incorpore vídeos do YouTube e do Microsoft Streams em uma página wiki usando a ::: video ::: sintaxe. Dentro da video declaração, defina um <iframe> bloco para o vídeo. Forneça um link para o vídeo e especifique a largura e a altura preferidas. Você pode definir outros atributos, como bordas e modo de tela cheia. Os dois pontos ::: de fechamento são necessários para evitar uma quebra na página.

O exemplo a seguir incorpora um vídeo na página wiki:

Watch the following video:

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

Aqui está a visualização publicada da página wiki com o vídeo incorporado:

Captura de ecrã que mostra a vista publicada da página wiki com o vídeo incorporado.

Resultados da consulta dos Painéis do Azure incorporados

Incorporar resultados da consulta Azure Boards numa página wiki como uma tabela, usando a sintaxe com o ID de consulta query-table:

Results from the Azure Boards query:

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

Você também pode selecionar Mais opções (...) >Resultados da consulta na barra de ferramentas:

Captura de tela que mostra como selecionar Resultados da Consulta no menu Mais opções para incorporar os resultados da consulta como uma tabela na página wiki.

Na caixa de diálogo Resultados da Consulta , selecione os resultados da consulta e, em seguida, selecione Inserir para incorporar os resultados como tabela na página wiki.

Para obter mais informações sobre como copiar a URL de consulta, que fornece um GUID para a consulta, consulte Itens de consulta de email ou URL de consulta de compartilhamento.

Notificações com menções @

Crie menções para utilizadores ou grupos com o símbolo at@, como em @<user-alias>. Quando você insere o símbolo at@ , a caixa de diálogo Sugestão automática é aberta, onde você pode selecionar usuários ou grupos para receber notificações por e-mail:

Captura de tela que mostra como selecionar um usuário na caixa de diálogo Sugestão automática para adicionar uma menção @ na página wiki.

Você também pode selecionar Mais opções (...) >@ Menção na barra de ferramentas:

Captura de tela que mostra como selecionar @ Menção no menu Mais opções para adicionar uma menção para um usuário ou grupo na página wiki.

Ao editar páginas diretamente no código, use o seguinte padrão, @<{identity-guid}>.

Contagem de visitas a uma página wiki

Adicione uma contagem automaticamente agregada de visitas à página nos últimos 30 dias em cada página do wiki. Uma visita à página é uma visualização da página por um usuário especificado durante um intervalo de 15 minutos.

Use a API pagesBatch em lote para ver a contagem diária de visitas a todas as páginas em uma exibição paginada. A visualização não é ordenada pelo número de visitas.

Para dados com mais de 30 dias, use a API REST para obter uma lista de todas as visitas à página. Ordene as páginas com base no número de visitas e determine as 100 melhores. Você pode armazenar as visitas em um painel ou banco de dados.

A imagem a seguir mostra a contagem de páginas em uma página wiki publicada:

Captura de tela que mostra a contagem agregada de visitas à página em uma página wiki publicada.

Tags HTML em páginas wiki

Crie conteúdo avançado usando tags HTML em páginas wiki, como <font> e <span>. No Azure DevOps Server 2019.1 e posterior, você também pode colar conteúdo avançado, como imagens e vídeo, como HTML.

Exemplo: Usar sintaxe Markdown dentro de HTML

O exemplo a seguir mostra como usar a sintaxe Markdown dentro de um elemento HTML em uma página wiki. Adicione uma linha em branco após o elemento HTML de abertura e antes do Markdown:

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

Exemplo: Incorporar um vídeo com HTML

O exemplo a seguir mostra como incorporar um vídeo em uma página wiki usando o <video> elemento HTML com uma URL para o vídeo:

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

Exemplo: Usar formato de texto rico

O exemplo a seguir mostra como usar o formato rich text HTML em uma página wiki:

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

A imagem a seguir mostra a exibição publicada do conteúdo de rich text HTML em uma página wiki, conforme mostrado na visualização padrão do tema Light:

Captura de tela de uma página wiki publicada que usa formatação de rich text HTML, conforme mostrado na visualização de tema Light.

Aqui está a mesma página publicada na visualização de tema escuro:

Captura de tela de uma página wiki publicada que usa formatação de rich text HTML, conforme mostrado na visualização de tema escuro.