# Trae tu trabajo existente a Oleafly

Importa un archivo de proyecto, convierte un documento, trae un paquete de código de arXiv, copia un repositorio de GitHub o convierte un proyecto de LaTeX en un proyecto de Typst.

Elige **Proyecto nuevo → Importar un proyecto**, o usa **Importar** en la biblioteca. Oleafly crea un proyecto local nuevo y deja sin cambios el archivo o repositorio original. A menos que la importación traiga su propio repositorio de Git, los archivos importados se convierten en el [primer commit de Git](/docs/new-project/#the-first-git-commit) del proyecto, **Create project**.

![Elige Importar proyecto en el diálogo de proyecto nuevo para empezar con un trabajo existente.](https://cdn.oleafly.com/images/screenshots/desktop/docs/new-project-dark-window-v2.png)

## Elige la ruta que corresponde a tu origen

| Lo que tienes | Ruta de importación | Proyecto que puedes crear |
| --- | --- | --- |
| Una carpeta de proyecto completa | **Proyecto existente** (`.zip`) | El código archivado, las figuras, la bibliografía y los archivos de estilo locales |
| Un documento de Word | **Documento de Word** (`.docx`) | LaTeX, Markdown o Typst |
| Un documento de Markdown | **Documento de Markdown** (`.md`, `.markdown`) | LaTeX o Typst |
| Un documento HTML | **Página HTML** (`.html`, `.htm`) | LaTeX, Markdown o Typst |
| Un documento de Typst | **Documento de Typst** (`.typ`) | LaTeX o Markdown |
| Un artículo de arXiv | **Artículo de arXiv** con un ID o una URL | El paquete de código LaTeX del artículo |
| Un repositorio de GitHub | **GitHub** | Un proyecto local conectado al repositorio |
| Un PDF sin código fuente editable | **Herramientas de Oleafly → Conversores de PDF** | LaTeX, Markdown o Typst reconstruido, según la herramienta que elijas |
| Un proyecto de LaTeX que ya está en Oleafly | **Convertir en un proyecto de Typst** en la paleta de comandos | Un proyecto de Typst nuevo, y el proyecto de LaTeX queda como estaba |

Elige el mismo formato de autoría solo cuando Oleafly lo ofrezca. Para conservar un archivo de Markdown o Typst en su formato original, empieza un proyecto en blanco para ese formato y añade el archivo de código mediante el [árbol de archivos](/docs/files/#adding-existing-files).

## Importa un archivo de proyecto completo

Usa un ZIP cuando ya tengas un árbol de código que funciona.

1. Reúne en una carpeta el documento principal, las figuras, la bibliografía y los archivos locales de clase o de estilo. Conserva las rutas relativas que usa el código.
2. Comprime la carpeta como un archivo `.zip`.
3. Elige **Importar → Proyecto existente** y selecciona el ZIP.
4. Comprueba el documento principal marcado con la estrella en el árbol de archivos importado.
5. Compila. Si el proyecto necesita otra cadena de herramientas de LaTeX, elígela en el menú del compilador.

Por ejemplo, mantén juntos `main.tex`, `references.bib`, `sections/method.tex` y `figures/plot.pdf`. Un ZIP del código conserva esas relaciones. Un PDF no contiene la misma estructura de proyecto editable.

Si el archivo contiene más de un documento principal probable, confirma el correcto en el menú de archivos antes de compilar.

## Qué compilador de LaTeX usa una importación

Un proyecto de LaTeX importado o convertido empieza con el motor de compilación predeterminado de **Ajustes → Motores → LaTeX**, que es Tectonic salvo que lo hayas cambiado. Cuando ese valor predeterminado es `latexmk` y el proyecto indica pdfLaTeX, XeLaTeX o LuaLaTeX, conserva ese compilador. Si la importación detecta funciones que Tectonic no puede manejar, se abre el diálogo del motor para que elijas otro. Consulta [Define un valor predeterminado para los proyectos nuevos](/docs/engines/#set-a-default-for-new-projects) y [Cuando Tectonic no basta](/docs/latex-engines/#when-tectonic-isnt-enough).

## Convierte Word, Markdown, HTML o Typst

1. Elige el tipo de documento correspondiente en **Importar**.
2. Selecciona el archivo.
3. Si Oleafly ofrece más de un destino, elige el formato que quieres editar a continuación. LaTeX está marcado como la ruta recomendada.
4. Completa la configuración de Pandoc si se te pide. Oleafly puede usar una instalación compatible o descargar su versión administrada.
5. Abre el proyecto nuevo, compílalo y compáralo con el original.

Las conversiones se ejecutan localmente mediante Pandoc. Una importación de Word o HTML también extrae los medios incrustados al proyecto para que el código convertido pueda hacer referencia a ellos. Un documento de Markdown importado a un proyecto de LaTeX conserva sus citas: `[@key]` se convierte en `\citep` o `\citet`, y el archivo de bibliografía viene incluido, de modo que el panel de Referencias tiene tus fuentes desde el principio.

Elige el destino según el trabajo que tienes por delante:

- **LaTeX** es adecuado para plantillas de revista, composición tipográfica detallada y flujos de PDF etiquetado.
- **Markdown** es adecuado para un formato de código más ligero y una conversión amplia de documentos.
- **Typst** es adecuado para una compilación rápida y plantillas nativas de Typst.

La conversión conserva la estructura del documento cuando el formato de origen la expone. Los diseños de página específicos de Word, el estilo HTML personalizado, las tablas ajustadas a mano, las citas y las ecuaciones complejas aún pueden necesitar una pasada de limpieza. Compara los encabezados, las listas, las tablas, las ecuaciones, los enlaces, las citas y la colocación de las imágenes antes de eliminar el original.

## Importa un paquete de código de arXiv

Elige **Artículo de arXiv** y pega un identificador como `2401.01234` o una URL `arxiv.org/abs/...`. Oleafly descarga el paquete de código enviado y lo abre como un proyecto de LaTeX.

Usa esta ruta cuando necesites el código editable de los autores. Usa [De arXiv a LaTeX](/docs/tools/arxiv-to-latex/) cuando quieras inspeccionar o guardar un archivo de código sin empezar desde el diálogo de importación, y [De arXiv a Typst](/docs/tools/arxiv-to-typst/) cuando quieras el artículo convertido a Typst. Un identificador de arXiv necesita conexión a internet; un archivo de código que ya está en el disco, no.

Comprueba siempre la licencia y los términos de los autores antes de reutilizar el código o las figuras.

## Importa desde GitHub

Elige **GitHub** en el diálogo de importación. Si hace falta, conecta tu cuenta mediante **Ajustes → Integraciones → GitHub** y luego selecciona un repositorio al que tengas acceso.

Oleafly crea una copia local en la biblioteca. Comprueba su documento principal y ejecuta una compilación antes de editar. La [sincronización con GitHub](/docs/github-sync/) explica cómo descargar, confirmar y publicar cambios después de la importación.

## Convierte un proyecto de LaTeX en un proyecto de Typst

Oleafly puede hacer una copia en Typst de un proyecto de LaTeX que ya tengas. El proyecto de LaTeX no se modifica.

1. Abre el proyecto de LaTeX.
2. Abre la paleta de comandos ⌘K (Ctrl+K) y ejecuta **Convertir en un proyecto de Typst**.
3. Revisa el **Nombre del proyecto nuevo**. De forma predeterminada es el nombre del proyecto seguido de `(Typst)`.
4. Elige **Convertir**. Oleafly convierte el proyecto con Pandoc, crea el proyecto de Typst y lo compila una vez como comprobación.
5. Lee el informe y luego elige **Abrir el proyecto de Typst**.

El informe indica si el proyecto nuevo compila, cuenta lo que se convirtió y enumera lo que necesita una corrección manual, con enlaces a cada error de compilación. [Proyectos de Typst](/docs/typst/#convert-a-latex-project-to-typst) explica la conversión y el informe en detalle.

## Reconstruye un PDF

Activa **Herramientas de LaTeX** en **Ajustes → Experimentación** y luego elige la herramienta que corresponde a la salida que necesitas:

- [De PDF a LaTeX](/docs/tools/pdf-to-latex/) para un proyecto de LaTeX o un archivo de código
- [De PDF a Markdown](/docs/tools/pdf-to-markdown/) para Markdown editable
- [De PDF a Typst](/docs/tools/pdf-to-typst/) para Typst editable

El flujo local de PDF lee la capa de texto, restablece el orden de lectura y extrae las figuras. En **De PDF a LaTeX**, cambia al modo de documento escaneado cuando el PDF esté formado por imágenes de página. Esa ruta usa el modelo para Herramientas, un modelo local de Ollama salvo que elijas otro, y admite documentos de hasta 50 páginas.

Compara el resultado con el PDF página por página. Las columnas, las ecuaciones, las tablas, las notas al pie y el orden de lectura son problemas de reconstrucción, así que ninguna conversión de PDF debe tratarse como el código original.

## Añade referencias sin importar un manuscrito

Importa BibTeX, RIS, EndNote XML o Zotero RDF mediante [Referencias y citas](/docs/citations/#import-a-whole-reference-library). Enlaza una carpeta de artículos o datos como [contexto de investigación de solo lectura](/docs/linked-folders/) cuando deba quedar fuera del proyecto.