¿Qué es Markdown?
Markdown es un lenguaje de marcado de texto. Estos textos son fáciles de escribir y leer. Se pueden convertir fácilmente a HTML. La mayoría de los programadores prefieren Markdown para escribir documentación, descripciones de proyectos, blogs, etc.
¿Qué significa esto?
"Un lenguaje de marcado" es simplemente un conjunto de convenciones, reglas.
Supongamos que estás enviando mensajes de texto a un amigo. No puedes hacer que el texto esté en negrita o cursiva. Acuerdas con tu amigo: si escribo *algo* entre asteriscos, considera que es texto en cursiva. Y si escribo **algo** entre dos asteriscos, considera que es texto en negrita. Has creado reglas.
Markdown es un conjunto de reglas similares.
Las reglas son comprensibles para diferentes programas y sitios web. Por ejemplo, las "Preguntas y respuestas" en las lecciones de Códica admiten Markdown. Esto significa que puedes escribir textos allí siguiendo las reglas de Markdown, y después de hacer clic en "Enviar", el marcado se convertirá en realidad: el texto entre asteriscos se volverá cursiva, el texto entre dos asteriscos se volverá en negrita, y así sucesivamente. Esto es la conversión de Markdown a HTML.
¿Para qué se necesita esto?
- Para agregar formato donde no es posible el formato real. Por ejemplo, en un archivo de texto simple o en los mismos mensajes de texto donde no se puede resaltar en negrita, crear encabezados, resaltar citas, etc.
- Para escribir textos de manera más conveniente para su posterior conversión a HTML u otros formatos.
Sintaxis de Markdown
Aquí tienes una guía rápida de los elementos básicos de la sintaxis de Markdown. Existen varios "sabores" de Markdown, y pueden diferir en los detalles. Los más extendidos son la especificación CommonMark y GitHub Flavored Markdown (GFM), que está construido sobre ella. Los elementos básicos de la lista a continuación funcionan en prácticamente todos.
Resaltar texto
*Este texto estará en cursiva*
_Este texto estará en cursiva_
**Este texto estará en negrita**
__Este texto estará en negrita__
_Se pueden **insertar** un tipo dentro de otro_
Encabezados
# Este es el encabezado más grande, se convierte en la etiqueta <h1>
## <h2>
### <h3>
#### <h4>
##### <h5>
###### <h6>
Enlaces
https://codica.la/ — el texto de un enlace se convertirá automáticamente en un enlace clicable
En muchos editores y sitios (como GitHub) una dirección escrita así se convierte sola en enlace. En CommonMark estricto, para lograrlo hay que escribirla entre paréntesis angulares.
<https://codica.la/>
Puedes hacer que cualquier texto sea un enlace:
[Este es un enlace a Códica](https://codica.la/)
Citas
> Esta es una cita sabia
> de una persona sabia.
Imágenes
Código
Para resaltar código (o cualquier texto sin formato) se utilizan caracteres especiales: comillas invertidas: `
A veces necesitas agregar un fragmento de código `function(12);` en una línea de texto normal.
Y a veces necesitas insertar un bloque de código completo:
```javascript
const func = (num) => {
if (num > 0) {
return num - 1;
}
return num + 1;
};
```
Listas
Lista no numerada:
* Elemento
* Otro elemento
* Subelemento
* Otro subelemento
Lista numerada:
1. Elemento
1. Otro elemento
1. Subelemento
1. Otro subelemento
En una lista numerada puedes usar cualquier número, no importa. Al convertirlo a HTML u otro formato, los números serán correctos y secuenciales (1, 2, 3, etc.). Los subelementos deben tener una sangría igual al ancho del marcador, es decir, 3 espacios para las listas numeradas ("1. ") y 2 para las no numeradas ("* "). Con menos espacios, muchos programas no los anidan.
Markdown hoy
Markdown es el formato estándar de los archivos README.md de casi cualquier repositorio, de la documentación técnica y de muchos blogs. También es el formato en el que los asistentes de inteligencia artificial suelen entregar sus respuestas, con listas, encabezados y bloques de código, y es habitual usarlo para escribir archivos de instrucciones para esas herramientas.
GFM añade elementos muy usados. Por ejemplo, tablas, listas de tareas y texto tachado.
| Curso | Nivel |
| --- | --- |
| Git | Inicial |
- [x] Tarea hecha
- [ ] Tarea pendiente
~~Texto tachado~~
Más sobre Markdown
