Markdown to PDF Workflow

Sistema completo y automatizado para convertir documentos Markdown a PDFs de calidad profesional con un solo comando.

Características

• Conversión en 1 comando - De Markdown a PDF en segundos
• Dos estilos profesionales - Simple (minimalista) y Eisvogel (premium)
• Instalación automática - Descarga e instala Eisvogel automáticamente
• Soporte de imágenes - Portadas personalizadas y marcas de agua
• Plantillas listas - Generador automático de documentos
• Configuración reutilizable - Un setup, infinitos documentos
• UTF-8 completo - Soporte para acentos, ñ y caracteres especiales

Ejemplos

Estilo Eisvogel

Inicio Rápido

Requisitos Previos

1. Windows 7 o superior
2. Pandoc - Conversor de documentos
3. MiKTeX - Motor LaTeX (~300MB)

🐧 Para Linux: Ve a Tutorial Linux

Instalación

# 1. Clonar repositorio
git clone https://github.com/PauLopNun/markdown-pdf-workflow
cd markdown-pdf-workflow

# 2. Copiar scripts a tu carpeta de trabajo
# O añadir al PATH de Windows para acceso global

Uso Básico

# Crear nuevo documento
.\new-doc.ps1 mi-practica -Style eisvogel

# Editar el archivo .md generado

# Convertir a PDF
.\convert.ps1 mi-practica.md -Template eisvogel

# Listo - Tu PDF profesional está generado

Nota sobre ejecución de scripts en PowerShell

En PowerShell hay dos formas de ejecutar scripts:

• .\script.ps1 → Obliga a usar un archivo que esté exactamente en la carpeta actual.
• script.ps1 (sin .\) → PowerShell lo busca en el PATH o en la ubicación actual según su configuración.

👉 Si no añadiste la carpeta scripts/ al PATH, deberás usar .\ y estar en la carpeta donde están los .ps1. 👉 Si añadiste scripts/ al PATH, puedes llamar new-doc.ps1 y convert.ps1 directamente desde cualquier carpeta.

Estructura del Proyecto

markdown-pdf-workflow/
├── scripts/
│   ├── convert.ps1           # Script de conversión MD → PDF
│   ├── convert.sh            # Script de conversión MD → PDF (Linux)
│   ├── new-doc.ps1           # Generador de plantillas
│   ├── new-doc.sh            # Generador de plantillas (Linux)
├── ejemplos/
│   ├── documento-simple.md
│   ├── documento-eisvogel.md
│   ├── portada.jpg            # Ejemplo de portada
│   └── watermark.png          # Ejemplo de marca de agua
├── docs/
│   ├── TUTORIAL-WINDOWS.md    # Tutorial completo (Windows)
│   └── TUTORIAL-LINUX.md      # Tutorial completo (Linux)
└── README.md

Casos de Uso

• Trabajos académicos - Prácticas, proyectos, TFG/TFM
• Documentación técnica - APIs, manuales, guías
• Reportes profesionales - Informes, análisis, presentaciones
• Apuntes de clase - Notas organizadas y formateadas

Personalización

Portadas Personalizadas

---
title: "Mi Documento"
titlepage-background: ./mi-portada.jpg
titlepage-text-color: "FFFFFF"
---

Marcas de Agua

page-background: ./mi-logo.png

Estilos de Código

Soporta resaltado de sintaxis para 200+ lenguajes:

```python
def hola_mundo():
    print("Hola!")
```

Documentación

• Tutorial Completo
• Tutorial Linux
• Solución de Problemas
• Tips y Trucos

Contribuir

Las contribuciones son bienvenidas:

1. Fork el proyecto
2. Crea tu rama (git checkout -b feature/mejora)
3. Commit cambios (git commit -m 'Añadir mejora')
4. Push a la rama (git push origin feature/mejora)
5. Abre un Pull Request

Comandos Rápidos

Acción	Comando
Crear documento simple	.\new-doc.ps1 nombre
Crear documento Eisvogel	.\new-doc.ps1 nombre -Style eisvogel
Convertir simple	.\convert.ps1 nombre.md
Convertir Eisvogel	.\convert.ps1 nombre.md -Template eisvogel

Problemas Conocidos

• Primera conversión lenta (MiKTeX descarga paquetes)
• Portadas requieren imágenes oscuras para texto blanco visible
• PATH debe configurarse manualmente en Windows

Licencia

MIT License - Consulta LICENSE para más detalles

Agradecimientos

• Pandoc - Motor de conversión
• Eisvogel - Plantilla LaTeX
• MiKTeX - Distribución LaTeX

Enlaces Útiles

• Sintaxis Markdown
• Documentación Pandoc
• Eisvogel Template

---

¿Te resultó útil? Dale una estrella al repositorio