Categorías

README de GitHub a PDF

Obtiene un README de GitHub y lo renderiza en PDF

Genera un PDF a partir de un README de GitHub.

Fuente:

  • URL del repo o owner/repo
  • Rama y ruta del README opcionales

Salida:

  • Estilo tipo GitHub con ajustes de impresión

Resultados de ejemplo

1 Ejemplos

Ejemplo: GitHub README to PDF

Muestra PDF generada automaticamente: Repository README converted to PDF

github-readme-to-pdf-example1.pdf Ver archivo
Ver parámetros de entrada
{ "repository": "https://github.com/meilisearch/meilisearch", "theme": "print", "baseFontSize": 13 }

Datos clave

Categoría
Document Tools
Tipos de entrada
text, select, number, checkbox
Tipo de salida
file
Cobertura de muestras
4
API disponible
Yes

Resumen

Convierte cualquier archivo README de un repositorio de GitHub en un documento PDF profesional con un solo clic, manteniendo el formato original y permitiendo ajustes personalizados de impresión.

Cuándo usarlo

  • Para archivar la documentación técnica de un proyecto en formato PDF sin conexión.
  • Cuando necesitas presentar el estado de un repositorio en un informe impreso o digital.
  • Para crear copias de seguridad estáticas de la documentación de tus repositorios personales o de terceros.

Cómo funciona

  • Introduce la URL del repositorio de GitHub o el formato 'usuario/repositorio'.
  • Define opcionalmente la rama específica y la ruta del archivo README si no es la raíz.
  • Ajusta las preferencias de diseño, como el tamaño de página, los márgenes y el tema visual.
  • Genera y descarga el archivo PDF optimizado para lectura o impresión.

Casos de uso

Creación de manuales de usuario a partir de documentación técnica alojada en GitHub.
Generación de portafolios impresos para mostrar proyectos de código abierto.
Distribución de documentación técnica en entornos corporativos que requieren archivos PDF estáticos.

Ejemplos

1. Documentación para auditoría técnica

Ingeniero de Software
Contexto
El equipo necesita entregar una copia física de la documentación del proyecto para una auditoría de cumplimiento.
Problema
El README está en línea y no es apto para impresión directa desde el navegador.
Cómo usarlo
Ingresa la URL del repositorio, selecciona el tema 'Print' y ajusta los márgenes a 18mm para un acabado profesional.
Configuración de ejemplo
repository: 'usuario/proyecto', theme: 'print', marginTop: 18, marginBottom: 18
Resultado
Un documento PDF limpio, con formato de impresión, listo para ser incluido en el informe de auditoría.

2. Archivo de proyecto personal

Desarrollador Web
Contexto
Deseo guardar una versión estática de mi proyecto favorito para consultarlo sin conexión.
Problema
Necesito un formato de lectura cómodo en formato A5.
Cómo usarlo
Configura el tamaño de página a A5 y ajusta el tamaño base de fuente a 12px para una lectura más clara.
Configuración de ejemplo
repository: 'usuario/repo-favorito', pageSize: 'A5', baseFontSize: 12
Resultado
Un archivo PDF compacto y legible, ideal para lectura en dispositivos móviles o tablets.

Probar con muestras

markdown, pdf

Hubs relacionados

Preguntas frecuentes

¿Puedo convertir un README que no esté en la raíz del repositorio?

Sí, puedes especificar la ruta exacta del archivo en el campo 'Ruta del README'.

¿Es posible cambiar el tamaño del papel?

Sí, la herramienta permite seleccionar entre formatos A4, Letter, Legal y A5.

¿Se conservan los estilos de GitHub en el PDF?

Sí, la herramienta aplica un estilo tipo GitHub para asegurar que la documentación se vea profesional y familiar.

¿Qué hace la opción 'Imprimir fondo'?

Permite incluir o excluir los colores de fondo y elementos visuales del README en el PDF final.

¿Puedo ajustar el tamaño de la fuente?

Sí, puedes configurar el tamaño base de la fuente entre 10px y 20px para mejorar la legibilidad.

Documentación de la API

Punto final de la solicitud

POST /es/api/tools/github-readme-to-pdf

Parámetros de la solicitud

Nombre del parámetro Tipo Requerido Descripción
repository text -
branch text No -
readmePath text No -
theme select No -
baseFontSize number No -
pageSize select No -
landscape checkbox No -
printBackground checkbox No -
marginTop number No -
marginBottom number No -
marginLeft number No -
marginRight number No -
waitUntil select No -
waitTime number No -

Formato de respuesta

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Archivo: Archivo

Documentación de MCP

Agregue este herramienta a su configuración de servidor MCP:

{
  "mcpServers": {
    "elysiatools-github-readme-to-pdf": {
      "name": "github-readme-to-pdf",
      "description": "Obtiene un README de GitHub y lo renderiza en PDF",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=github-readme-to-pdf",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Puede encadenar múltiples herramientas, por ejemplo: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máximo 20 herramientas.

Si encuentra algún problema, por favor, póngase en contacto con nosotros en [email protected]