Problemas comunes con la exportación estándar de PDF en Obsidian

La funcionalidad nativa de exportación a PDF en Obsidian es básica y suele carecer de características avanzadas como tablas de contenido interactivas, encabezados/pies de página personalizados y un control fino sobre el estilo. El plugin Better Export PDF resuelve estas limitaciones, proporcionando un conjunto robusto de herramientas para transformar tus notas Markdown en documentos PDF con apariencia profesional.

Características Principales del Plugin

• Vista Previa en Tiempo Real: Observa el documento final antes de generarlo.
• Marcadores y Esquema: Genera automáticamente un índice navegable basado en los encabezados del documento.
• Pies de Página Personalizados: Añade números de página, títulos o textos personalizados.
• Exportación Múltiple: Combina varios archivos en un solo PDF o exportalote de archivos individuales.
• Estilos CSS Personalizados: Aplica hojas de estilo específicas para la impresión.
• Metadatos del Documento: Extrae automáticamente información como título, autor y palabras clave desde el YAML front matter.
• Formatos de Página Flexibles: Define tamaños de página personalizados o ajusta todo el contenido a una sola página.

Guía de Instalación y Configuración Rápida

1. En Obsidian, navega a Configuración > Complementos de la comunidad. Desactiva el modo restringido si es necesario.
2. Busca "Better Export PDF" en el explorador de complementos e instálalo.
3. Habilita el cmoplemento y accede a su configuración desde el menú de complementos instalados.
4. Ajusta parámetros por defecto como el nivel máximo de encabezados para el índice o las plantillas para encabezados y pies de página.

Flujos de Trabajo de Exportación

Exportación de un Archivo Único

Abre la nota deseada. Utiliza el comando de paleta (Ctrl/Cmd + P) y ejecuta Export Current File to PDF. Se abrirá un diálogo donde podrás previsualizar el resultado y ajustar opciones como los márgenes antes de exportar.

Fusión de Múltiples Notas en un Solo PDF

Crea un archivo "índice" (por ejemplo, 00-Indice.md) y utiliza enlaces wiki para referenciar, en el orden deseado, las notas que formarán el documento. En las propiedades YAML (---) de este archivo índice, añade la línea toc: true. Al exportar este archivo índice con el plugin, se generarán los marcadores y se combinará el contenido de todas las notas enlazadas en un único PDF.

Exportación por Lotes de una Carpeta

En el explorador de archivos de Obsidian, haz clic derecho en una carpeta. Selecciona Exportar cada archivo a PDF para crear PDFs individuales, o Exportar carpeta a PDF para fusionar todas las notas de la carpeta en un solo documento.

Técnicas Avanzadas de Personalización

Personalización Visual mediante CSS

Puedes crear un archivo de fragmentos de CSS (en Apariencia > Fragmentos de CSS) con reglas específicas para la exportación a PDF. Esto permite definir fuentes, tamaños y espaciados ideales para impresión.

@media print {
  body {
    --font-text-override: "Georgia", serif;
    --font-text-alt: 14pt;
    line-height: 1.6;
  }
  h1, h2 {
    page-break-after: avoid;
  }
}

Incorporación de Metadatos desde el Front Matter

Incluye campos específicos en el bloque YAML de tus notas. El plugin los leerá para rellenar los metadatos del documento PDF resultante.

---
titulo: Informe de Proyecto Q4
autor: Departamento de Desarrollo
palabras_clave: [obsidian, pdf, reporte]
fecha_creacion: 2024-05-15
---

Diseño de Encabezados y Pies de Página con HTML

En la configuración del plugin, puedes usar código HTML para diseñar encabezados y pies de página dinámicos. Las clases pageNumber y totalPages se reemplazarán automáticamente durante la exportación.

<div style="text-align: center; font-size: 9px; border-top: 1px solid #ccc; padding-top: 5px;">
  Documento: <span class="title"></span> | Pág. <span class="pageNumber"></span> de <span class="totalPages"></span>
</div>

Estructura del Código Fuente (Referencia)

Para desarrolladores interesados en contribuir o entender el funcionamiento interno, la estructura es aproximadamente la siguiente:

• Generación del PDF: src/pdf.ts - Lógica central para la creación del documento y los marcadores.
• Interfaz de Usuario: src/modal.ts - Componentes para el diálogo de exportación y vista previa.
• Gestión de Configuración: src/setting.ts - Panel de ajustes del complemento.
• Internacionalización: src/i18n/ - Archivos de traducción para múltiples idiomas.

El archivo package.json lista todas las dependencias del proyecto y los scripts para construirlo.