Este artículo es una guía para entender qué es, cómo escribir en Markdown y porqué te va a resultar enormemente útil. Está dirigido a profesionales que escriben a diario, escritores, científicos, académicos, blogueros y estudiantes. En definitiva, a cualquiera que escriba por placer o necesidad.

Si ya has leído el artículo que publiqué acerca de la guía de aplicaciones que sirven para escribir de forma seria (potentes, sencillas, permitiendo movilidad/sincronización entre dispositivos, sin distracciones, con enfoque total) el paso siguiente es utilizar tu aplicación favorita escribiendo en Markdown.

Puede que te preguntes porqué me pongo a hacer una guía como esta. La respuesta es sencilla: es la guía que me hubiera gustado tener hace un par de años. He tenido que rebuscar en decenas y decenas de webs hasta dominarlo. En serio, si quieres escribir deberías de hacerlo en Markdown, y espero este artículo te ayude.

[Puedes consultar aquí todos los artículos publicados sobre el placer de escribir.]

 

Aplicaciones para escribir que recomiendo

Los detalles están explicados en el la guía de aplicaciones para escribir. En resumen esto es lo que recomiendo:

  • Byword: Para textos <2000 palabras, ensayos, artículos, emails
  • Scrivener: Para textos largos y escribir un libro
  • Ulysses: para todo. Genial aplicación que ha llegado a reemplazar a Byword y Ulysses en todos mis escritos.
    • Ulysses para Mac
    • Ulysses para iPad y iPhone

También hay Scrivener para Windows.

Qué es Markdown

  • Markdown es una forma de escribir en texto plano (.txt) para centrarnos en el contenido, y además indicar el formato
  • Utiliza unos simples códigos de formato que son “transportables” a cualquier aplicación
  • Markdown se escribe utilizando cualquier programa de escritura (nunca usar Microsoft Word) como Byword o Scrivener (que están pensados desde su diseño para ser usados con Markdown, y hay cientos más)

Porqué usar escritura Markdown

  • Permite centrarnos totalmente en el contenido, dejando las distracciones del formato a parte. Aún así, el formato está incluido en forma de simples códigos visualmente reconocibles.
  • Permite exportar el texto de forma automática al formato que queramos:
    • Desde Markdown a .pdf, de forma que podemos publicar el texto en un archivo en pdf manteniendo el formato
    • Desde Markdown a HTML, de forma que podemos publicar el texto en internet sin preocuparnos del código html y manteniendo el formato. De hecho Byword permite publicar en WordPress directamente.
    • Desde Markdown a .mobi o cualquier formato de libro electrónico (se puede hacer un libro completo perfectamente formateado sin salir de la aplicación y escribiendo en texto plano, por ejemplo en Scrivener)
    • Desde Markdown a decenas de otros formatos
  • Al ser texto plano, ocupa poquísimo (varios miles de palabras son unos pocos bytes de información)
  • Al ser texto plano, jamás van a existir problemas de compatibilidad al abrirlo en otras aplicaciones (incluso dentro de decenas de años, el formato .txt es imposible que desaparezca)
  • La mayor parte de editores de texto potentes para OS X e iOS están diseñados para reconocer Markdown (Scrivener, Byword, Ulysses, Editorial, Drafts, nvALT. La lista de aplicaciones es muy larga)

Ejemplo de escritura en Markdown usando Byword y el resultado

Mientras escribo me gusta visualizar cómo será el resultado final al exportar, para ello hago ⌥⌘p en Byword (solo lo hago una vez cada hora o más tarde, ya que perseguimos centrarnos en el contenido). Así además puedo comprobar si he escrito algo mal y corregir poco a poco.

title

(pulsa en la foto para verlo ampliado)

Realmente “cuando ya confiemos” a escribir en Markdown, solo hará falta visualizar el formato una o dos veces tras haber escrito todo el texto. Es gracias a esto que el enfoque en el contenido será total, junto con una aplicación super limpia como Byword.

 

Sintaxis: cómo escribir en Markdown

Esta es una guía rápida de la sintaxis en Markdown. Está ordenada en orden de preferencia, probablemente solo los primeros de la lista que sigue a continuación serán los que uses el 99% del tiempo. Estoy casi seguro que no necesitarás otra guía además de esta.

 

Para visualizar el formato desde Byword

Asumiendo que usas Byword (probablemente el editor de texto más sencillo y potente que hay) aquí tienes unos trucos.

Mientras escribimos en Markdown, de vez en cuando querremos ver cómo se muestra el formato final, para ello:

  • Pulsar ⌥⌘p para mostrar el visualizador
  • Salir del visualizador pulsando Esc

Nota: La verdadera fuerza de este sistema es que cuando queramos exportar el formato en pdf o bien en html para publicar en Internet (WordPress, etc.) ese formato se convertirá automáticamente al estilo de nuestra web sin tener que teclear nada de código html.

 

Para hacer un nuevo párrafo

  • Apretar Enter al acabar la línea (creará un espacio en blanco)

 

Para hacer salto de línea

  • Añadir dos espacios en blanco al final de la última palabra.

Nota: Añadir los dos espacios se suele olvidar, pero al visualizar haciendo ⌥⌘p , nos daremos cuenta.

 

Titulo de nivel 1 – H1

Escribir el titulo con un “#” delante y apretar Enter.

# Esto es un título de nivel 1

Truco en Byword:

  • Atajo teclado: ⌘+ , pulsar varias veces según el nivel del título

 

Titulo de nivel 2 – H2

Escribir el titulo con dos “#” delante y apretar Enter.

## Esto es un título de nivel 2

 

Titulo de nivel 3 – H3

Escribir el titulo con tres “#” delante y apretar Enter.

### Esto es un título de nivel 3

 

Titulo de nivel 4 – H4

Escribir el titulo con cuatro “#” delante y apretar Enter.

#### Esto es un título de nivel 4

 

Negrita

Escribir el texto entre dos asteriscos.

**esto es un texto en negrita**

Truco en Byword:

  • Atajo teclado: Seleccionar el texto y apretar ⌘b

 

Itálica

Escribir el texto entre un asterisco.

*esto es un texto en itálica*

Truco en Byword:

  • Atajo teclado: Seleccionar el texto y apretar ⌘i

 

Listas ordenadas

Escribir el número + punto + espacio.

Sintaxis y ejemplo

1. Beber agua
2. Dormir bien

Nota:

  • Dejar una línea en blanco antes y después de la lista
  • No olvidar el punto ni el espacio después del número

 

Listas no ordenadas

Sintaxis y ejemplo

* Beber agua
* Dormir bien

Nota:

  • Dejar una línea en blanco antes y después de la lista
  • No olvidar el espacio después del número

 

Listas anidadas

    1. Beber agua
        * Al menos un litro al día
        * Un vaso cada dos horas
    2. Dormir bien

 

Notas a pie de página

Sintaxis y ejemplo

Este blog es magnífico [^1]
[^1]: Realmente es peor que el mío, pero aún me gusta. 

 

Enlaces – forma 1

La forma más sencilla

Sintaxis: []()

por ejemplo:

[este es el enlace hacia Brainpickings](http://www.brainpickings.org/)

Truco en Byword:

  • Atajo teclado: ⌘k
  • Arrastrar el enlace desde el navegador web y soltarlo en el texto, así se crea el enlace automáticamente (super útil !)

 

Enlaces – forma 2

Esta segunda forma se usa cuando queremos separa los enlaces del texto, para mantener la legibilidad mientras escribimos (es cuestión de gustos, yo casi siempre uso la primera forma)

Un poco de texto con [este enlace][1] y [este otro enlace][2].
[1]: http://blabla.com/ 
[2]: http://example.org/

En este ejemplo, las dos referencias se pueden colocar al final del documento si queremos, o en cualquier parte. De esa forma el texto es más legible, aunque el resultado final al publicarlo se mostrará exactamente igual que la primera forma.

 

Imágenes desde el disco duro

Sintaxis y ejemplo:

![title](http://hoymotivacion.com/wp-content/uploads/2015/07/wpid-wallpaper-2966267.jpg)

Truco en Byword:

  • Arrastrando la imagen desde el Finder hasta el documento Byword, se crea el código Markdown para mostrar la imagen (ojo, si luego movemos la foto a otra carpeta, el enlace dejará de funcionar)
  • Atajo teclado: ⌥⌘I

 

Referencias cruzadas dentro del documento

También puedes ir a la sección de [conclusión final][conclusion]
## Conclusión final y despedida  [conclusion]

Nota: solo funciona referenciando a la posición del título (header), no a los párrafos intermedios.

Otra forma que sirve para cualquier parrafo (sin necesidad de header)
  • Sitúa un anchor <a name=”abcd”></a> a donde quieres enlazar y
  • Refiere a esa posición con un hipervínculo escribiendo: [link text](#abcd).

Insertar cita

Añadir “>” delante del bloque de texto y apretar Enter.
Por ejemplo:

> La vida es muy peligrosa. No por las personas que hacen el mal, sino por las que se sientan a ver lo que pasa. 
> Einstein

 

Insertar código

  • Añadir cuatro espacios delante del código, o bien añadir un tab y luego Enter
  • Añadir el código entre el acentos “ ´ ”: ojo no es el carácter del acento español)
esto es código

 

Insertar una barra horizontal de separación

Añadir tres asteriscos y apretar Enter.

***

y por arte de magia aparecerá una barra horizontal como esta.


 

Referencias

  1. Daring Fireball , del creador de Markdown: John Gruber
  2. Markdown – Wikipedia
  3. Byword MultiMarkdown Guide

 

Crédito foto: Flickr