Uso de un icono de Markdown en los paneles de Azure para mostrar contenido personalizadoUse a markdown tile on Azure dashboards to show custom content

Puede agregar un icono de Markdown a los paneles de Azure para mostrar contenido estático y personalizado.You can add a markdown tile to your Azure dashboards to display custom, static content. Por ejemplo, puede mostrar instrucciones básicas, una imagen o un conjunto de hipervínculos en un icono de Markdown.For example, you can show basic instructions, an image, or a set of hyperlinks on a markdown tile.

Incorporación de un icono de Markdown al panelAdd a markdown tile to your dashboard

  1. Seleccione Panel en la barra lateral de Azure Portal.Select Dashboard from the Azure portal sidebar.

    Captura de pantalla que muestra la barra lateral del portal

  2. Si ha creado algún panel personalizado, en la vista del panel, seleccione el panel donde debe aparecer el icono de Markdown personalizado de la lista desplegable.If you've created any custom dashboards, in the dashboard view, use the drop-down to select the dashboard where the custom markdown tile should appear. Seleccione el icono de edición para abrir la Galería de iconos.Select the edit icon to open the Tile Gallery.

    Captura de pantalla de la vista de edición del panel

  3. En la Galería de iconos, busque el denominado Markdown y seleccione Agregar.In the Tile Gallery, locate the tile called Markdown and select Add. Este icono se agregará al panel y el panel Editar Markdown se abrirá.The tile is added to the dashboard and the Edit Markdown pane opens.

  4. Escriba los valores de título y subtítulo que se muestran en el icono después de moverse a otro campo.Enter values for Title and Subtitle, which display on the tile after you move to another field.

    Captura de pantalla que muestra los resultados de escribir el título y el subtítulo

  5. Seleccione una de las opciones para incluir contenido Markdown: Edición directa o Insertar contenido mediante URL.Select one of the options for including markdown content: Inline editing or Insert content using URL.

    • Seleccione Edición directa si quiere escribir contenido Markdown directamente.Select Inline editing if you want to enter markdown directly.

      Captura de pantalla que muestra cuando se escribe contenido insertado

    • Seleccione Insertar contenido mediante URL si quiere usar contenido Markdown existente hospedado en línea.Select Insert content using URL if you want to use existing markdown content that's hosted online.

      Captura de pantalla que muestra cuando se escribe a través de URL

      Nota

      Para mayor seguridad, puede crear un archivo Markdown y almacenarlo en un blob de cuenta de Azure Storage con el cifrado habilitado y, después, apuntar al archivo mediante la opción de dirección URL.For added security, you can create a markdown file and store it in an Azure storage account blob where encryption is enabled, then point to the file using the URL option. El contenido Markdown se cifra mediante las opciones de cifrado de la cuenta de almacenamiento.The markdown content is encrypted through the storage account's encryption options. Solo los usuarios con permisos para el archivo pueden ver el contenido Markdown en el panel.Only users with permissions to the file can see the markdown content on the dashboard. Puede que necesite establecer una regla de uso compartido de recursos entre orígenes (CORS) en la cuenta de almacenamiento para que Azure Portal ( https://portal.azure.com/ ) pueda acceder al archivo Markdown en el blob.You might need to set a cross-origin resource sharing (CORS) rule on the storage account so that the Azure portal (https://portal.azure.com/) can access the markdown file in the blob.

  6. Seleccione Listo para descartar el panel Editar Markdown.Select Done to dismiss the Edit Markdown pane. El contenido aparece en el icono de Markdown, cuyo tamaño puede cambiarse al arrastrar el manipulador de la esquina inferior derecha.Your content appears on the Markdown tile, which you can resize by dragging the handle in the lower right-hand corner.

    Captura de pantalla del icono de Markdown personalizado

Funcionalidades y limitaciones del contenido de MarkdownMarkdown content capabilities and limitations

En el icono de Markdown puede usar cualquier combinación de texto sin formato, la sintaxis de Markdown y contenido HTML.You can use any combination of plain text, Markdown syntax, and HTML content on the markdown tile. Azure Portal usa una biblioteca de código abierto denominada marked para transformar el contenido en HTML que se muestra en el icono.The Azure portal uses an open-source library called marked to transform your content into HTML that is shown on the tile. El código HTML generado por marked se procesa previamente en el portal antes de representarse.The HTML produced by marked is pre-processed by the portal before it's rendered. Este paso ayuda a garantizar que la personalización no afecta a la seguridad o al diseño del portal.This step helps make sure that your customization won't affect the security or layout of the portal. Durante ese procesamiento previo, se quita cualquier parte del código HTML que suponga una posible amenaza.During that pre-processing, any part of the HTML that poses a potential threat is removed. En el portal no se permiten los siguientes tipos de contenido:The following types of content aren't allowed by the portal:

  • JavaScript: las etiquetas <script> se quitarán, así como las evaluaciones de JavaScript insertadas.JavaScript – <script> tags and inline JavaScript evaluations will be removed.
  • iframes: las etiquetas <iframe> se quitarán.iframes - <iframe> tags will be removed.
  • Style: las etiquetas <style> se quitarán.Style - <style> tags will be removed. Oficialmente no se admiten los atributos de estilo insertados en los elementos HTML.Inline style attributes on HTML elements aren't officially supported. Quizá algunos elementos insertados le pudieran ser de ayuda, pero si afectan al diseño del portal, dejarían de funcionar en cualquier momento.You may find that some inline style elements work for you, but if they interfere with the layout of the portal, they could stop working at any time. El icono de Markdown está pensado para contenido estático básico que usa los estilos predeterminados del portal.The Markdown tile is intended for basic, static content that uses the default styles of the portal.

Pasos siguientesNext steps