Uso de Markdown en Azure DevOps

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

En este artículo se describe la sintaxis básica para usar el formato Markdown (.md) con características de Azure DevOps, incluidas las páginas Wiki. La sintaxis de Markdown permite agregar formato especial al contenido de la página, como encabezados, listas, tablas e imágenes. Utiliza Markdown para dar formato a los archivos README, paneles, contenido de las pull requests, etc.

Hay dos opciones de formato: convenciones comunes de Markdown y extensiones de Markdown para GitHub.

Compatibilidad con las características de Azure DevOps

La sintaxis de Markdown le permite dar formato al contenido con encabezados, vínculos de referencia, texto en negrita y archivos adjuntos. No toda la sintaxis de Markdown funciona con todas las características de Azure DevOps. Entre las características clave que admiten la sintaxis de Markdown se incluyen las siguientes:

• Criterios para la definición de Done (board) para los hitos del proyecto.
• Objetivos y métricas del equipo con el widget Markdown.
• Solicitudes de cambios para archivos de proyecto en un repositorio de Git.
• README files en un Git repo para ayudar a los colaboradores.
• Archivos wiki para el contenido de la página en una wiki del proyecto de equipo.

En la lista siguiente se muestran los elementos markdown que admite cada característica y los vínculos a las secciones de sintaxis de este artículo:

Headers

Estructurar el contenido mediante encabezados markdown. Los encabezados separan partes largas del contenido de la página en secciones que son más fáciles de leer. Puede agregar encabezados en una definición de Hecho (panel), el widget de Markdown, las solicitudes de incorporación de cambios, los archivos Léame y los archivos wiki.

Para definir un encabezado de nivel superior, comience una línea con una sola almohadilla # seguida del texto del encabezado, como # Get started on the project. Organice los comentarios con subheaders iniciando la línea con más de una marca hash como ## Request permissions o ### Send feedback. Puede usar hasta seis marcas hash para crear niveles de tamaño de encabezados.

Ejemplo: Creación de encabezados en Markdown

El siguiente Markdown crea un encabezado de nivel superior (H1) y cuatro niveles de subheaders (H2, H3, H4 y 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

En la imagen siguiente se muestra la vista publicada de Markdown:

Párrafos y saltos de línea

Divida secciones largas en párrafos más pequeños o inserte saltos de línea para facilitar la lectura del texto.

Agregue párrafos y saltos de línea en una tabla de Definición de Done, en el widget Markdown, las solicitudes de incorporación de cambios, los archivos Readme y los archivos wiki.

Ejemplo: Añadir saltos en Markdown y solicitudes de incorporación de cambios

Los comentarios de una solicitud de incorporación de cambios aceptan Markdown, como en estilo negrita y cursiva para texto. Use la tecla Entrar para insertar un salto de línea para iniciar texto nuevo en la línea siguiente o agregar espaciado entre líneas.

En Azure DevOps, para crear un salto de línea dentro de un párrafo, agregue dos espacios al final de la línea antes de presionar Entrar:

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

Esto se representa como:

Esta es la primera línea con dos espacios al final.
Esta es la segunda línea, que aparecerá directamente debajo del primero.

Si presiona Enter sin dos espacios finales, las líneas se combinan en un único párrafo de la salida publicada.

Para crear un nuevo párrafo (con una línea en blanco entre), presione Entrar dos veces:

This is the first paragraph.

This is the second paragraph.

En la imagen siguiente se muestra la vista publicada de Markdown para el espaciado en un comentario de solicitud de cambios:

Ejemplo: Agregar saltos en archivos o widgets de Markdown

En un archivo Markdown o un widget de Markdown, separe las líneas de texto para crear nuevos párrafos. Agregue dos espacios (tecla espaciadora ) antes del salto de línea y presione Entrar para iniciar un nuevo párrafo.

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.

En la imagen siguiente se muestra la vista publicada de Markdown para espaciar en un widget:

Citas en bloque

Cita comentarios o texto para establecer el contexto de un nuevo comentario o texto. El texto citado muestra sangría desde el margen izquierdo, con una línea vertical que recorre toda la sección citada.

Puede agregar citas en bloque en una definición de Hecho (panel), el widget de Markdown, las solicitudes de incorporación de cambios, los archivos Léame y los archivos wiki.

Para entrecomillar una sola línea de texto o un bloque de párrafo, inserte un corchete > angular derecho antes del primer texto.

Para crear una cita anidada, inserte dos o más corchetes antes del texto. La cita anidada tiene una sangría más alejada del margen izquierdo con líneas verticales dobles a lo largo de la sección citada.

Ejemplo: Citar texto usando corchetes

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

En la imagen siguiente se muestra la vista publicada del Markdown para un texto citado.

Reglas horizontales

Subraye o separe contenido y secciones de página con líneas horizontales. Puede agregar separadores en una definición de Done (board), el widget Markdown, las solicitudes de incorporación de cambios, los archivos README y los archivos wiki.

Para agregar una regla horizontal, inserte una línea en blanco y, a continuación, otra línea con tres guiones. ---

Ejemplo: Insertar separadores horizontales

El siguiente Markdown crea dos reglas horizontales:

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

En la imagen siguiente se muestra la vista publicada de Markdown para las reglas horizontales.

Resaltado (negrita, cursiva, tachado)

Markdown le permite resaltar el texto de varias maneras:

Combine estos estilos para agregar énfasis. Puede usar estilos de énfasis en una Definición de Done (board), el widget Markdown, las solicitudes de extracción, los archivos Readme y los archivos wiki.

Ejemplo: Énfasis en el texto

Este es un markdown que muestra cómo resaltar texto con estilos diferentes y combinados:

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

En la imagen siguiente se muestra cómo se ven los estilos de énfasis de texto de Markdown cuando se publican:

Resaltado de código

Resalte bloques de texto o texto insertado como código mediante resaltados de código. Puede agregar resaltado de código en solicitudes de incorporación de cambios, archivos Léame y archivos wiki.

Para dar formato a un bloque de texto como código, encierre el bloque entre tres comillas invertidas (```). Las comillas que inician y finalizan la sección deben estar en una línea separada del bloque de código para destacar.

También puede dar formato a una parte del texto dentro de un bloque de texto mayor como un segmento de código en línea. Para este estilo, incluya el código insertado dentro de comillas simples. Las comillas están integradas en el texto y no en líneas separadas.

El resaltado de código en el widget de Markdown renderiza el código como texto preformateado.

Ejemplo: Resaltar el bloque de código en el widget Markdown

En este ejemplo se muestra cómo resaltar un bloque de texto como código en el widget markdown:

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

En este ejemplo se muestra la vista publicada de Markdown para un bloque de texto resaltado como código:

sudo npm install vsoagent-installer -g

Ejemplo: Resaltar código en línea en el widget Markdown

En este ejemplo se muestra cómo resaltar una parte del texto como un segmento de código insertado en el 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 -->

Esta imagen muestra la vista publicada de Markdown para una parte del texto resaltada como un segmento de código en línea:

Ejemplo: Conversión de texto en código, identificación del lenguaje de código

Hay otra manera de convertir un bloque de texto en código. Cuando una línea de texto de Markdown comienza con cuatro espacios en el margen izquierdo, el texto se convierte automáticamente en un bloque de código. En este ejemplo se muestra este comportamiento:

    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.

El enfoque preferido es incluir el texto dentro de tres comillas para poder especificar el identificador de idioma. El identificador aplica el resaltado de sintaxis al código según las convenciones del lenguaje especificado. Las etiquetas de identificador están disponibles para la mayoría de los lenguajes de programación, como JavaScript (js), C# (csharp) y Markdown (md). Para obtener la lista de idiomas admitidos, consulte el repositorio de GitHub highlightjs .

Estos ejemplos muestran cómo identificar un bloque de texto como JavaScript o C#. Agregue la etiqueta de identificador de idioma después de las tres primeras comillas invertidas, como en ```md.

JavaScript

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

Esta es la vista publicada del código JavaScript:

const count = records.length;

C#

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

Esta es la vista publicada del código de C#:

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

Sugerir cambio

Las solicitudes de incorporación de cambios de GitHub admiten la característica Comentario , que permite a los colaboradores proporcionar entradas y sugerir cambios. Agregue un comentario para una línea específica o varias líneas en un archivo. El autor de la solicitud de incorporación de cambios aplica el cambio sugerido en un comentario seleccionando Aplicar cambio. Esta acción confirma el cambio en la solicitud de incorporación de cambios e inicia una compilación.

Al agregar un comentario que incluya resaltado de código en el widget Markdown, el código se muestra en formato de diferencias. Los cambios en la línea modificada se anotan para mostrar las diferencias. El símbolo - menos indica el contenido quitado y el símbolo + más resalta el nuevo contenido.

Ejemplo: Sugerir cambios en un comentario de solicitud de incorporación de cambios

En este ejemplo se muestra cómo sugerir cambios de código en una solicitud de incorporación de cambios en el widget markdown. En este escenario, el bloque de código usa el identificador suggestion:

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

En la imagen siguiente se muestra la vista de diferencias con la sugerencia de comentario.

Para obtener más información, vea Sugerir cambios en los comentarios.

Tables

Organice los datos estructurados con tablas de Markdown. Agregue tablas en el widget Markdown, las solicitudes de incorporación de cambios, los archivos Readme y los archivos wiki. Las tablas son especialmente útiles para describir parámetros de función, métodos de objeto y otros datos con una asignación clara de nombre a descripción.

Estos son algunos puntos sobre cómo trabajar con tablas en Markdown:

• Cree cada fila en una línea independiente y finalice cada fila con un retorno de carro (CR) o avance de línea (LF).
• Cree columnas con guiones - y el símbolo de barra vertical |, como |---|---|---|.
• Defina los encabezados de columna en la primera fila, como | First | Middle | Last |.
• Establezca la alineación de columnas (izquierda, centro, derecha) mediante dos puntos : en la segunda fila, como |:--|:--:|--:|.
• Escape del símbolo de canalización con una barra invertida \| cuando se usa en texto de tabla, como | Describe the pipe \| symbol. |
• Agregue saltos de línea dentro de una celda mediante la etiqueta de salto de línea HTML <br/>. Este enfoque funciona en una wiki, pero no en ningún otro lugar.
• Agregue un espacio en blanco antes y después de un elemento de trabajo o una solicitud de incorporación de cambios mencionados en el texto de la tabla.

Ejemplo: Creación de una tabla

En el ejemplo siguiente se muestra cómo crear una tabla con tres columnas y cinco filas en 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 |

Este es el aspecto de la tabla Markdown cuando se publica:

Lists

Organice los elementos relacionados mediante diferentes tipos de listas. Use una lista ordenada para mostrar el orden o la secuencia de elementos. Usa viñetas para los elementos relacionados que no necesitan estar en orden. Agregue estilos de lista en una definición de Done (board), el widget Markdown, las solicitudes de incorporación de cambios, los archivos Léame y los archivos wiki.

Estos son algunos puntos sobre cómo trabajar con listas en Markdown:

• Especifique cada elemento de lista en una línea independiente.
• Inicie cada elemento de una lista ordenada con un número seguido de un punto, como 1. First item 1. Next item. El sistema de publicación numera automáticamente la lista.
• Inicie cada elemento de una lista desordenada con un guión - o asterisco *, como - First point - Next point.
• Compruebe el espaciado antes y después de las listas en un archivo o widget de Markdown:
  • Para la primera lista, agregue una línea en blanco antes y después de la lista.
  • Para las listas anidadas, use la sangría correcta. No necesita saltos de línea adicionales antes o después de las listas anidadas.

Ejemplo: Crear una lista numerada (ordenada)

En este ejemplo se muestra cómo crear una lista numerada para los elementos de una secuencia mediante Markdown:

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

Esta es la vista publicada de la lista ordenada de Markdown:

1. Primer paso del procedimiento.
2. Segundo paso.
3. Tercer paso.

Ejemplo: crear una lista de viñetas (sin ordenar)

En este ejemplo se muestra cómo crear una lista desordenada de elementos relacionados mediante Markdown:

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

Esta es la vista publicada de la lista no ordenada de Markdown:

• Primer elemento de la lista.
• Siguiente elemento.
• Último elemento.

Ejemplo: listas anidadas

Cree listas dentro de listas y combine los estilos.

En este ejemplo se muestra cómo crear una lista numerada con listas de viñetas anidadas en 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 -->

Esta es la vista publicada de la lista con listas anidadas:

1. Primer paso del procedimiento.
   • Primer elemento de una lista anidada.
   • Siguiente elemento.
   • Último elemento.
2. Segundo paso.
   • Primer elemento de una lista anidada.
     • Primer elemento de una sublista anidada.
     • Siguiente elemento.
   • Último elemento.
3. Tercer paso.
   1. Primer subpaso.
   2. Siguiente subpaso.
   3. Último subpaso.

Links

Vincule los elementos de trabajo escribiendo el símbolo de hash # seguido del identificador del elemento de trabajo y luego seleccione el elemento de trabajo de la lista. Agregue diferentes tipos de vínculos en el tablero de Definition of Done, el widget Markdown, las peticiones de extracción, los archivos Readme y los archivos wiki.

Estos son algunos puntos sobre cómo trabajar con vínculos en Markdown:

• La sintaxis estándar de Markdown para un vínculo es [Link display text](Link path).

• En los comentarios de solicitudes de incorporación de cambios y wikis, las direcciones URL que comienzan con HTTP o HTTPS se formatean automáticamente como enlaces.

• Si utiliza el hash # de otras maneras, como los códigos hexadecimales de color, puede evitar sugerencias automáticas para los elementos de trabajo anteponiendo una barra invertida # al hash \.

• En los archivos y widgets de Markdown, cree hipervínculos de texto para una dirección URL mediante la sintaxis de vínculo estándar de Markdown. Link path puede ser relativo o absoluto.

  En el ejemplo siguiente se muestra cómo especificar un vínculo relativo en Markdown. El texto se representa como un hipervínculo:

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

  Esta es la vista publicada del vínculo:

  Para obtener más información, consulte la referencia del lenguaje C#.

Vínculos compatibles

Al vincular a otra página de Markdown en el mismo repositorio de Control de versiones de Git o Team Foundation (TFVC), especifique el destino del vínculo como una ruta de acceso relativa o absoluta.

En las secciones siguientes se muestran ejemplos de diferentes escenarios de Markdown.

Ejemplo: vínculos relativos a la página principal

Estos son algunos ejemplos de vínculos relativos en la página principal de una wiki:

• Ruta relativa: [Display text](target.md)

• Ruta de acceso absoluta en Git: [Display text](/folder/target.md)

• Ruta de acceso absoluta en TFVC: [Display text]($/project/folder/target.md)

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

Ejemplo: Vínculos relativos del widget de Markdown

En el ejemplo siguiente se muestra un vínculo relativo en un widget de Markdown:

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

Ejemplo: Vínculos relativos a páginas wiki

Estos son algunos ejemplos de vínculos relativos en una página wiki:

• Ruta de acceso absoluta de páginas wiki: [Display text](/parent-page/child-page)
• Dirección URL: [Display text](http://address.com)

Vínculos relativos en el control de código fuente

Los vínculos relativos a los archivos de control de código fuente se interpretan de forma diferente en una página principal y un widget de Markdown:

Ejemplo: vínculos relativos a la página principal

Los vínculos relativos de una página principal son relativos a la raíz del repositorio de control de código fuente donde existe la página principal. Estos son algunos ejemplos:

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

Ejemplo: Vínculos relativos del widget de Markdown

Los vínculos relativos en un widget de Markdown son relativos a la URL base de la colección del proyecto de equipo. Estos son algunos ejemplos:

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

Vínculos de anclaje

Cuando un archivo Markdown se representa como HTML, el sistema asigna un identificador de anclaje a cada encabezado de la página. El identificador es una forma convertida del texto del encabezado. El sistema aplica los siguientes cambios para crear el identificador:

• Reemplace los espacios en el texto del encabezado por guiones -
• Cambio de letras mayúsculas a minúsculas
• Convertir la mayoría de los caracteres especiales y la puntuación a guiones, incluidos :, ", ?, @, $, #
• Quitar o convertir otros caracteres especiales según las reglas del motor de representación

Use la marca # hash para vincular al encabezado del documento, como en [Display text](#<header-anchor>).

En el ejemplo siguiente se muestra un encabezado y un vínculo a su identificador de ancla:

#### Team #1 : Release Wiki!

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

Esta es la vista publicada:

Equipo #1: ¡Wiki de la versión!

Le damos la bienvenida a la wiki de la versión. Para obtener más información, visite la Wiki del proyecto.

Vincule a un encabezado en otro archivo Markdown especificando el nombre del archivo con el ID de anclaje en el vínculo:

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

Una página wiki también es un archivo Markdown. Haga referencia a un encabezado en una página de la wiki desde otra página:

Welcome to the Wiki!

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

Images

Use imágenes y GIF animados para demostrar conceptos y agregar interés visual al contenido. Agregue imágenes en el widget Markdown, las solicitudes de extracción, los archivos Readme y los archivos wiki.

Use la sintaxis estándar de Markdown para una imagen o GIF animado: ![Image alt text](Image path). Esta sintaxis es similar a un enlace, pero la línea comienza con un símbolo de exclamación !.

Image alt text describe la imagen y se muestra cuando el usuario mantiene el puntero sobre la imagen en la vista publicada. Image path identifica la ubicación de la imagen.

Este es un ejemplo que agrega una ilustración a un archivo Markdown:

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

Ruta de acceso de la imagen

La ruta de acceso al archivo de imagen puede ser una ruta de acceso relativa o una ruta de acceso absoluta en Git o TFVC, al igual que la ruta de acceso a otro archivo Markdown en un vínculo.

• Ruta relativa: ![Image alt text](./image.png)
• Ruta de acceso absoluta en Git: ![Image alt text](/media/markdown-guidance/image.png)
• Ruta de acceso absoluta en TFVC: ![Image alt text]($/project/folder/media/markdown-guidance/image.png)

Tamaño de imagen

Establezca el tamaño de la imagen con la Image-path =Image-widthxImage-height sintaxis :

• La letra x representa "por" en la expresión ancho por alto.
• No agregue un espacio antes o después de la letra x.
• Incluya un espacio antes del signo igual = .
• Para especificar solo el ancho, use Image-path =Image-widthx. Todavía tiene que incluir la letra x.

Este es un ejemplo de sintaxis de Markdown para una imagen con un ancho de 500 y un alto de 250:

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

Lista de comprobación o lista de tareas

Realice un seguimiento del progreso de las asignaciones y elementos de acción con listas de tareas ligeras. Agregue listas de comprobación o listas de tareas en solicitudes de incorporación de cambios y archivos wiki. Esta característica es útil en la descripción de la solicitud de incorporación de cambios para realizar un seguimiento de la entrada de los revisores o en una página del proyecto wiki para realizar un seguimiento del estado de la tarea.

Ejemplo: Crear lista de comprobación en Markdown

Cree una lista de comprobación directamente en Markdown:

• Use corchetes vacíos [<space>] para crear una nueva tarea.
• Muestre una tarea como completada mediante la inclusión de la letra x entre corchetes [x].
• Precede a cada tarea con un guión y un espacio -<space>[<space>] o un número y un espacio 1.<space>[<space>]. Use cualquier número.
• No use una lista de comprobación dentro de una tabla de Markdown.

En el ejemplo siguiente se crea una lista de comprobación con cuatro elementos, donde el primer elemento se marca como completado:

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

Esta es la vista publicada de la lista de comprobación:

Una vez publicada la lista de comprobación, los usuarios marcan un elemento como completado activando la casilla del elemento de la lista.

Ejemplo: Aplicar la lista de tareas Markdown al texto seleccionado

Seleccione el texto existente en el portal web y use acciones en la barra de herramientas de Markdown para aplicar el formato de lista de comprobación. Después de agregar una lista de comprobación o tarea de esta manera, edite la lista o tarea en Markdown.

En la imagen siguiente se muestra cómo aplicar el estilo de lista de tareas en la barra de herramientas de Markdown al texto seleccionado:

Marque una tarea como completada; para ello, active el cuadro de tareas de la lista:

Reacciones de emoji

Agregue reacciones emoji en solicitudes de incorporación de cambios y archivos wiki. Usa reacciones emoji para añadir carácter y reaccionar a los comentarios de la solicitud.

Escriba el nombre de una emoción o expresión como smile y coloque el texto entre dos puntos :. En la vista publicada de Markdown, la entrada se convierte en el gráfico emoji correspondiente. Markdown en Azure DevOps admite la mayoría de los gráficos emoji de GitHub. No admite emoji personalizado como :bowtie:.

Ejemplo: Agregar reacciones emoji en un pull request

En este ejemplo se muestra cómo agregar reacciones emoji con Markdown en un comentario de solicitud de incorporación de cambios:

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

Esta imagen muestra la vista publicada de las reacciones emoji:

Ejemplo: escapar de la sintaxis de emoji en Markdown

En este ejemplo se muestra cómo escapar la sintaxis emoji con el carácter de barra \ diagonal inversa en Markdown:

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

Esta imagen muestra la vista publicada de Markdown que muestra la sintaxis emoji:

En un comentario de pull request, use dos barras invertidas \\ para evitar la conversión de sintaxis de emoji.

Caracteres especiales como texto literal

Utilice la barra invertida \ como carácter de escape en Markdown para publicar caracteres especiales en forma de texto literal. La barra diagonal inversa indica al sistema de publicación que muestre el carácter especial como texto literal y no lo interprete ni convierta.

Usar la sintaxis de ignore y escape en una Definition of Done (board), el widget Markdown, los pull requests, los archivos README y los archivos wiki.

Ejemplo: Publicar caracteres especiales

La sintaxis de Markdown "Colocar texto entre comillas invertidas" se muestra como Enclose text in backticks en la vista publicada. El sistema de publicación aplica el inline code formato al texto dentro de las comillas invertidas (`) y no publica las comillas invertidas.

Si antepone la barra diagonal inversa (\) al acento grave (`), el formato del texto dentro de los acentos graves no cambia y los acentos graves se publican. ** Este comportamiento funciona para la mayoría de los caracteres especiales, incluidos paréntesis(), corchetes[], subrayado_, guion-, marca de hash#, asterisco*, acento grave `, y la barra diagonal inversa\.

El siguiente Markdown usa el carácter de barra invertida \ para mostrar caracteres especiales 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*

Esta es la vista publicada de Markdown:

\\ Comentario de código

Mostrar __underscores__

# Un comentario de código y no un encabezado

( Incluya los paréntesis )

Mostrar los *asteriscos* y no cambiar a cursiva

Attachments

Adjunte archivos en comentarios de pull request y páginas wiki. Los datos adjuntos pueden ayudar a ilustrar su punto o proporcionar detalles sobre sus sugerencias. Los datos adjuntos admiten los siguientes formatos de archivo:

Adjuntar imágenes o archivos

Puede adjuntar una imagen o un archivo en un cuadro comentario de solicitud de incorporación de cambios o en una página wiki en el panel Editar de varias maneras:

• Arrastre un archivo al comentario o a la página wiki.

• Pegue una imagen del Portapapeles en el comentario o en la página wiki. La imagen se muestra directamente en el comentario o en la página wiki.

• Seleccione el icono Adjuntar (paperclip) en el comentario o en el panel Formato de la página wiki y elija el archivo que desea adjuntar:

  

Al adjuntar un archivo noimage, el sistema crea un vínculo al archivo en el comentario o en la página wiki. Cambie el texto de visualización del vínculo entre corchetes, como en [Updated link display text](LINK URL). Al publicar la página o comentario, el usuario selecciona el vínculo para acceder a los datos adjuntos.

Notación matemática y caracteres

Puede usar notación matemática y caracteres en comentarios de solicitud de incorporación de cambios y archivos wiki. Se admite la notación KaTeX tanto en línea como en bloque, que incluye los siguientes elementos:

• Symbols
• Letras griegas
• Operadores matemáticos
• Potencias e índices
• Fracciones y binomiales
• Otros elementos admitidos por KaTeX

En un archivo Markdown, la notación matemática se incluye dentro de símbolos de dólar $. Para crear una expresión en línea con otro texto, incluya la notación con signos de dólar simples, $ A + B = C $. Para una expresión de bloque, comience y finalice el bloque con dos signos de dólar, $$ A = 1 \ B = 2 \ C = A + B $$.

Ejemplo: Enumerar caracteres griegos

En el ejemplo siguiente se enumeran los caracteres griegos usados en notación matemática agregando un fragmento de código en el archivo Markdown. Observe que el identificador de idioma del fragmento de código es KaTeX y no 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$

Esta es la vista publicada de los caracteres griegos:

Ejemplo: Uso de la notación algebraica

En el ejemplo siguiente se usa una notación en línea y una expresión de bloque algebraica.

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

And, the area of a triangle is:

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

Esta es la vista publicada de la notación en el archivo Markdown:

Ejemplo: Mostrar sumas e enteros

En el ejemplo siguiente se usan dos expresiones de bloque para calcular sumas e enteros:

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

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

Esta es la vista publicada de las expresiones en el archivo Markdown:

Markdown en una wiki de Azure DevOps

Hay muchas maneras de usar Markdown para mejorar la wiki de Azure DevOps. En las secciones siguientes se proporcionan ejemplos de sintaxis para varias tareas:

• Agregar diagramas Mermaid, como secuencias, recorridos del usuario y diagramas de flujo.
• Crear una tabla de contenido (TOC) para páginas y subpáginas
• Configuración de secciones de página contraíbles
• Inserción de vídeos y resultados de consultas de Azure Boards
• Vínculo a elementos de trabajo con la marca hash #
• Use las menciones @<alias> para usuarios y grupos
• Incluir elementos HTML como <font> para texto enriquecido
• Comprobar el recuento de visitas de la página

La disponibilidad de estas características depende de la versión de Azure DevOps.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Watch the following video:

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

Results from the Azure Boards query:

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

Etiquetas HTML en páginas wiki

Cree contenido enriquecido mediante etiquetas HTML en páginas wiki, como <font> y <span>. En Azure DevOps Server 2019.1 y versiones posteriores, también puede pegar contenido enriquecido como imágenes y vídeo como HTML.

Ejemplo: Uso de la sintaxis de Markdown dentro de HTML

En el ejemplo siguiente se muestra cómo usar la sintaxis de Markdown dentro de un elemento HTML en una página wiki. Agregue una línea en blanco después del elemento HTML de apertura y antes de 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>

Ejemplo: Inserción de un vídeo con HTML

En el ejemplo siguiente se muestra cómo insertar un vídeo en una página wiki mediante el <video> elemento HTML con una dirección URL al vídeo:

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

Ejemplo: Uso del formato de texto enriquecido

En el ejemplo siguiente se muestra cómo usar el formato de texto enriquecido HTML en una 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>

En la imagen siguiente se muestra la vista publicada del contenido de texto enriquecido HTML en una página wiki, como se muestra en la vista de tema claro estándar.

Esta es la misma página publicada en la vista de tema oscuro:

Contenido relacionado

• Página del proyecto o páginas de bienvenida
• Catálogo de widgets
• Agregar y editar páginas wiki