Compartir a través de

Adición de Markdown a un panel

  • Artículo

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

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

  • Acceso:
    • Cualquier persona con acceso al proyecto , incluyendo partes interesadas , puede ver los paneles.
    • Al menos acceso básico, o permisos de panel específicos.
  • Permisos:
    • Paneles de equipo: para agregar, editar o administrar un panel de equipo, cumpla los siguientes requisitos:
      • Ser miembro del equipo.
      • Ser miembro del grupo Administradores de proyecto.

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 se muestran en un widget de resultados de consulta en el panel. Para obtener más información, consulte Preguntas más frecuentes sobre el uso de paneles.

Sintaxis de Markdown admitida

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

  • Encabezados
  • Párrafos y saltos de línea
  • Blockquotes
  • 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)
  • Checklists
  • 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.