Markdown es un lenguaje de marcado ligero. Su creador quería conseguir su máxima legitimidad. Es una tecnología de texto plano que se centrara más en el contenido.
Markdown se ha vuelto el formato estándar para desarrollar la documentación de las librerías y proyectos. Podemos obtener información en los siguientes enlaces.
- https://markdown.es/
- https://www.markdownguide.org/ (sitio no oficial)
- https://joedicastro.com/pages/markdown.html (guía)
- https://dillinger.io/ (editor Markdown en línea)
Nota: Es muy importante aprender esta tecnología. Hay un State Site Generator denominado Sergey, cuya página web es http://sergey.cool, otro denominado Hugo, cuyo sitio web es http://gohugo.io.
Sintaxis Encabezado
El documento principal se suele llamar README.md.
- #Aprendiendo _Markdown_ (la almohadilla representa un encabezado de nivel 1 HTML) (un texto entre guiones bajos indica que esa palabra está en cursiva).
Como generar párrafos
Se empieza a escribir simplemente
- Esto es un párrafo
Para varios párrafos escribir el primer párrafo y hacer clic en Enter para que haya una separación, así de sencillo.
Para aplicar cursiva
_cursiva_
Para negrita
**negrita**
Aplicar ambos
**_cursiva y negrita-**
Encabezados
- # Encabezado 1
- ## Encabezado 2
- ### Encabezado 3
- #### Encabezado 4
- ##### Encabezado 5
- ###### Encabezado 6
Hay que dejar espacio para que lo considere encabezado. Sólo hay 6 niveles de encabezado
Crear enlaces
Se utilizan corchetes y paréntesis. En los corchetes ponemos el texto que queremos se visualice. y en el paréntesis el enlace en cuestión.
[Sutil Web](https://sutilweb.eu)
Si queremos armar un temario:
La sintaxis sería
[Aprendiendo _Markdown_](#Aprendiendo-Markdown)
Si hay varias palabras, el separador entre ellas es el guión medio (–). No se pueden dejar espacios.
Agregar imágenes
Se utilizan igualmente corchetes y paréntesis. Para ir a una imagen en cuestión
[Imagen](https://rutadelaimagen.html)
Para insertar un imagen se utiliza el signo de exclamación.
Utilizar divisiones
Son 3 guiones medios
Este es un texto --- Este es otro párrafo
En HTML se usa la etiqueta <hr>
Listas
Listas con números
La sintaxis es
1. Primavera 1. Verano 1. Otoño 1. Invierno
Listas con viñetas
Se pueden utilizar asteriscos o guiones medios
* Primavera * Verano * Otoño * Invierno
o
- Primavera - Verano - Otoño - Invierno
Para crear una sub lista nos ayudamos de la indentación.
Citas
En HTML se utiliza <blockquote>. En Markdown se utiliza el símbolo mayor que (>) para una cita en línea, para una cita de bloque
/* CITA EN LÍNEA */ > Siempre tienes opción de no tener opinión /* CITA EN BLOQUE */ > Todo lo que escuchamos es una opinión, no un hecho > > Todo lo que vemos es una perspectiva, no la realidad > > Marco Aurelio
Dibujar tablas
Se utiliza |. por ejm.
| Nombre | Edad | Correo | | --- | --- | --- | | Francisco | Paredes | Parralejo |
Bloques de código
Pueden ser en linea o en bloque. Se utiliza el acento grave (`).
Hola, soy FranciscoParedesPara un código en bloque se utilizan 3 acentos graves, veamos la siguiente sintaxis
``` 3 + 4 = 12 12 ```
o
``` js
function sumar(a, b) {
return a + b;
}
```o
``` php
function sumar(a, b) {
return a + b;
}
```Etiquetas HTML
Todas las etiquetas HTML son reconocidas en Markdown.
Comentarios
La manera es la misma que en HTML
- <!– –>
Imprimir en pantalla
Los caracteres de escape son (\) como en el resto de lenguajes de programación.