Markdown - El lenguaje de marcado ligero!

Una guía sencilla y práctica sobre el uso de markdown en nuestros proyectos.

Síguenos con el tutorial

• En QuéPasalinux Markdown - El lenguaje de marcado ligero un vídeo práctico sobre Markdown

Volver a Página Principal

Ver Codigo en GitLab

✍️ Introducción a Markdown: El Lenguaje de Marcado Ligero

Markdown es un lenguaje de marcado ligero que te permite formatear texto plano de manera sencilla y rápida. Fue creado para que la gente pudiera escribir usando un formato de texto plano fácil de leer y escribir, y luego convertirlo a HTML para su visualización en la web. La magia de Markdown radica en su simplicidad: no necesitas complicadas etiquetas como en HTML, solo unos pocos caracteres especiales para dar formato a tus textos.

---

📜 Historia y Creador

Markdown fue creado en 2004 por John Gruber y Aaron Swartz. La principal motivación de Gruber fue crear una sintaxis que fuera intuitiva para el ser humano y que, al mismo tiempo, pudiera ser fácilmente convertida a HTML. Su diseño se basó en convenciones de formato de texto que la gente ya usaba en correos electrónicos y foros, como el uso de asteriscos para las negritas o guiones para las listas.

Aaron Swartz

John Gruber

---

✨ Características Principales y Etiquetas

Markdown es conocido por su sintaxis concisa. A continuación, se presentan las etiquetas más comunes y cómo usarlas.

📝 Encabezados (Headers)

Utiliza el símbolo de almohadilla (#) para los encabezados. El número de almohadillas determina el nivel del encabezado, desde 1 (el más grande) hasta 6.

# Encabezado 1
## Encabezado 2
### Encabezado 3
#### Encabezado 4
##### Encabezado 5
###### Encabezado 6

Ejemplo de Visualización:

Encabezado 1

Encabezado 2

Encabezado 3

Encabezado 4

Encabezado 5

Encabezado 6

🗣️ Enfasis (Negrita y Cursiva)

• Negrita: Utiliza dos asteriscos o dos guiones bajos. **negrita** o __negrita__
• Cursiva: Utiliza un asterisco o un guion bajo. *cursiva* o _cursiva_
• Negrita y Cursiva: Combina ambos. ***negrita y cursiva*** o ___negrita y cursiva___

🗒️ Listas

Puedes crear listas ordenadas y no ordenadas.

• Lista No Ordenada: Usa asteriscos (*), guiones (-) o signos de más (+).

  * Elemento 1
  * Elemento 2
      * Sub-elemento 2.1
      * Sub-elemento 2.2

  Ejemplo de Visualización:

  • Elemento 1
  • Elemento 2
    • Sub-elemento 2.1
    • Sub-elemento 2.2

• Lista Ordenada: Usa números seguidos de un punto.

  1. Primer elemento
  2. Segundo elemento
  3. Tercer elemento

🔗 Enlaces (Links)

Para crear un enlace, coloca el texto del enlace entre corchetes y la URL entre paréntesis.

    [Texto del enlace](https://www.ejemplo.com)

Ejemplo de Visualización: volver a página principal

🖼️ Imágenes

La sintaxis es similar a la de los enlaces, pero con un signo de exclamación al inicio. El texto dentro de los corchetes es el texto alternativo (alt text).

![Texto alternativo de la imagen](https://www.ejemplo.com/imagen.jpg)

Ejemplo de Visualización:

🖋️ Citas en Bloque (Blockquotes)

Usa el signo de mayor que (>) al inicio de una línea para crear una cita.

> "La vida es lo que pasa mientras estás ocupado haciendo otros planes."
> — John Lennon

Ejemplo de Visualización: “La vida es lo que pasa mientras estás ocupado haciendo otros planes.” — John Lennon

💻 Bloques de Código

• Código en línea: Usa un acento grave (backtick) al principio y al final del código. Esto es un ejemplo de código en línea.\

  `Esto es un ejemplo de `código en línea`.\`

• Bloques de código: Usa tres acentos graves (```) al principio y al final del bloque. Puedes especificar el lenguaje para un resaltado de sintaxis.

  def hola_mundo():
      print("Hola, mundo!")

---

📏 Línea Horizontal

Para crear una línea divisoria, utiliza tres guiones (---), asteriscos (***) o guiones bajos (___) en una línea.

---

---

🗑️ Tachar Texto

Utiliza dos virgulillas (~~) al principio y al final del texto que deseas tachar.

~~Texto tachado~~

Ejemplo de Visualización: Texto tachado

---

🌐 Referencias y Usos Comunes

Markdown se ha convertido en un estándar en el mundo del desarrollo y la documentación. Algunas de sus aplicaciones más comunes son:

• GitHub y GitLab: Para archivos README.md, wikis y comentarios.
• Blogs y Sistemas de Gestión de Contenidos (CMS): Muchos CMS modernos, como Ghost y Statamic, usan Markdown como su editor predeterminado.
• Foros y Plataformas de Q&A: Sitios como Stack Overflow utilizan Markdown para las preguntas y respuestas.
• Aplicaciones de Notas: Evernote, Joplin, y muchos otros usan Markdown para el formato de notas.

El uso de Markdown te permite centrarte en el contenido sin distraerte con el formato, haciendo que la escritura sea más eficiente y agradable.