Guía para escribir en internet con MarkDown

Markdown está diseñado para escribir textos legibles de una manera sencilla, una de sus principales ventajas es que se guarda en texto plano por lo que puede ser editado desde cualquier aplicación en cambio si creamos un documento Word y lo abrimos desde el bloc de notas, no se podrá distinguir el contenido. Si quieres formar parte de esta generación de revistas y publicaciones online o simplemente si quieres ampliar tus conocimientos quédate y lee hasta el final. Para este tutorial te recomiendo que tengas a la mano alguna herramienta para poder ver el resultado, puedes usar **Visual Studio Code** o usar el editor online [StackEdit](https://stackedit.io). Veamos un ejemplo para entender un poco la sintaxis. ``` ## Título ### Subtítulo Lista genérica: - Rojo - Azul - Amarillo Lista numerada: 1. Javascript 2. Python 3. C++ Al texto en Markdown puedes añadirle formato como **negrita** o *cursiva* de una manera muy sencilla, e incluso ambas ***negrita cursiva***. ``` ## Párrafos Este lenguaje de marcado no soporta dos líneas en blanco consecutivas, si escribimos más de una será ignorada. Para escribir un nuevo párrafo solo necesitas dejar una línea en blanco de por medio. Si en cambio lo que quieres es cortar una frase para que aparezca en otra línea pero siendo parte del mismo párrafo, simplemente debes dejar dos espacios al final. Por ejemplo si quisieras escribir el siguiente peoma, donde cada verso finaliza con dos espacios. ``` "Ya brota el árbol binario, viejo, sabio, milenario, que planté para soñar, en un terreno no agrario: un disco duro y precario que se ha de formatear." ``` > Tomado de [www.taringa.net](https://www.taringa.net/+offtopic/poemas-informaticos-neeerrrddd_i1455) ## Títulos o encabezados Los numerales # son la forma de escribir títulos en markdown, ejemplo: ``` # Cuba ## Las Tunas ### Tunas #### Reparto Médico ##### Edificio 114 ###### Apartamento 15 ``` También puedes generar un encabezado 1 poniendo al menos un igual = debajo de tu texto, o un operador de resta - para un encabezado 2. ``` Hola Mundo = Cómo hacerlo en C++ ----- ``` ## Citas Las citas se generan utilizando el carácter mayor > al comienzo de un bloque. ``` > Lo peor que hacen los malos es obligarnos a dudar de los buenos. (Jacinto Benavente) ``` Si son varios párrafos debes colocar el mayor que delante de cada uno. ``` > Cada día sabemos más y entendemos menos. > Dar el ejemplo no es la principal manera de influir sobre los demás; es la única manera. (Albert Einstein) ``` ## Listas Genéricas Pordemos crear listas con los caracteres `*`, `+` y `-`, incluso usar varios en una misma lista: ``` * Hello World - Hola Mundo + Olá mundo ``` Si necesitamos crear listas anidadas simplemente tenemos que usar cuatro espacios antes del próximo elemento de la lista. ``` * Albert Einstein * > El mundo no está en peligro por las malas personas sino por aquellas que permiten la maldad * > Hay dos cosas que son infinitas: el universo y la estupidez humana; de la primera no estoy muy seguro * Lao Tsé * > No hay que ir para atrás ni para darse impulso * > Si das pescado a un hombre hambriento lo nutres durante una jornada. Si le enseñas a pescar, le nutrirás toda su vida ``` Con el código anterior generamos una lista anidada que contiene citas. ## Listas Ordenadas Al igual que las genéricas puedes anidarlas o combinarlas. Estas deben comenzar con `1. ` ``` 1. Elemento 1 2. Elemento 2 - Elemento 3 hijo del 2 - Elemento 4 hijo del 2 1. Elemento 5 hijo del 4 2. Elemento 6 hijo del 4 3. Elemento 7 hijo del 4 ``` ## Bloques de Código Para incluir código necesitas colocar tres ~ o ` antes de tu bloque y al finalizar el mismo: ``` ~~~ def binarySearch (arr, l, r, x): if r >= l: mid = l + (r - l)/2 if arr[mid] == x: return mid elif arr[mid] > x: return binarySearch(arr, l, mid-1, x) else: return binarySearch(arr, mid+1, r, x) else: return -1 ~~~ ``` Generaría: ~~~ def binarySearch (arr, l, r, x): if r >= l: mid = l + (r - l)/2 if arr[mid] == x: return mid elif arr[mid] > x: return binarySearch(arr, l, mid-1, x) else: return binarySearch(arr, mid+1, r, x) else: return -1 ~~~ ## Links Los enlaces se escriben se escriben de la siguiente forma, entre [] va el texto que se mostrará y entre () el link. ``` [Blog Binary Coffee](https://binary-coffee.dev) ``` O se puede escribir directamente el enlace: ``` https://binary-coffee.dev ``` ## Imágenes Las imágenes tienen la siguiente estructura muy similar a los enlaces pero comienzan por `!`, si la imagen no existe se mostrará el texto que esta dentro de []. De lo contrario se mostrará la imagen correspondiente a la ruta o link especificado entre (). ```  ``` Markdown es muy usado para escribir en internet, y su popularidad incrementa cada día. Ejemplo de plataformas que lo usan son GitHub, Stackoverflow, Medium y nuestro blog solo por poner algunas. También existen cientos de herramientas para convertirlo de manera fácil a HTML, PDF, ePub, etc. Esperamos que el tutorial te haya servido para aprender o al menos tener una noción. > Keep calm and drink a Binary Coffee!