Markdown para escritores y autores

Markdown es una herramienta ideal para escritores y autores que buscan centrarse en el contenido sin distracciones. Muchos escritores profesionales han adoptado Markdown como su formato de escritura principal por su simplicidad y versatilidad.

¿Por qué usar Markdown como escritor?

Estas son las principales ventajas de Markdown para escritores:

• Sin distracciones: No hay barras de herramientas ni menús que interrumpan tu flujo de escritura.
• Portabilidad: Tus textos son archivos de texto plano que funcionan en cualquier dispositivo.
• Exportación flexible: Puedes convertir tus textos a PDF, DOCX, ePub y más.
• Durabilidad: Los archivos de texto plano nunca quedan obsoletos.
• Control de versiones: Puedes usar Git para rastrear cambios en tus manuscritos.

Flujo de trabajo recomendado

Sigue estos pasos para un flujo de trabajo eficiente con Markdown:

1. Escribe en Markdown: Usa un editor minimalista como Typora, iA Writer o Obsidian.
2. Organiza por capítulos: Un archivo Markdown por capítulo.
3. Revisa: Usa el control de versiones para comparar borradores.
4. Exporta: Convierte al formato final (PDF, ePub, DOCX).

Aplicaciones recomendadas para escritores

Estas son las aplicaciones más populares entre escritores que usan Markdown:

• iA Writer: Editor minimalista centrado en la escritura.
• Ulysses: Gestión completa de proyectos de escritura.
• Typora: Editor WYSIWYG de Markdown.
• Obsidian: Ideal para organizar investigación y notas.
• Bear: Notas con Markdown elegante en Apple.

Crear un libro con Markdown

Puedes escribir un libro entero en Markdown y exportarlo a ePub o PDF:

mi-libro/
├── 00-prologo.md
├── 01-capitulo-1.md
├── 02-capitulo-2.md
├── 03-capitulo-3.md
├── imagenes/
│   ├── portada.png
│   └── ilustracion-1.png
└── metadata.yaml

Con Pandoc puedes compilar todos los capítulos:

pandoc metadata.yaml 00-*.md 01-*.md 02-*.md 03-*.md -o mi-libro.epub

Crear un libro con Markdown (en detalle)

El archivo metadata.yaml

El archivo metadata.yaml contiene la información del libro que Pandoc usa para generar la portada, los créditos y los metadatos del ePub o PDF:

---
title: "El título de tu libro"
subtitle: "Un subtítulo opcional"
author:
  - nombre: "Tu Nombre"
    afiliación: "Tu editorial o sitio web"
date: "2024"
lang: es-ES
description: |
  Una breve descripción del libro que aparecerá
  en las tiendas de libros electrónicos y catálogos.
rights: "© 2024 Tu Nombre. Todos los derechos reservados."
publisher: "Nombre de la editorial"
cover-image: "imagenes/portada.png"
css: "estilos/libro.css"
toc: true
toc-depth: 2
---

Compilar el libro a ePub

pandoc metadata.yaml \
  00-prologo.md 01-capitulo-1.md 02-capitulo-2.md 03-capitulo-3.md \
  -o mi-libro.epub \
  --epub-cover-image=imagenes/portada.png \
  --toc \
  --toc-depth=2 \
  --css=estilos/libro.css

Compilar a PDF con aspecto profesional

pandoc metadata.yaml \
  00-prologo.md 01-capitulo-1.md 02-capitulo-2.md 03-capitulo-3.md \
  -o mi-libro.pdf \
  --pdf-engine=xelatex \
  -V documentclass=book \
  -V geometry:"top=3cm, bottom=3cm, left=3.5cm, right=2.5cm" \
  -V fontsize=11pt \
  -V mainfont="Noto Serif" \
  -V linestretch=1.4 \
  -V toc=true \
  --number-sections

La variable documentclass=book activa funciones específicas para libros en LaTeX, como numeración de capítulos, páginas pares e impares con márgenes alternos, y separación automática entre "parte frontal" y contenido principal.

Markdown en la industria editorial

Markdown se ha ganado un lugar en la industria editorial, especialmente en la publicación técnica y digital:

Editoriales que aceptan manuscritos en Markdown

Estas son algunas editoriales que aceptan o utilizan formatos basados en Markdown:

• Leanpub: Plataforma de autopublicación que usa Markdown (su propio dialecto llamado Markua) como formato principal. Los autores escriben en Markdown y Leanpub genera PDF, ePub y MOBI automáticamente. Permite publicar libros en progreso y actualizar el contenido al instante.

• Pragmatic Programmers: Una de las editoriales técnicas más respetadas. Sus autores escriben los manuscritos en un formato basado en texto plano que es muy similar a Markdown.

• O'Reilly Media: Acepta manuscritos en varios formatos de texto plano, incluyendo AsciiDoc (muy similar a Markdown) a través de su herramienta Atlas. Muchos de sus libros técnicos se escriben de esta forma.

• Manning Publications: Otra editorial técnica importante que utiliza flujos de trabajo basados en texto plano para la producción de sus libros.

Herramientas de publicación basadas en Markdown

Estas herramientas permiten crear libros y publicaciones a partir de Markdown:

• mdBook: Creado por la comunidad de Rust, genera libros web desde Markdown. Ideal para documentación técnica en formato de libro.
• Bookdown: Extensión de R Markdown para escribir libros. Muy popular en la comunidad académica y científica.
• Quarto: Sistema de publicación científica y técnica que usa Markdown como base, con soporte para R, Python, Julia y Observable.

Markdown para newsletters

Muchas plataformas de newsletters soportan Markdown, lo que permite a los escritores redactar sus envíos más rápido y con un formato consistente:

Plataformas con soporte para Markdown

Estas plataformas de newsletters ofrecen soporte para Markdown:

• Substack: Aunque su editor principal es visual, Substack permite pegar contenido Markdown que se convierte automáticamente. Muchos autores escriben en su editor de Markdown favorito y luego pegan el resultado en Substack.

• Buttondown: Plataforma de newsletters diseñada especialmente para gente que prefiere Markdown. Su editor nativo es un editor de Markdown con vista previa. Soporta metadatos, programación de envíos y gestión de suscriptores desde una interfaz minimalista.

• Ghost: Plataforma de publicación que usa un editor basado en Markdown. Permite escribir posts y newsletters con la misma sintaxis. Su editor reconoce automáticamente la sintaxis Markdown mientras escribes.

• Revue (ahora integrado en X): Soportaba Markdown para redactar newsletters de forma rápida.

• ConvertKit: Permite usar Markdown dentro de sus bloques de texto para formatear los correos electrónicos.

Flujo de trabajo para newsletters

Sigue estos pasos para gestionar tus newsletters con Markdown:

1. Escribe en tu editor favorito: Usa iA Writer, Obsidian o VS Code.
2. Almacena los borradores en Git: Crea un repositorio con tus newsletters como archivos .md.
3. Revisa y edita: Usa Git para comparar versiones de tu borrador.
4. Publica: Copia el contenido a tu plataforma de newsletters o usa la API de la plataforma.

Este flujo te permite tener un archivo completo de todas tus newsletters en texto plano, fácil de buscar y reutilizar.

Markdown vs procesadores de texto