Markdown¶

Markdown y Pandoc¶

Utilidades¶

• Haroopad es un potente editor de código markdown con previsualización automática.

Conversión¶

• A pdf (requiere LaTeX): pandoc ejemplo.md -o ejemplo.pdf
• A formato word (docx): pandoc ejemplo.md -o ejemplo.docx
• Convertir desde otro formato a un Markdown compatible con Hugo:

pandoc -t markdown-simple_tables+pipe_tables-multiline_tables-grid_tables-raw_html --atx-headers --base-header-level=2 -s <ficheroAconvertir> -o <ficheroSalida.md>

Añadir vista previa de ficheros Markdown en Notepad++¶

Ver en notepad++.md

Gráficos¶

• Se hacen con http://www.graphviz.org (el programa editor es gvedit)

Tablas¶

Pandoc¶

Utilizar plantillas de word¶

how to create docx template?

There is no template for docx. You can use the ‘’–reference-docx’‘ option to customize the output.

To get a starting reference.docx, you can just do ‘’pandoc myfile.txt -o reference.docx’‘ where myfile.txt is just a short text file with, say, “Hello world”.

Then modify reference.docx using Word. The only changes that will be significant are changes to certain styles – see the manual for more information.

You can then use this reference.docx to style your documents:

‘’pandoc –reference-docx=reference.docx myfile.txt -o myfile.docx’‘

Modificaciones¶

Para hacer las modificaciones oportunas en el documento se puede extraer el docx de la plantilla (que es un zip) y modificar word\document.xml.

Por ejemplo se puede modificar:

• Table of contents -> por Contenido

• Modificar tablas 1. Se crea un nuevo estilo de tabla en la plantilla (por ejemplo TablaNueva). 2. Se genera el word y se modifica con el siguiente código:

7z.exe x mydoc.docx word\document.xmlsed "s/ word\document2.xmlcopy word\document2.xml word\document.xml /y7z.exe u mydoc.docx word\document.xml

Panflute¶

Con panflute se pueden aplicar filtros en la conversión.

Ver http://scorreia.com/software/panflute/

RMarkdown¶

Con RStudio se tiene un IDE que permite escribir documentos con R Markdown, una extensión de markdown.

Para exportar a markdown se puede hacer:

rmarkdown::render('r.Rmd', 'github_document')

Bookdown¶

Para escribir libros se puede utilizar la extensión bookdown, que se instala desde la consola de R con:

install.packages('bookdown')

Mkdocs¶

• Listado de plugins

Los plugins que utilizo son:

• mkdocs-awesome-pages-plugin
• MkDocs Nav Enhancements
• mkdocs-encryptcontent-plugin

Generar documentación en pdf¶

Lo hago con la extensión mkdocs-with-pdf.

Para generar un pdf, en el mkdocs.yml excluyo las partes que no me interesen y hago desde consola:

set ENABLE_PDF_EXPORT=1
mkdocs build -d c:\tmp

en c:\tmp\pdf tendré el pdf generado.

Referencias¶

• R Markdown. The Definitive Guide (2019). Yijui Xie, J.J. Allaire, Garrett Grolemund.
• Blogdown. Creating Websites with R Markdown (2018). Yijui Xie, Amber Thomas, Alison Presmanes Hill.