Markdown

¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero que permite dar formato a texto de manera sencilla y legible.
Se basa en una sintaxis muy simple, utilizando caracteres comunes como #, * o -, lo que hace que el texto sea fácil de leer incluso sin ser procesado.

En otras palabras, un archivo .md se puede entender como texto plano, pero al renderizarlo se convierte en contenido con estilo como títulos, listas, enlaces o imágenes.

¿Para qué sirve?

Markdown se utiliza para crear documentos con formato sin necesidad de herramientas complejas.
Es ideal para:

Documentación técnica y manuales.
Archivos README.md en proyectos de software.
Blogs y publicaciones en la web.
Notas personales y apuntes.
Creación de contenido para plataformas como GitHub, GitLab, Reddit o Stack Overflow.

Es muy popular en el desarrollo de software por su simplicidad y compatibilidad con múltiples herramientas.

¿Cómo funciona?

Markdown funciona al traducir texto plano con sintaxis específica a HTML u otros formatos visuales.
Esto se logra porque los caracteres especiales (#, **, >, etc.) indican al procesador cómo interpretar el texto.

¿Por qué usar?

Algunas ventajas clave de Markdown:

Simplicidad:
Es fácil de aprender y usar, incluso para principiantes.
Legibilidad:
El texto se entiende tanto en su forma original como procesado.
Portabilidad:
Funciona en múltiples plataformas y herramientas, como GitHub, VSCode o Notion.
Versatilidad:
Puede generar HTML, PDF y otros formatos.
Ligero y rápido:
No necesita software pesado, solo un editor de texto.

En resumen, Markdown es ideal cuando quieres crear contenido estructurado y limpio, sin complicarte con herramientas avanzadas de edición.

Temas

inicio
Sintaxis Básica
Otros artículos

Sintaxis Básica

Énfasis texto

El énfasis se utiliza para resaltar palabras o frases en el texto.

Markdown	Resultado
`_texto_`	cursiva
`texto`	negrita
`_texto_`	*cursiva y negrita*
`~~texto~~`	~~Tachado~~
`<ins>texto</ins>`	Subrayar
`<sub>texto</sub>`	_subíndice
`  `	2 espacios

Encabezado

Los encabezados se crean usando #.
Cuantos más #, menor nivel de encabezado (de 1 a 6).

Tip: Mantén un espacio entre el # y el texto.

N°	Markdown	Encabezado
1	#	Título principal
2	##	Tema del documento
3	###	Sección de un tema
4	####	Apartado de la sección
5	#####	Ejemplo del apartado
6	######	Sub-Apartado del Ejemplo

🔼 temas

Párrafos y saltos de línea

Para generar un nuevo párrafo en Markdown simplemente separa el texto mediante una línea en blanco.
Los párrafos cortos son aquellos párrafos que tienen entre tres y seis líneas. Si bien existen párrafos más extensos, que pueden llegar hasta las veinte líneas, lo recomendable es que un párrafo no tenga más de cuatro o cinco oraciones.

Citas

Las citas se crean con el carácter > al inicio de la línea.
Para anidar citas, se agrega otro >> adicional.

> Citas Anidadas

>> Siempre tienes opción de no tener opinión. - Marcos Aurelio.
>> Todo lo que escuchamos es una opinión, no un hecho.
>> Todo lo que vemos es una perspectiva, no la verdad.

>>> Marcos Aurelio

> Alertas

>> [!NOTA] Información útil que los usuarios deben conocer.
>> [!IMPORTANT] Información clave que los usuarios deben conocer.
>> [!WARNING] Información urgente que requiere la atención del usuario.
>> [!PRECAUCIÓN] Advierte sobre los riesgos.

🔼 temas

Listas

Listas desordenadas

Se crean usando -, * o + antes de cada elemento.

Elemento de lista
- Elemento de lista Anidada
  - Elemento de lista Anidada 2
  - Elemento de lista Anidada 2
- Elemento de lista Anidada
- Elemento de lista Anidada
Elemento de lista

Listas ordenadas

Se crean con números seguidos de un punto (1.).

Elemento de lista 01
Elemento de lista 02
- Elemento de lista
  1. Elemento de lista 01
  2. Elemento de lista 02
  3. Elemento de lista 02
1. Elemento de lista 01
Elemento de lista 03

Listas tareas

[x] #739
[ ] https://github.com/octo-org/octo-repo/issues/740
[ ] Add delight to the experience when all tasks are complete :tada:

Reglas horizontales

Se crean con tres o más * , - o _ en una línea para separar secciones de una manera visual.

`*3`	`-3`	`_3`
`***`	`---`	`___`

🔼 temas

links

Los enlaces se crean con la siguiente sintaxis:
[Texto visible](https://ejemplo.com "título emergente")

Enlace Markdown	Resultado
`< link_linea >`	https://www.markdownguide.org
`[ referencia ]( link )`	Markdown Guide
`[ referencia ]( #titulo )`	#Markdown
`[ referencia ]( #titulo "hover" )`	#Markdown

Documentación Markdown: Documentación Github

Códigos

En línea

Úsalo para fragmentos cortos de código rodeando el texto con ` (backtick).

Aquí un ejemplo de console.log("Hola mundo");

En bloque

Para bloques de código más extensos, utiliza tres backticks y opcionalmente especifica el lenguaje para resaltar la sintaxis.
```lenguaje

    Comenzar con cuatro espacios en blanco

```js
  function sumar(a, b) {
    return a + b; }
```

<pre> Texto pre-formateado
  <pre> Pre anidado </pre>
  <pre> Pre anidado </pre>
</pre>

🔼 temas

Imagines

La sintaxis es similar a los enlaces, pero con un ! al inicio y Imagen con título

![Referencia/Texto alternativo](Ruta/Link)
![JavaScript](ruta/a/la/imagen.svg)
![JavaScript](https://JavaScript-svg.com)

Tablas

Las tablas se crean utilizando | y -.

Tip: Alinea columnas con :- | :-: | -:

Lenguaje	Uso principal	Dificultad
HTML	Estructura web	Fácil
CSS	Estilos visuales	Fácil
JS	Interactividad web	Medio

Formulario

Markdown estándar no incluye formularios nativos, pero puedes usar HTML dentro de Markdown.

🔼 temas