Chuleta de Markdown

Agenda no es un editor de markdown, pero sí reconoce algo de sintaxis markdown para aplicar estilos. Estos son los atajos de markdown que pueden usarse.

Estilos de párrafo

Los siguientes estilos cambian el aspecto de todo el párrafo.

Encabezado

Usa de 1 a 6 símbolos de almohadilla al principio de la línea, seguidos de un espacio. El nivel del encabezado viene dado por el número de almohadillas. P. ej. ### Ejemplo produce un encabezado de tercer nivel.

Lista con guiones o viñetas

Empieza una línea con una viñeta, un guion, un asterisco o un signo más para crear un elemento de lista con guiones. P. ej. • Elemento de ejemplo 1 - Elemento de ejemplo 2 * Elemento de ejemplo 3 + Elemento de ejemplo 4 produce un elemento de lista con guiones o viñetas.

Lista numerada

Empieza una línea con un número seguido de un punto y un espacio para crear un elemento de lista numerada. P. ej. \1. Elemento de ejemplo 1 produce un elemento de lista numerada.

Para empezar una lista numerada en un número distinto de 1, basta con usar ese número P. ej. \3. Elemento de ejemplo 3 produce un elemento de lista numerada que empieza en 3.

Lista de comprobación

Empieza una línea con un guion seguido de un corchete de apertura y otro de cierre. Insertar una «x» entre ambos corchetes crea un elemento marcado. P. ej. - [ ] Ejemplo produce un elemento de lista de comprobación.

- [x] Ejemplo produce un elemento marcado.

El guion es opcional, así que también puedes crear una casilla usando solo dos corchetes.

Preformateado

Para el contenido que queda mejor con una tipografía de ancho fijo, como el código informático, puedes aplicar el estilo preformateado. Puedes activar este estilo empezando la línea con tres comillas invertidas. P. ej. ```ejemplo produce ejemplo

Código

Agenda admite el coloreado de sintaxis del código informático. Añadiendo el lenguaje después de las tres comillas invertidas puedes indicar en qué lenguaje se escribió el fragmento de código. P. ej. ```swift int i = 0; produce int i = 0 coloreado según el lenguaje Swift

El proyecto highlight.js mantiene una lista completa de todos los parámetros de lenguaje admitidos en https://github.com/highlightjs/highlight.js/blob/main/SUPPORTED_LANGUAGES.md.

Cita en bloque

Usa uno o más símbolos > al principio de la línea, seguidos de un espacio. El número de caracteres > determina el nivel de la cita, indicado por las líneas verticales que preceden al texto. P. ej. > Ejemplo produce

Ejemplo

Estilos en línea

Estos estilos se usan dentro de los párrafos para cambiar el aspecto del texto.

Cursiva

Encerrar el texto entre guiones bajos o asteriscos da estilo cursivo. P. ej. _ejemplo_ o *ejemplo* produce ejemplo

Negrita

Encerrar el texto entre dobles guiones bajos o dobles asteriscos da estilo negrita. P. ej. __ejemplo__ o **ejemplo** produce ejemplo

Tachado

Encerrar el texto entre dobles virgulillas da estilo tachado. P. ej. ~~ejemplo~~ produce ejemplo

Ancho fijo (monoespaciado)

Para algunos contenidos, como el código fuente informático, es preferible tener texto de ancho fijo. Para bloques de texto, lo mejor es usar el estilo de párrafo Preformatted. Para texto en línea, puedes encerrarlo entre comillas invertidas. P. ej. `ejemplo` produce ejemplo

Resaltado

Encerrar el texto entre dobles signos de igual o dobles dos puntos da estilo resaltado. P. ej. ==ejemplo== o ::ejemplo:: resalta la palabra ejemplo

Insertar

Algunos estilos no están relacionados con el significado del texto, sino que se usan para delimitar elementos informativos como las etiquetas. Estos también pueden introducirse con una sintaxis parecida a markdown.

Etiquetas

Para introducir una etiqueta, basta con usar un símbolo # seguido de la etiqueta. La etiqueta no puede contener espacios. P. ej. Escribe #giraffes para crear una etiqueta llamada «giraffes».

Al escribir un # se abrirá el popover de autocompletado para ayudarte a encontrar la etiqueta que buscas.

Las etiquetas también pueden contener un parámetro entre paréntesis. Por ejemplo, #due(12/12/2018). Para saber más sobre cómo sacar todo el partido a los parámetros de las etiquetas, consulta el capítulo Etiquetas, personas, acciones de texto y enlaces.

Etiquetas de persona

Agenda reconoce un segundo tipo de etiqueta reservado para individuos (personas). Puedes introducir un nombre o unas iniciales para referirte a un amigo o compañero. Basta con poner un símbolo @ delante del texto. P. ej. Escribe @Tom para crear una etiqueta de persona para alguien llamado «Tom».

Al escribir un @ se abrirá el popover de autocompletado para ayudarte a encontrar la persona que buscas.

Emoji

Para introducir un emoji, basta con escribir un : (dos puntos), seguido de la abreviatura del emoji y otros : de cierre. P. ej. Escribe :+1: para insertar el emoji 👍.

Al escribir un : se abrirá el popover de autocompletado para ayudarte a encontrar el emoji que buscas.

Línea horizontal

Si quieres delimitar visualmente secciones dentro de tus notas con una línea horizontal, puedes hacerlo escribiendo tres guiones seguidos y un espacio: P. ej. Escribe --- para crear una línea horizontal.

Consejo: Si estás importando un archivo markdown, puedes hacer que se divida en notas individuales en Agenda usando esos mismos tres guiones seguidos: P. ej. Primera nota --- Segunda nota

Esto creará dos notas distintas, la primera con el contenido «Primera nota» y la segunda con el contenido «Segunda nota».

Tablas

Agenda te da la posibilidad de insertar tablas en tus notas, que puedes crear rápidamente escribiendo tres o más barras verticales (|) seguidas al principio de la línea: P. ej. Escribe ||| para insertar una tabla.

Enlaces

Los enlaces se reconocen automáticamente en el texto, pero también puedes añadirlos con sintaxis markdown. Usa corchetes para encerrar el texto que se muestra, seguidos de paréntesis que encierren la URL del enlace. P. ej. Escribe [Agenda](agenda.com) para crear un enlace a agenda.com asociado al texto «Agenda».

Acciones de texto

Aunque no forman parte estrictamente de la sintaxis markdown clásica, Agenda permite activar determinadas acciones si empiezas escribiendo una barra invertida \ seguida de una acción.

Por ejemplo, \remind activará la inserción de un recordatorio en tu nota. Pueden proporcionarse parámetros opcionales como parte de la acción; por ejemplo, \remind(today at noon) programará un recordatorio para hoy a mediodía. Otras acciones habituales son \now, \date y \time, para insertar la fecha y la hora actuales.

Para ver un resumen completo de todas las acciones, consulta el capítulo Chuleta de acciones de texto.

Las acciones también pueden usarse como marcadores de posición en las plantillas; consulta el capítulo Crear y usar plantillas.

Evitar el análisis de markdown

Aunque los atajos de markdown pueden resultar muy útiles y rápidos, hay veces en que quizá no quieras que algo se reconozca como markdown. Puedes escapar las secuencias markdown anteriores escribiendo primero una barra invertida \ y luego lo que escribirías normalmente. Al pulsar un espacio, la barra invertida debería desaparecer automáticamente y el texto debería quedarse tal y como lo escribiste. Por ejemplo, escribir \1. Algo no dará como resultado una lista numerada, sino el texto 1. Algo.

Ten en cuenta que el markdown nunca se analiza dentro de texto que tiene el estilo de párrafo Preformatted ni el estilo en línea Fixed Width.