Compartir a través de

Adición de Markdown a un panel

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

El widget Markdown es una herramienta versátil que le permite apoyar a su equipo y a las partes interesadas agregando información valiosa directamente al panel. Puede usarlo para mostrar los siguientes elementos:

  • Objetivos del equipo
  • Vínculos a paneles o trabajos pendientes de equipo
  • Vínculos a métricas
  • Vínculos a otros elementos ubicados en un recurso compartido de red, como oneNote, sitio de SharePoint o páginas wiki
  • Fechas importantes o plazos fijados

Mediante el widget Markdown, puede asegurarse de que la información esencial sea fácilmente accesible y visible para su equipo y las partes interesadas. En el ejemplo siguiente se muestra información y vínculos del equipo: Captura de pantalla del widget markdown de ejemplo.

Requisitos previos

Categoría Requisitos
Niveles de acceso - Miembro del proyecto.
- Al menos acceso básico o permisos de panel específicos.
Permisos Para agregar, editar o administrar un panel de equipo: miembro del equipo y miembro del grupo Administradores de proyectos .
Categoría Requisitos
Niveles de acceso - Miembro del proyecto.
- Al menos acceso básico o permisos de panel específicos.
Permisos Para agregar, editar o administrar un panel de equipo: miembro del equipo y miembro del grupo Administradores de proyectos .
Herramientas Para que los widgets de Analytics funcionen con el panel: Análisis habilitado.

Nota:

Los datos que se muestran dentro de un gráfico o widget están sujetos a los permisos concedidos al usuario que ha iniciado sesión. Por ejemplo, si un usuario no tiene permisos para ver elementos de trabajo en una ruta de acceso de área específica, esos elementos no aparecen en widgets basados en consultas en el panel de control. Para más información, consulte Preguntas más frecuentes sobre paneles, gráficos e informes de Azure DevOps.

Sintaxis de Markdown admitida

El widget Markdown admite características estándar de CommonMark, como:

  • Encabezados
  • Párrafos y saltos de línea
  • Citas en bloque
  • Regla horizontal
  • Resaltado (negrita, cursiva, tachado)
  • Tablas
  • Listas, ordenadas y sin ordenar
  • Vínculos
  • Imágenes
  • Escape de caracteres

Para obtener más información, consulte la guía de sintaxis para el uso básico de Markdown.

Por motivos de rendimiento, el widget Markdown no agrega compatibilidad con muchas características extendidas, muchas de las cuales se admiten en la wiki. Las funcionalidades extendidas impedirían el tiempo de carga del widget. Por ejemplo, las siguientes características extendidas de Markdown no se admiten en el widget de Markdown:

  • Sintaxis HTML insertada
  • Resaltado de código (wiki/otros admiten codificación de colores compatible con la sintaxis del lenguaje, CommonMark solo representa el código como texto con formato preformato sin formato sin formato)
  • Listas de verificación
  • Caracteres emoji
  • Datos adjuntos
  • Fórmulas matemáticas

Adición del widget Markdown

Siga estos pasos para agregar el widget Markdown. Para añadir un cuadro de mando, consulte Agregar, cambiar el nombre y eliminar cuadros de mando.

  1. Inicie sesión en el proyecto (https://dev.azure.com/{Your_Organization/Your_Project}).

  2. Seleccione Paneles.

  3. Seleccione Editar. Se abre automáticamente el catálogo de widgets.

  4. Agregue o arrastre el widget Markdown al panel donde quiera que se encuentre.

    Captura de pantalla que muestra el widget Markdown.

  5. Seleccione Edición finalizada para salir de la edición del panel. Esta acción descarta el catálogo de widgets. Después, puede configurar el widget Markdown según sea necesario.

  6. Seleccione más acciones >icono de engranajeConfigurar.

    Captura de pantalla que muestra tres puntos para más acciones y el botón Configurar resaltado.

  7. (Opcional) Ajuste el tamaño del widget según sea necesario para ajustarse al contenido de Markdown. El tamaño más grande es de 10 mosaicos anchos por 10 mosaicos altos. Siempre puede ajustar el tamaño más adelante.

  8. Escriba texto y sintaxis de Markdown en el cuadro de diálogo de configuración. Para obtener la sintaxis admitida, consulte Instrucciones de sintaxis para archivos, widgets, wikis y comentarios de solicitud de incorporación de cambios.

    Captura de pantalla que muestra el cuadro de diálogo de configuración del widget de Markdown.

    Nota:

    • No se admiten vínculos a documentos en recursos compartidos de archivos mediante file://. Esta restricción se implementa con fines de seguridad.
    • Para vincular a una página wiki, use la sintaxis siguiente:
      /ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName
    • Para vincular a un archivo de repositorio, página o imagen dentro del proyecto, elija Seleccionar un archivo markdown, elija su Repositorio, Rama y Ruta de acceso en los menús desplegables.

  9. Guarda tus cambios.

  • Last updated on