# Exporta y convierte un proyecto

Guarda el último PDF, empaqueta el código fuente editable, exporta imágenes de página o HTML, escribe PDF/A y PDF/UA desde Typst o convierte un documento de LaTeX, Typst o Markdown.

Abre **Exportar** en la barra de herramientas del proyecto. El menú sigue el motor y el tipo del documento actual, así que solo muestra las rutas que Oleafly puede ejecutar para ese proyecto.

![Exportar es el control de descarga que está justo después de Recompilar en la barra superior del proyecto.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png#view=1282,0,232,48)

## Elige la salida que necesita tu destinatario

- **PDF** sirve para leer, imprimir y para la mayoría de los portales de envío.
- **ZIP del código** sirve para coautores o sistemas que necesitan el manuscrito, las figuras, la bibliografía y los estilos locales.
- **PNG de página** sirve para una diapositiva, un mensaje o un sistema de revisión que espera una imagen.
- **PNG, SVG o HTML escritos por Typst** sirve para proyectos de Typst que necesitan cada página como imagen, páginas vectoriales o una página web.
- **Word, HTML, Markdown, Typst, LaTeX o texto sin formato** sirve para quien necesita editar o reutilizar el contenido en otro formato.
- **PowerPoint** sirve para convertir una presentación o un documento de Markdown en diapositivas. **EPUB** sirve para un lector de libros electrónicos. Cuáles aparecen depende del motor. Consulta [Exportaciones de presentaciones y libros](#presentation-and-book-exports).

## Guarda un PDF, un archivo del código o una imagen de página

1. Elige **Recompilar** para que la salida incluya tus últimas ediciones.
2. Inspecciona el PDF, incluidas las últimas páginas y la bibliografía.
3. Abre **Exportar**.
4. Elige **Exportar como PDF**, **Exportar el código (.zip)** o **Exportar la página como PNG**.
5. Elige un destino en el diálogo de guardado.
6. Elige **Mostrar en la carpeta** en el mensaje de finalización para encontrar el archivo guardado.

Las acciones de PDF y de imagen de página permanecen desactivadas hasta que el proyecto tenga un PDF, y el menú dice **El PDF requiere compilar primero**. **Exportar como PDF** guarda el PDF que se ve en la vista previa. **Exportar la página como PNG** guarda la página que estás viendo en la vista previa, en alta resolución.

Un archivo del código excluye las cachés de compilación y los elementos internos de Git. También deja fuera los enlaces simbólicos, y el mensaje de finalización indica cuántos omitió.

### Cuando el PDF no está al día

Oleafly guarda igualmente el PDF o la imagen de página cuando la vista previa está desactualizada, y el mensaje de finalización te lo dice:

- Después de una compilación fallida, indica que la última compilación falló, así que el archivo puede estar incompleto.
- Después de ediciones que no has compilado, indica que el archivo viene de la última compilación y no incluye tus últimas ediciones.

Recompila, revisa la vista previa y vuelve a exportar antes de enviar el archivo a nadie.

## Imágenes y HTML de Typst

El menú Exportar de un proyecto de Typst también tiene **Imágenes y HTML**, que abre **Exportar con Typst**. Typst dibuja estos archivos por sí mismo, así que las páginas PNG y SVG se ven exactamente igual que el PDF.

- Las **imágenes PNG** toman una **Resolución** de 72, 144, 300 o 600 PPI.
- Las **imágenes SVG** conservan las páginas como gráficos vectoriales.
- **HTML** está marcado como **Experimental**. El HTML de Typst conserva el texto y las imágenes, pero deja fuera la configuración de página y los dibujos. Antes de Typst 0.15 también deja fuera las ecuaciones, y el diálogo lo indica cuando eliges HTML.

Para PNG y SVG, **Páginas** admite números de página y rangos como `1, 3-5` o `8-`. Déjalo vacío para exportar todas las páginas. Cada página se guarda como un archivo propio, numerado a partir del nombre que elijas. Los rangos de páginas requieren Typst 0.12 o posterior, y HTML requiere Typst 0.13 o posterior. El diálogo solo ofrece lo que la versión de Typst del proyecto puede hacer. Si el proyecto tiene [variantes de compilación](/docs/typst/#build-variants-and-sysinputs), la exportación usa la que esté seleccionada en el menú de compilación.

## PDF/A y PDF/UA desde Typst

Typst escribe por sí mismo PDF de archivo y accesibles. Abre el **escudo** en la barra lateral del proyecto para ver [Preflight](/docs/preflight/) y busca **Estándares de PDF** en la comprobación **Accesibilidad**. Elige un **Estándar**, como PDF/A-2b o PDF/UA-1, y luego **Exportar PDF**.

La lista depende de la versión de Typst del proyecto. Typst 0.11 no tiene ninguno, Typst 0.12 ofrece PDF/A-2b, Typst 0.13 añade PDF/A-3b, y Typst 0.14 y posteriores ofrecen todos los niveles de PDF/A además de PDF/UA-1. Typst 0.14 y posteriores también etiquetan todos los PDF para lectores de pantalla, así que no hay una compilación etiquetada aparte. PDF/UA-1 necesita un título del documento y texto alternativo para cada imagen, y Preflight comprueba ambos.

## Formatos editables

| Motor del proyecto | Formatos en Exportar |
| --- | --- |
| **LaTeX** | Word, HTML autónomo con MathML, Markdown, Typst y texto sin formato |
| **Typst** | LaTeX, Word, HTML autónomo con MathML, Markdown y texto sin formato |
| **Markdown** | Word, HTML autónomo con MathML, Typst, LaTeX y texto sin formato |

Un proyecto de Typst también ofrece EPUB, y un proyecto de Markdown ofrece PowerPoint y EPUB. Un proyecto de LaTeX los ofrece solo para una clase de documento compatible.

Estas conversiones se ejecutan localmente mediante Pandoc. Oleafly usa una instalación compatible de tu equipo o descarga una compilación administrada verificada la primera vez que hace falta.

Los proyectos de Typst siguen otra ruta. Typst escribe primero el documento como HTML, y Pandoc convierte ese HTML en Word, HTML, Markdown, LaTeX, texto sin formato o EPUB, de modo que las ecuaciones y las referencias se conservan. Que un documento pueda seguir esa ruta depende de la versión de Typst del proyecto:

| Versión de Typst | Ruta |
| --- | --- |
| 0.15 o posterior | A través de HTML |
| 0.13 y 0.14 | A través de HTML cuando Typst puede escribir el documento entero. Cuando no puede, Pandoc lee el código fuente de Typst. |
| 0.12 o anterior | Pandoc lee el código fuente |

Si Typst se detiene con un error al escribir el HTML, Pandoc lee el código fuente en cualquier versión. Cuando Pandoc lee el código fuente en Typst 0.13 o 0.14, el mensaje de finalización avisa de que puede faltar el texto girado, escalado, movido o sesgado, salvo que la exportación tenga advertencias. Para la exportación más completa, cambia el proyecto a Typst 0.15 o posterior en **Versión de Typst (este proyecto)**, dentro del menú de compilación.

Cuando la exportación pasa por HTML, el texto que está dentro de funciones de maquetación como `align`, `grid` y `rotate` se conserva. Un dibujo hecho con CeTZ pierde sus líneas y formas y conserva solo sus etiquetas de texto, y el mensaje de finalización nombra lo que Typst dejó fuera.

## Convierte un documento

1. Compila una vez y corrige los errores del código.
2. Abre **Exportar** y elige el formato de destino.
3. Completa la configuración de Pandoc si se te pide. Si Oleafly dice que Pandoc no está disponible, elige **Reparar Pandoc** en **Ajustes → Motores → Markdown** y vuelve a exportar.
4. Guarda el archivo convertido con la extensión sugerida.
5. Lee el mensaje de finalización. Si menciona advertencias, elige **Mostrar las advertencias** para ver lo que la exportación dejó fuera.
6. Abre el archivo en la app de destino y revisa su estructura y su aspecto.

Para una prueba rápida, exporta una sección corta que contenga un encabezado, una ecuación, una tabla, una imagen y una cita. Si esos cinco elementos se conservan bien, convierte el manuscrito completo y vuelve a revisarlo.

Para convertir un proyecto de LaTeX completo en un proyecto de Typst en el que seguir trabajando, usa en su lugar [Convertir en un proyecto de Typst](/docs/typst/#convert-a-latex-project-to-typst). Crea un proyecto nuevo e informa de lo que requiere atención.

### Qué conserva la conversión

Pandoc procura conservar los encabezados, los párrafos, las listas, los enlaces, las citas, las tablas, las imágenes y las fórmulas editables. No puede reproducir todas las funciones del lenguaje de origen en todos los destinos. Revisa con atención estas áreas:

- comandos y entornos personalizados de LaTeX
- diseño de página o elementos flotantes ajustados a mano
- tablas complejas o anidadas
- estilo de bibliografía y presentación de las citas
- funciones de Typst sin equivalente directo en el destino
- HTML sin procesar o extensiones de Markdown

La exportación a HTML incrusta sus recursos y escribe las ecuaciones como MathML. Eso la hace útil para compartir un documento que debe abrirse por sí solo, pero conviene probarla en los navegadores que usan tus lectores.

### Qué conserva cada formato

- Las exportaciones a Word y PowerPoint convierten las figuras PDF, SVG y WebP en imágenes PNG a 220 PPI. Una figura sin tamaño en el código conserva su propio ancho.
- Las exportaciones a HTML y EPUB convierten las figuras PDF en imágenes PNG.
- El Markdown y el texto sin formato exportados desde LaTeX conservan el título, el autor y el resumen.
- Las exportaciones de LaTeX a Markdown o Typst, y de Markdown a LaTeX o Typst, enlazan los archivos de figuras del proyecto en lugar de copiarlos. Salvo que la exportación tenga advertencias, el mensaje de finalización te recuerda copiar las imágenes y la bibliografía junto al archivo exportado antes de compilarlo. Un documento de Markdown exportado a Typst o LaTeX conserva la bibliografía que declara, o los archivos `.bib` del proyecto si no declara ninguna.
- Una exportación a LaTeX de un documento Markdown sigue su [tipo de documento](/docs/writing/markdown/#document-types). Las diapositivas y los pósteres se convierten en código Beamer, un informe o un libro empieza los capítulos en los encabezados `#`, y una carta se convierte en una carta de KOMA-Script.
- Una exportación a LaTeX desde Typst copia las imágenes del documento en una carpeta `<name>-media` junto al archivo `.tex`. Allí las imágenes SVG, GIF y WebP se convierten en PDF, porque LaTeX no puede leerlas.

Las exportaciones buscan las figuras en la carpeta del documento principal, en la raíz del proyecto y en las carpetas de `\graphicspath`, y encuentran una figura nombrada sin su extensión. Las figuras EPS no se pueden convertir, así que pasan al archivo sin cambios, con una advertencia. En una exportación a Word, HTML, EPUB o PowerPoint de un documento de Markdown, un bloque de Mermaid muestra la figura guardada para él.

### Advertencias después de exportar

Pandoc deja fuera lo que un formato no puede contener. Cuando eso ocurre en una exportación de un proyecto de LaTeX o de Markdown, o en una exportación de Typst que lee el código fuente, el mensaje de finalización dice que el archivo se guardó con advertencias y cuántas, en lugar de sus otras notas, como el recordatorio de copiar las imágenes. Elige **Mostrar las advertencias** para abrir **Advertencias de la exportación**, que enumera lo que se perdió. **Mostrar en la carpeta**, en ese diálogo, abre la carpeta con el archivo guardado.

La lista puede nombrar:

- un bloque que la exportación dejó fuera, con su archivo y su línea cuando se conocen, como un `tikzpicture`, un `\includepdf` o un comando de superposición de Beamer como `\only` o `\uncover`
- una figura que la exportación no pudo encontrar o convertir
- una clave de cita que no está en la bibliografía
- matemáticas que se quedaron como código TeX
- referencias que aún no tienen número, algo que arregla una compilación

Una advertencia repetida aparece una sola vez, y la lista se detiene en 50. Una exportación a PowerPoint funciona de otro modo cuando falta una figura: se detiene, no guarda ningún archivo y el error nombra la figura. Las exportaciones de Typst que pasan por HTML dicen en el mensaje de finalización lo que Typst dejó fuera.

## Exportaciones de presentaciones y libros

Un proyecto de LaTeX las asocia a su clase de documento. **Exportar como PowerPoint (.pptx)** aparece para una presentación de Beamer, y **Exportar como EPUB (.epub)** para las clases `book`, `report`, `memoir`, `scrbook` y `scrreprt`.

En una presentación de Beamer, cada frame inicia una diapositiva nueva, `\section` añade una diapositiva de sección y `\subsection` no añade ninguna. Un frame con más de una imagen, o con una imagen y otro contenido, puede ocupar una segunda diapositiva.

En los proyectos de Typst y de Markdown, el menú no comprueba el documento para estas exportaciones. Un proyecto de Markdown siempre ofrece ambas, y un proyecto de Typst siempre ofrece EPUB. Cuando un documento de Markdown se convierte en PowerPoint, cada encabezado de nivel 1 se convierte en una diapositiva de sección y cada encabezado de nivel 2 inicia una diapositiva nueva. La excepción es un documento con `type: slides`: una línea `slide-level` en su front matter elige el nivel de encabezado que inicia una diapositiva. Todo EPUB recibe una tabla de contenido, y sus ecuaciones son MathML.

Úsalas como puntos de partida editables. La composición de diapositivas y la tipografía de un libro rara vez se corresponden uno a uno entre formatos, así que inspecciona cada diapositiva o capítulo en su app de destino.

## Exporta una figura independiente

Un proyecto de figura independiente ofrece **Exportar como PDF (imagen vectorial)** y **Exportar como PNG** después de compilar. Elige PDF para líneas y texto nítidos a cualquier escala. Elige PNG cuando el destino solo acepte imágenes ráster.

## Guarda la salida dentro del proyecto

La [vista previa del PDF](/docs/pdf-preview/) también ofrece **Guardar el PDF en el proyecto**. Así conservas una copia para el envío o una figura compilada junto al código. Para mantener esa copia al día, activa [Sincronizar PDF al compilar](/docs/pdf-preview/#sync-pdf-on-compiles) en el mismo menú, y Oleafly actualiza un PDF con el nombre del proyecto tras cada compilación correcta. Un PDF anterior se puede guardar desde un [punto de control](/docs/checkpoints/#save-a-pdf-from-a-checkpoint) sin restaurar el proyecto. Añade ese archivo al [historial de Git](/docs/git-history/) solo si quieres versionar la salida generada.

## Revisa antes de compartir

Ejecuta [Preflight](/docs/preflight/) antes de un envío. Si necesitas un PDF etiquetado, sigue el flujo de exportación accesible para LaTeX o elige un estándar PDF/UA en un proyecto de Typst, y luego verifica el resultado con un verificador de PDF/UA independiente y una revisión de accesibilidad hecha por una persona. Preflight comprueba muchas señales útiles, pero no certifica la conformidad.
