Markdown para escritores
Tutorial básico para escritores que quieran utilizar markdown para escribir sus artículos, relatos o libros de una forma sencilla
En este artículo, se pretende contar lo básico, pues para un escritor seguramente resulte un choque cultural al llevar toda la vida escribiendo en un procesador de textos tipo word. Por eso vamos a intentar explicarlo de una forma muy sencilla, aunque ya veremos que realmente lo es.
Si buscamos en internet qué es Markdown en todas partes nos dirá que es un lenguaje de marcado ligero. En el fondo es texto plano, al que mediante marcas, le indicamos qué es un título, qué es texto normal, o qué va en cursiva o en negrita. Sin distracciones.
¿Y por qué es tan útil?
Cuando empecé a escribir este blog pensé en qué pasaría si me migrara a otra plataforma. ¿Perdería todos mis artículos? Y me dí cuenta de que los artículos deberían escribirse fuera de la plataforma en un sistema que me permitiese luego trasladarlos con facilidad a esta. Me debía dar igual si usaba Substack, WordPress, o mi propia web con Jekyll… Lo que hiciese debía ser sencillo, y fácil de migrar. Y pensé en markdown.
Al tratarse de texto plano, no es binario ni tampoco un formato propietario de ninguna marca. Es compatible al 100%. Da igual si usas Windows, LiNUX o Mac, si usas Word, Google Docs, Libre Office, etc… Este texto que escribo en markdown se podrá ver en todas partes, pues existen resaltados de sintaxis y visores para casi cualquier editor de texto.
Al ser texto plano, no te tienes que preocupar de la presentación, ni del tipo de letra, ni del tamaño. Se puede convertir en casi cualquier cosa que quieras. Pues hay exportadores a HTML, a PDF, o a ePub.
Vamos a resumir las bondades de markdown:
Simple: se aprende en 5 ó 10 minutos
Estándar: toda la industria lo ha adoptado
Perdurable: no ha cambiado en 20 años, ni cambiará.
Portable: puedes migrar entre plataformas y diferentes sistemas operativos
También, al ser texto plano es muy fácil comparar una versión del texto con otra y ver qué ha cambiado. Y eso, en combinación con un control de versiones —que ya aprenderemos a utilizar— nos dará una potencia total:
copias de seguridad, en local y en remoto
una única fuente de la verdad: tener siempre el texto actualizado en un único sitio. Cuantos escritores tendrán varias copias de su manuscrito, llegando a no saber cual es la buena sobre la que han hecho los últimos cambios.
historial de cambios: se puede ver con facilidad qué ha cambiado paso a paso
poder volver siempre a una versión anterior
migración fácil: cambio casi inmediato entre sistemas.
Ya sabes Markdown
Pero lo mejor es que ya sabes utilizarlo. Por ejemplo, ¿no has usado en whatsapp poner algo entre asteriscos para ponerlo en negrita o entre guiones bajos para ponerlo en cursiva?
Esto funciona en whatsapp:
entre asteriscos es *negrita* y entre guiones _cursiva_
Bueno, pues eso es el markdown. No está 100% estandarizado, por lo que hay unas pequeñas diferencias de unos sistemas a otros. Pero ya veremos que son mínimas.
Quienes lo utilizan
Pues además de whatsapp, se usa de forma nativa en la Wikipedia, Google Chat, Jira, Trello, Notion y en GitHub entre otros muchos. También se pueden editar libros usando markdown en sitios web como Leanpub y GitBook que los ponen a la venta en formato electrónico.
¿Cómo se utiliza?
Bueno, pues va tocando explicar cómo son sus marcas.
Cuerpo del texto
Si quieres que sea un párrafo distinto debes dar dos veces al enter dejando una línea en blanco con el párrafo anterior. Si lo que quieres es hacer un salto de línea sin que sea un párrafo distinto deja dos espacios al final de la linea y dale al enter.
Esto es un párrafo.
Esto es otro párrafo distinto.
Y esto es una nueva línea dentro del segundo párrafo
Cursiva
Para poner en cursiva hay que encerrarlo por un asterisco o guión bajo.
Este texto está en *cursiva* y este _también_.
Negrita
Lo que quieras poner en negrita hay que ponerlo entre doble asterisco o doble guión bajo.
Este texto está en **negrita** y este __también__.
NOTA: Yo prefiero usar guión bajo para cursiva y doble asterisco para la negrita. Así me resulta más fácil
Cursiva y negrita
Este texto está en _**cursiva y negrita**_.
Líneas horizontales
Con tres guiones
---
Listas
Pues si son ordenadas escribiendo - y espacio, o + y espacio, o * y espacio al comienzo de cada línea. Si son anidadas poniendo espacios delante del guión. Y si son ordenadas pues escribiendo números en lugar de guiones.
- elemento 1
- elemento 2
- elemento 2.1
- elemento 2.2
1. otro
2. otro más
- elemento 2.3
- elemento 3
NOTA: hay sistemas que también admiten listas de tareas precediendo cada elemento con [] y que se pueden marcar como completadas poniendo [x]
- [ ] tarea 1
- [x] tarea 2
Títulos
Los títulos van precedidos de una almohadilla y espacio. Para cada nivel de anidamiento del título se añade una almohadilla, de forma que si solo hay una es el título principal, si hay dos, son subtítulos inferiores, y así hasta seis. Se corresponden con los títulos HTML de H1 a H6
# Capítulo 1
## Capítulo 1.1
### Capítulo 1.1.1
#### Capítulo 1.1.1.1
##### Capítulo 1.1.1.1.1
###### Capítulo 1.1.1.1.1.1
Enlaces
Los enlaces se construyen de la siguiente forma: entre corchetes el texto del enlace y entre paréntesis la URL del enlace. Por ejemplo:
Vamos a visitar la [wikipedia](https://es.wikipedia.org)
Imágenes
Las imágenes es algo parecido, pero precedidas de una exclamación de cierre. Entre corchetes va la descripción de la imagen, y entre paréntesis la URL.
Editores
Hay muchos editores de texto plano. Con cualquiera puedes escribir markdown. La extensión de estos ficheros suele ser .md. Hay editores que llevan incorporado un visor de markdown, para que vayas viendo como queda a medida que escribes. Yo uso Visual Studio Code pero hay otros muchos Atom, o Notepad++
También hay muchos que son online y se puede usar una web para escribir y ver el resultado. Conozco estos tres:
Todos funcionan igual, pero el primero es el que más me gusta para un escritor, aunque cualquiera vale.
Conclusiones
Ya hemos aprendido markdown. Como verás, ya no tienes excusa para no utilizarlo en tus artículos, relatos, o como yo, escribiendo una novela de ciencia ficción española.
Aunque markdown es sencillo, es normal que te puedan surgir dudas, que estaré encantado de resolver. Seguramente, la misma pregunta que se te ocurre a ti, la tengan otras personas. Te invito a usar los comentarios, y te responderé a la mayor brevedad. Hagamos de esto un manual realmente útil para escritores.
O entre wordpress y markdown?
Gracias. Hay alguna web en que le des un texto escrito en substack y te saque el texto en markdown para usarlo en Leanpub, por ejemplo, todo online?