Exploramos la sintaxis básica de Markdown con ejemplos y compartimos algunas buenas prácticas para dar formato al texto de manera efectiva
Markdown se basa en una sintaxis simple y legible que te permite aplicar formato al texto de manera rápida y sencilla. A continuación, te mostraremos algunas de las características básicas de Markdown y cómo utilizarlas.
Para crear encabezados en Markdown, utiliza el símbolo "#" seguido de un espacio y el texto del encabezado. El número de "#" indica el nivel del encabezado, siendo "#" para encabezados de nivel 1, "##" para nivel 2 y así sucesivamente. Aquí tienes un ejemplo:
Ejemplo:
Los párrafos en Markdown se crean simplemente escribiendo el texto sin ningún formato adicional. Deja una línea en blanco entre párrafos para separarlos:
Puedes agregar énfasis al texto utilizando asteriscos (*) o guiones bajos (_). Para texto en cursiva, encierra las palabras o frases entre un par de asteriscos o guiones bajos:
Texto en cursiva
Texto en cursiva
Para texto en negrita, utiliza dos asteriscos o guiones bajos:
Texto en negrita
Texto en negrita
Markdown admite listas ordenadas y no ordenadas. Para crear una lista no ordenada, simplemente utiliza asteriscos, guiones o signos más seguidos de un espacio:
Para listas ordenadas, utiliza números seguidos de un punto y un espacio:
Para crear enlaces en Markdown, utiliza la siguiente sintaxis:
Por ejemplo:
Para insertar imágenes, utiliza una sintaxis similar a la de los enlaces, pero con un signo de exclamación (!) antes:
Para crear citas o bloques de texto citado, utiliza el símbolo ">" al comienzo de la línea:
Puedes agregar líneas horizontales para separar secciones de tu documento utilizando tres guiones, tres asteriscos o tres signos más en una línea:
Se verá esta línea:
Si necesitas incluir un caracter especial que normalmente tendría un significado en Markdown, como un asterisco o un guión bajo, puedes escaparlo utilizando una barra invertida (\):
Markdown permite crear tablas de una manera sencilla y legible. Las tablas se crean utilizando barras verticales |
para delimitar las columnas y guiones -
para separar la fila de encabezados de las filas de datos. Aquí tienes un ejemplo:
Puedes utilizar bloques de código con resaltado de sintaxis para diferentes lenguajes. Especialmente para documentar código. Por ejemplo:
Esto mostrará el código con resaltado de sintaxis para JavaScript:
Markdown admite listas de tareas que son útiles para llevar un registro de tareas pendientes o completadas. Utiliza el signo menos -
, seguido de [ ]
para una tarea pendiente o [x]
para una tarea completada:
Puedes incluir citas con múltiples párrafos utilizando el símbolo >
al comienzo de cada párrafo de la cita:
Esto es una cita.
Esta es otra parte de la cita.
Algunas implementaciones de Markdown, como GitHub Flavored Markdown (GFM), admiten comentarios que no se mostrarán en el documento final. Puedes utilizar <!--
para iniciar un comentario y -->
para finalizarlo:
Markdown también admite notas al pie para añadir explicaciones o referencias a pie de página. Esto varía según la implementación, pero un ejemplo podría ser:
Y luego puedes referenciarlo en el texto principal como[^1].
Estas son algunas de las características avanzadas de Markdown que puedes utilizar para dar formato a tu contenido de manera efectiva. Con estas herramientas, puedes crear documentos más complejos y estructurados.
Algunas recomendaciones a tener en cuenta: