Switch branches/tags
Nothing to show
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Markdown en la edición digital

Última actualización: 12 de julio de 2017

Markdown ayuda a aligerar la carga de trabajo técnico necesario para tener un documento debidamente estructurado que sirve para el desarrollo de los múltiples formatos de una publicación.

En este módulo se pasará de un PDF o TXT a Markdown a través de unos cuantos pasos.

Módulos relacionados

Índice


Instalar el software necesario

Para conocer el software necesario para todos los módulos, consúltese el área de instalación.

Existe un programa opcional si se desea partir desde el PDF en lugar del archivo TXT: Xpdf. No requiere instalación. Descarga y guarda los binarios en una carpeta.

Crear un MD a partir de un PDF o TXT

Se pueden utilizar los archivos que están el la carpeta completo. Si solo se va a copiar y pegar los comandos, se tienen que renombrar los archivos empleados.

Pasos a seguir

0. Ir a este carpeta desde la terminal (Opcional)

cd arrastrar/la/carpeta/P001-Markdown

Esto es solo para asegurar que no habrá errores si se copian y pegan los comandos que vienen a continuación.

1. Extraer el texto del PDF (Opcional)

pdftotext 0-lsd.pdf 1a-lsd.txt

Del PDF es necesario obtener el texto, por lo que se usará una herramienta de Xpdf: pdftotext.

  1. arrastrar pdftotext, localizado en la carpeta bin64.
  2. Indicar el archivo PDF a convertir: 0-lsd.pdf.
  3. Indicar el nombre de archivo de texto que se creará: 1a-lsd.txt.
  4. Enter para ejecutar.

Si no se tiene un dominio sobre el manejo de rutas, es recomendable arrastrar los archivos necesarios.

Los espacios definen la separación entre argumentos, ¡ten cuidado!

2. Limpiar el texto (Opcional)

La extracción del texto da como resultado el archivo 1a-lsd.txt que se puede abrir en cualquier editor de texto plano como TexEdit (Mac), Bloc de notas (Windows) o Gedit (Linux).

Como se puede observar, el texto está lejos de estar ordenado, por lo que hay necesidad de limpiar el texto y eliminar caracteres extraños como , invisibles en varios editores o exploradores, pero que generarán errores en la codificación.

También se tienen que separar el contenido de las notas del texto principal, por lo que al final tienen que quedar dos archivos de texto:

  1. 2a-lsd_limpio.txt.
  2. 2a-lsd_notas.txt.

Si no se hizo el paso 1, utilícese el archivo 1-lsd.txt presente en la carpeta completo.

3. Formatear a Markdown

El texto ya está limpio y el contenido adicional (las notas) ha sido separado. Sin embargo, el documento carece de estructura, por lo que es necesario formatear los archivos.

El formato es el cuello de botella en la edición, ya que define la calidad de la publicación. Para que la tarea sea sencilla, el archivo se pondrá en un lenguaje de marcado ligero, como Markdown.

Al final, tienen que quedar dos archivos de Markdown:

  1. 3a-lsd.md
  2. 3a-lsd_notas.md

Si se desconoce cómo indicar las notas o cuál es el formato más adecuado para el archivo que contiene las notas, véase la documentación de pc-notes.

Pueden usarse varios estilos de párrafo que se encuentran en la plantilla por defecto, véase aquí para conocer las opciones.

El formateo se puede realizar en cualquier editor de texto plano, pero si se desea un programa para resaltar sintaxis de Markdown, lo recomendable es un editor de código, como Geany, Atom o Brackets.

Si no se hizo el paso 2, utilícese los archivos 2-lsd_limpio.txt y 2-lsd_notas.txt presente en la carpeta completo.

Recursos

  1. Artículo de Markdown en Wikipedia.
  2. Atom.
  3. Brackets.
  4. Documentación oficial de Markdown.
  5. Documentación oficial de Pandoc.
  6. Geany.
  7. Guía para Markdown en PDF.
  8. Markdown Here.
  9. Markdown Viewer (descarga para Firefox o para Chrome).
  10. Módulo «Metodologías para la edición digital estándar».
  11. ¿Qué es un lenguaje de marcado ligero?.
  12. Sintaxis básica de Markdown.
  13. The ultimate guide to Markdown.
  14. Sintaxis adicional de Markdown.
  15. Pecas: herramientas editoriales.