¿Cómo convertir Markdown a PDF sin LaTeX?

Node.js Package Markdown-PDF debería funcionar bien. He estado usando el paquete Grunt de eso , pero solo por el bien de una buena respuesta, simplemente ejecuté rápidamente el original a través de la línea de comando ; y sí, funciona muy bien.

Entonces, para usar la CLI de Markdown-PDF solo:

1. Instale Node.js (si es necesario)
2. Instale Markdown-PDF - desde cmdline simplemente ejecutenpm install -g markdown-pdf
3. ejecutar markdown-pdf -o readme.pdf readme.md(o cualquier origen y destino y otras opciones que desee; consulte Opciones de CLI para obtener todos los detalles de lo que puede especificar).

Es de código abierto (con licencia MIT) y tiene un repositorio de Github , es gratuito y, por lo que he encontrado, es bastante rápido.

Puede haber un pequeño problema con la obtención de imágenes de los dominios https://, pero no he investigado qué hay allí: una de mis imágenes no se está cargando, por lo que es muy probable que sea algo divertido en mi md, pero hay un ligero posibilidad de que sea un error.

Un error importante : no se crean enlaces en los que se pueda hacer clic.

Yo personalmente soy un gran fan de pandoc.

Pandoc es la herramienta navaja del "ejército suizo" de conversiones de formato:

• El formato de entrada de fuente central admitido es Markdown(incluido cualquiera de los principales "dialectos" de MD, como los sabores de GitHub y PHP, además de varias extensiones especiales). Otros formatos de entrada son: HTML, rST, Textile, DocBook XML, MediaWiki.
• Como formatos de salida admite: ConTeXt, LaTeX, PDFy Beamer PDF(aunque requiere LaTeX en segundo plano), MediaWiki, DOCX, DocBook, rST, Textile, ASCIIDoc, texinfo, org(modo Emacs Org), S5(diapositivas HTML), Slidy(diapositivas HTML), Slideous(diapositivas HTML), ImpressJS(diapositivas HTML ), DZSlides(diapositivas HTML), HTML, HTML5, EPUB, EPUB3
  ...y: manpage(página de manual de GROFF) y ODT(Texto OpenDocument).

¿Sigues conmigo? Bien.

¿Te diste cuenta de los dos últimos, manpagey ODT?

Bueno, estos son los dos formatos de salida de los que personalmente "abuso" como formatos intermedios para llegar a PDF para documentos finales cuando no quiero que LaTeX esté involucrado.

He automatizado mi flujo de trabajo y cadena de procesos con la ayuda de un Makefile . Así que solo necesito escribir make mydoc.latexpdf, o make mydoc.odtpdf, o make mydoc.manpdf. El Makefile está configurado para buscar una entrada de mydoc.mmd, y luego activa los comandos apropiados: pandocpara crear el PDF directamente (que en segundo plano primero se convierte a LaTeX y luego se ejecuta pdflatexsolo), ODT o página de manual. Luego, el siguiente comando es crear el formato final:

• Para mi .odtpdfobjetivo, ejecuta LibreOffice en modo sin cabeza. Estas son las líneas de comando básicas que uso para (estoy en OS X, por lo que para Linux o Windows tendrá que adaptar las rutas en consecuencia). Atención, el comando está en la sintaxis de Makefile; no se puede usar directamente en Shell sin una adaptación previa:

  (cd /Applications/LibreOffice.app/Contents/MacOS; \
  ./soffice "-env:UserInstallation=file:///tmp/LibO_Conversion__$(USER)" \
          --headless \
          --convert-to pdf:writer_pdf_Export \
          --outdir $(CURRDIR)/$(FINAL)  $(CURRDIR)/$(BUILD)/$(subst .odtpdf,.odt,$@) ; \
  cd - ; )
  

• Para mi .manpdfobjetivo, lo usa man -tpara crear PostScript a partir del archivo de salida de la página de manual de Pandoc, luego usa Ghostscript para crear el PDF. Por lo tanto, ejecuta:

  man -t <pandoc's manpage output file> \
   | gs -o ${HOME}/<pandoc-sourcedoc-name>.pdf -sDEVICE=pdfwrite -
  

Personalice la apariencia de su salida ODT

La ruta sin LaTeX a PDF a través de ODT es la más "sexy" para mí...

• ...porque Pandoc sabe cómo aplicar algunos buenos estilos personalizados a una ODT de destino si solo estos estilos se definen correctamente en un myreference.odtarchivo ! (Estos estilos, por supuesto, también se transferirán al PDF).

Luego puedo ejecutar el comando Pandoc (a través de Makefile o en Shell) para crear un ODT a mi gusto, completo con las fuentes, tamaños y colores que prefiero, con los tamaños de página y encabezados de página, pies de página o fondos que definí (nuevamente : ¡Sintaxis de Makefile!):

     pandoc \
            --toc \
            --toc-depth=4 \
            --to=odt \
            --chapters \
            --filter=pandoc-citeproc \
            --standalone \
            --reference-odt=$(RESOURCES)/myreference.odt \
            --from=markdown+mmd_title_block+pipe_tables+grid_tables+tex_math_dollars+raw_tex+footnotes+inline_notes+citations+link_attributes \
            --bibliography=$(RESOURCES)/my.bib \
            --csl=$(RESOURCES)/kp.csl \
            --number-sections \
            --output=./$(BUILD)/$@ \
            $<

El --from=markdown+...+...+parámetro le dice a Pandoc que acepte varias extensiones de sintaxis Markdown que me gusta usar en mis archivos fuente MD.

El dulce secreto para obtener los estilos en el documento ODT radica en el --reference-odt=/path/to/myreference.odtparámetro de línea de comando.

¡La salida ODT funciona incluso con referencias y bibliografía (si su entrada Markdown está escrita correctamente para esto) !

¿Usas Windows?

En principio, este flujo de trabajo también debería funcionar en Windows, porque Pandoc también se ejecuta en Windows. He ejecutado Pandoc en Windows antes, pero no he configurado un flujo de trabajo completamente automático, primero " Pandoc: Markdown -> ODT " , luego " .\soffice: ODT-> PDF " basado en un Makefile aquí, sin embargo...

Pero es posible que desee explorar otro camino en Windows :

• primero cree una salida DOCX desde Pandoc;
• luego convierta el DOCX a PDF (automáticamente o interactivamente a través de WinWord).

Sí, también puede personalizar los estilos de los archivos de salida DOCX usando el --reference-docx=my-reference.docxinterruptor. Simplemente cree my-reference.docxprimero un archivo que use exactamente los estilos que desea. ¡Pandoc luego los extraerá del documento de referencia y los aplicará al DOCX de salida que genera!

Desde allí, puede ver cómo convertir el archivo DOCX intermedio a PDF. Esto también se puede hacer automáticamente: también puede considerar OfficeToPDF.exe . Está alojado en CodePlex, licenciado con la licencia Apache 2.0 y disponible en binario y en código fuente.

Finalmente: asegúrese de usar la última y mejor versión de Pandoc (actualmente v1.17.0.3 o posterior ); se han agregado muchas funciones en los últimos meses, especialmente. cuando se trata de salida DOCX!

He investigado otra opción. Comparado con Markdown-PDF :

• Ventajas:
  • En realidad hace enlaces adecuados.
  • En realidad un poco más rápido de ejecutar
• Contras:
  • No tan "bonito": excepto por los enlaces, todo se ve mejor con Markdown-PDF. Sin embargo, esto se solucionaría fácilmente agregando algo de CSS al HTML antes de la generación del PDF*.
  • La instalación es más complicada.

Esta también es una solución basada en Nodejs que utiliza los paquetes de nodos Marked y wkhtmltopdf .

Instalación:

• Instala Nodejs .
• Instalar Marcado - más fácil a través de la línea de comandos:npm -g install marked
• Instale wkhtmltopdf NPM - más fácil a través de la línea de comandos:npm -g install wkhtmltopdf
• Instale los archivos principales de wkhtmltopdf ; no hay ningún instalador disponible.
• Agregue el directorio bin wkhtmltopdf a la RUTA

Uso:

Para usar toma dos llamadas CLI. Por supuesto, puede guardar esto como un archivo por lotes y ejecutarlo.

marked input.md -o output.html
wkhtmltopdf input.html output.pdf

* Debido a que los enlaces funcionan, puedo cambiar a este método en lugar de Markdown-PDF, en cuyo caso probablemente escribiré un contenedor para agregar algo de CSS (con la opción de agregar un valor predeterminado sensible o definido por el usuario). El contenedor también lo convertiría en una llamada en lugar de dos para ejecutar y probablemente podría convertirlo en un cmd de instalación npm en lugar de la instalación manual. Si/cuando lo haga, lo compartiré aquí.

Acabo de convertir de HTML en su lugar. Esto funciona para mis necesidades:

https://github.com/dompdf/dompdf

Descubrí que, en general, Markdown no es un buen formato para convertir a PDF, ya que no es compatible con CSS nativo. Aquí está el script que uso:

<?php
require 'dompdf/autoload.inc.php';
use Dompdf\Dompdf;

$dompdf = new Dompdf();
$dompdf->getOptions()->setIsFontSubsettingEnabled(true);
$get = file_get_contents('index.html');
$dompdf->loadHtml($get);

$dompdf->render();
$put = $dompdf->output();
file_put_contents('index.pdf', $put);

Esta solución solo necesita PHP (25 MB) y DomPdf (4 MB), por lo que es bastante liviana en comparación con otras opciones.

Para construir sobre la solución de @nick-wilde, si está usando gruñido, hay complementos tanto para marcado como para wkhtmltopdf:

• gruñido marcado
• grunt-wkhtmltopdf

Después de instalar el wkhtmltopdfbinario principal , puede instalar los complementos usando npm:

npm install grunt-marked --save-dev
npm install grunt-wkhtmltopdf --save-dev

Luego usa algo como esto en tu Gruntfile.js:

marked: {
  std : {
    files: {
      'out.html' : ['src.md']
    }
  }
},

wkhtmltopdf: {
  std : {
    src: 'out.html',
    dest: 'out.pdf'
  }
},

Luego, en su compilación, simplemente llame a los dos en sucesión:

grunt.registerTask('build', ['marked', 'wkhtmltopdf']);

Si quieres que se vea bonito, tendrás que jugar más con la markedconfiguración, pero estoy seguro de que es factible.

Recientemente creé un servicio para convertir documentos de descuento a PDF. Es compatible con la reducción con sabor a GitHub, así como con el resaltado de sintaxis. El servicio se encuentra en: http://markdown2pdf.com

No es sexy, pero AbiWord convertirá HTML a PDF.

Entonces, asumiendo que tienes instalado abiword:

markdown some.md > some.html  
abiword -t pdf -o some.pdf some.html