Markdown es un lenguaje de marcado sencillo que sirve para agregar formato, vínculos e imágenes con facilidad al texto simple. Se puede utilizar en los siguientes lugares:
- Comentarios de ticket (desde la interfaz del usuario)
- Macros
- Firmas de agentes
- Contenido dinámico
- Bloques de contenido en los artículos del centro de ayuda
Los comandos de Markdown son admitidos por el editor de tickets de manera automática. Se pueden ingresar comandos de Markdown para formatear el contenido o, si se prefiere, se puede usar la barra de herramientas de formato para agregar contenido enriquecido. Consulte la Tabla 1 a continuación para ver qué comandos de Markdown son admitidos.
Temas que se tratan en este artículo:
Agregar Markdown al texto
En la tabla siguiente se muestran ejemplos de cómo se puede usar Markdown para agregar formatos comunes. No es necesario previsualizar el formato aplicado, ya que el contenido se va formateando automáticamente a medida que se van introduciendo los comandos de Markdown.
También puede ver este video corto:
Formato | Texto ingresado | Texto publicado | Comentarios |
---|---|---|---|
Negrita | Así se escribe el texto en **negrita**. | Admitido | |
Cursiva | Así se escribe el texto en *cursiva*. | Admitido | |
Listas con viñetas | * Viñeta uno (no olvide el espacio después del asterisco)
* Viñeta dos Debe escribir un salto de línea antes y después de la lista. |
Admitido. También se puede comenzar con un guión (-) seguido de un espacio para crear una lista con viñetas. | |
Listas numeradas | 1. Paso uno
2. Paso dos No utilice un hashtag (#) al crear listas numeradas en Markdown, ya que ese símbolo se usa para otros tipos de formato. Debe escribir un salto de línea antes y después de la lista. |
Admitido | |
Listas anidadas | * Este es el primer nivel de esta lista.
Además de texto, puede agregar cosas como imágenes, citas en bloque o vínculos a una lista anidada. Debe escribir un salto de línea antes y después de la lista. |
Admitido, excepto para los bloques de contenido. Para el segundo nivel de sangría, presione la tecla Tab después de la lista con viñetas o la lista numerada. | |
Encabezados | # Encabezado nivel uno (con un espacio después de #)
# # Encabezado nivel dos # # # Encabezado nivel tres |
Admitido. Hasta cuatro niveles de encabezados. Hasta seis niveles de encabezados en los bloques de contenido. | |
Citas en bloque |
> Las citas en bloque deben comenzar y terminar con una línea en blanco > Y cada línea de la cita comienza con un corchete angular de cierre y un espacio
|
Admitido | |
Código en línea | Este es un ejemplo de "código en línea". | Admitido | |
Bloques de código | ```
Este es un ejemplo de un bloque de código. ``` Si se crea una línea en blanco y luego se sangra la línea o las líneas siguientes con cuatro espacios, se crea también un bloque de código. Debe escribir un salto de línea antes y después del bloque de código. |
Admitido. Para salir de un bloque de código colocado al final de un comentario, presione la tecla Intro tres veces seguidas. | |
Imágenes | ![Texto alternativo opcional si no se carga la imagen](http://www.sampleurl.com/logo.png)
Observación: Para incrustar una imagen que no está alojada, primero adjunte la imagen al ticket. Luego abra el archivo adjunto, haga clic con el botón derecho en la imagen, seleccione Copiar URL de imagen y utilice este vínculo para incrustar la imagen. No funciona si los archivos adjuntos privados están activados.
|
Admitido, excepto para los bloques de contenido. Cuando se agrega un URL de imagen, se convierte automáticamente en un vínculo de imagen. Cuando se envía el comentario del ticket, la imagen aparece en el registro de conversaciones.* | |
Vínculos | [Texto para mostrar en el vínculo](http://www.sampleurl.com) | Admitido en las firmas de agentes* | |
Imágenes que también son vínculos | [![texto alternativo](imageurl)](linkurl) | Admitido en las firmas de agentes* | |
Vínculos a tickets | Esto lo tratamos en el ticket n.º 61. | No admitido, por el momento | |
Línea de regla horizontal |
--- Debe agregar un salto de línea antes y después de los guiones. Si tiene tres o más guiones bajo una línea de texto, sin espacio en blanco entre ellos, en lugar de crear una regla horizontal debajo del texto, el texto de arriba se convertirá en un encabezado. |
|
Admitido |
Salto de línea |
Línea 1 Línea 2 Debe insertar dos saltos de línea antes de cada . |
Línea 1
Línea 2 |
No admitido, excepto para los bloques de contenido. En los bloques de contenido, escriba Mayús+Intro para agregar un salto de línea. |
Carácter de subrayado | Así se agrega un carácter de \_subrayado\_ al texto. | Así se agrega un carácter de subrayado al texto. | Admitido solo en los bloques de contenido. |
* Cuando ingrese los URL para vínculos e imágenes, asegúrese de incluir el URL completo, junto con el prefijo http:// o https://. |
Pegar texto de Markdown de otra fuente
Los siguientes son algunos aspectos que debe tomar en cuenta a la hora de copiar texto de Markdown de otra fuente y pegarlo en el redactor de ticket:
- Si copia texto con comandos de Markdown de un editor de texto sin formato, el contenido se formatea automáticamente en cuanto se pega. Si prefiere que el contenido no se formatee automáticamente, use Cmd+Mayús+V (Mac) o Ctrl+Mayús+V (Windows) para pegarlo.
- Si pega texto con los comandos de Markdown desde un editor de texto enriquecido, los comandos de Markdown quedan intactos. El contenido no se formatea automáticamente.
- Si copia texto con los comandos de Markdown desde cualquier tipo de editor en un bloque de código en el redactor de ticket, el contenido no se formatea automáticamente, es decir, queda intacto.
- Si pega texto de Markdown con bloques de código o listas anidadas, el formato no se transfiere automáticamente al redactor de tickets.