La mejor herramienta para producir un pdf desde un fichero GH markdown depende de tu flujo de trabajo habitual (editor visual, línea de comandos o automatización). Las siguientes son opciones para convertir GitHub Flavored Markdown (GFM) —con soporte para tablas, listas de tareas, bloques de código estilizados y diagramas— a PDF:
Si ya escribes Markdown en Visual Studio Code, la forma más sencilla es usar una extensión:
yzane.markdown-pdf)Ventajas: Convierte directamente con un clic o desde la paleta de comandos (Ctrl+Shift+P / Cmd+Shift+P $\rightarrow$ Markdown PDF: Export (pdf)).
shd101yyy.markdown-preview-enhanced)Grip (GitHub Readme Instant Preview) utiliza la propia API pública de GitHub para renderizar el documento. Es una opción ideal si necesitas que el PDF se vea exactamente igual a un README.md en GitHub.
# 1. Instalar Grip
pip install grip
# 2. Iniciar el servidor local
grip tu_archivo.md
Paso final: Abre la URL que genera en el navegador (
http://localhost:6419), presionaCtrl+P/Cmd+Py selecciona Guardar como PDF.
➜ gh-cli-template git:(main) grip README.md
* Serving Flask app 'grip.app'
* Debug mode: off
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
* Running on http://localhost:6419
Press CTRL+C to quit
Genera un pdf a partir del fichero test.md que forma parte del template.
Añade el pdf generado test.pdfal control de versiones y enlázalo en este documento.