Binary Coffee

Guía para escribir en internet con MarkDown

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 (). ``` ![Texto](/ruta/a/la/imagen.jpg) ``` 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!
Opiniones
noavatar
Muy util el articulo.