A.1 Conversión de documentos con Pandoc

La sintaxis del comando es pandoc [opciones] [ficheros]. Si se ejecuta pandoc --help, en la ventana de comandos o en la pestaña Terminal de RStudio, se obtiene un listado detallado de las opciones. También se puede consultar el manual de Pandoc https://pandoc.org/MANUAL.html.

Si Pandoc no está configurado en la ruta de búsqueda, habrá que reemplazar pandoc por la ruta completa al ejecutable. Por ejemplo, para emplear la versión instalada con RStudio en Windows habra que introducir "C:\Program Files\RStudio\bin\pandoc\pandoc" si la versión de RStudio es anterior a v2022.07 y "C:\Program Files\RStudio\bin\quarto\bin\tools\pandoc.exe" en caso contrario (ver Hello, Quarto).

Podemos emplear Pandoc para convertir contenido escrito en otros formatos a Markdown, por ejemplo:

  • Un fichero word a markdown:

    "C:\Program Files\RStudio\bin\pandoc\pandoc" fichero.docx -f docx -t markdown 
--extract-media . -o fichero.Rmd

    Ver docx2md.bat y alldocx2md.bat (o alldocx2md2.bat para RStudio >= v2022.07 - Quarto).

  • Un fichero LaTeX a markdown:

    "C:\Program Files\RStudio\bin\pandoc\pandoc" fichero.tex -f latex -t markdown 
-o fichero.Rmd

    Ver tex2md.bat y alltex2md.bat (o alltex2md2.bat para RStudio >= v2022.07 - Quarto).

  • Una web a markdown:

    "C:\Program Files\RStudio\bin\pandoc\pandoc" http://url.org -f html -t markdown 
-o fichero.Rmd

    Ver web2md.bat (o web2md2.bat para RStudio >= v2022.07 - Quarto).

Por defecto pandoc produce en algunos casos un fragmento de documento (cuando el formato de salida no es markdown). Para obtener un documento independiente (e.g. un fichero HTML válido incluyendo <head> y <body>), habrá que emplear la opción -s o --standalone.