Integraciones

Sincronización en la nube: trae tu propia nube

ComdTeX no corre un servidor de sincronización propio y nunca habla con la API de un proveedor. No hay login ni OAuth. En cambio trata la sincronización en la nube como un truco de sistema de archivos que ya tienes: instala el cliente propio de Dropbox, OneDrive o Google Drive, apunta un vault a una carpeta dentro de la raíz sincronizada, y el cliente sincroniza tus archivos .md/.tex/.bib igual que sincroniza cualquier otra cosa.

Lo que ComdTeX agrega encima es detección, no sincronización. Al iniciar, prueba rutas conocidas (~/.dropbox/info.json, ~/Library/CloudStorage/GoogleDrive-*, ~/Library/CloudStorage/OneDrive*, y equivalentes en la carpeta de usuario en Windows/Linux) y, si tu vault está dentro de una de ellas, muestra una insignia ☁ Sync: <Proveedor> en la barra de estado. Si el mismo proveedor está instalado pero tu vault queda afuera de su carpeta, un banner sugiere moverlo; ComdTeX nunca mueve archivos por ti.

El panel de conflictos lista cada copia de conflicto que creó el cliente de la nube, emparejada con su original, con acciones por entrada: abrir ambas, mantener la mía, usar la copia, borrar la copia, o mostrarla en el explorador de archivos. La detección de conflictos se basa en patrones de nombre de archivo:

Proveedor	Patrón	Confianza
Dropbox	nombre (conflicted copy AAAA-MM-DD).ext	Alta
OneDrive	nombre-DISPOSITIVO.ext, solo se marca cuando existe un archivo hermano sin el sufijo	Heurística
Google Drive	No detectable	Limitación documentada

Esa última fila es una limitación honesta, no un descuido: Google Drive para Escritorio no crea archivos de copia de conflicto. Cuando dos dispositivos compiten, Drive se queda en silencio con la versión subida más recientemente y guarda la otra en su propio historial de versiones, algo que ComdTeX no tiene forma de ver. Si necesitas garantías más fuertes que “gana el último en escribir”, pon el vault también bajo Git; la sincronización en la nube queda como respaldo rápido, y Git es tu historial real.

Configuración → Sync tiene dos interruptores independientes: cloudSyncDetectEnabled (interruptor maestro de la detección, la insignia y las marcas en el árbol de archivos) y cloudSyncBannerEnabled (solo el banner de sugerencia “mover a la nube”). Recorrido completo: docs/cloud-sync.md en el repositorio de la app.

Git y colaboración guiada

El panel de Git (el botón de rama en la barra superior) te da rama, cambios preparados/sin preparar, commit, push, más las superficies habituales: ramas, remotos, stash. Funciona en cualquier vault que ya sea un repositorio Git, o se convierte en uno con un clic si todavía no lo es.

Encima de eso está la colaboración guiada, una sección en lenguaje simple para coautores que no saben Git. Usa los mismos comandos por debajo, pero habla en términos de “guardar y enviar” y “traer cambios” en vez de commit y pull:

Estado	Qué significa	Qué presionar
Trabajo sin guardar en el historial	Escribiste algo desde el último punto de guardado	Guardar y enviar
N cambios nuevos de tu coautor	Te enviaron trabajo que todavía no tienes	Traer cambios
N cambios guardados esperando enviarse	Tus puntos de guardado no llegaron a la copia compartida	Enviar cambios
Al día con la copia compartida	No hay nada que hacer	Nada

Configurar la colaboración es un paso único: crea un repositorio privado y vacío (un botón abre GitHub directamente, aunque funciona con cualquier host de Git), pega su dirección, y tu vault se sube y se convierte en la copia compartida. Tu coautor lo clona una vez y abre esa carpeta como vault.

Cuando los dos editan las mismas líneas, traer cambios puede detenerse en un conflicto. La sección guiada lista cada archivo en conflicto con botones Mantener la mía / Usar la suya; para un resultado mixto, abre el archivo directamente y edita entre las marcas <<<<<<< / ======= / >>>>>>>, y luego presiona Terminar la fusión. Recorrido completo: Escribir con alguien más.

Zotero

El Gestor de Citas trae entradas directamente desde una instancia de Zotero en ejecución con el plugin Better BibTeX instalado, a través de su API local JSON-RPC en http://localhost:23119. Sin paso de exportación, sin un .bib intermedio que manejar a mano: eliges la entrada en Zotero y termina en references.bib.

Además de la importación desde Zotero, el Gestor de Citas puede buscar una entrada directamente a partir de un identificador:

Identificador	Fuente
DOI	CrossRef, y luego DataCite
ID de arXiv	Se resuelve a través de su DOI (10.48550/arXiv.*)
Bibcode de NASA ADS	api.adsabs.harvard.edu; el token de ADS se guarda en el llavero del sistema operativo, nunca en configuración
Registro de INSPIRE-HEP	IDs de registro o URLs explícitas

Obsidian y Overleaf

ComdTeX edita en memoria un formato interno (CMDX), pero lo que queda en disco siempre es .md plano (compatible con Obsidian) o .tex válido (compatible con Overleaf). Puedes tener el mismo vault abierto en Obsidian y en ComdTeX a la vez; los cambios se sincronizan sin fricción porque la conversión es completa, no una aproximación:

En disco	En el editor de ComdTeX
> [!note] Título (callout de Obsidian)	:::note[Título]
\begin{theorem}[Nombre] (LaTeX)	:::theorem[Nombre]
\frac{a}{b} (LaTeX)	frac(a, b)
\begin{bmatrix}…\end{bmatrix} (LaTeX)	mat(…)

Para el panorama completo, incluyendo cómo los bloques especiales exclusivos de ComdTeX (pseudocódigo, diagramas de flujo, tablas de verdad, Graphviz, gráficas, diagramas conmutativos, Excalidraw) se guardan tal cual para que nada se aplane al guardar, ver Obsidian y Overleaf.

Herramientas de línea de comandos opcionales

Desde la v1.3.0 la compilación de PDF no necesita nada externo: el motor LaTeX en WASM incluido (SwiftLaTeX) compila LaTeX real a PDF dentro del propio proceso. Todo lo demás en esta lista es opcional y solo habilita una ruta específica de exportación o respaldo:

Herramienta	Habilita
pandoc	Exportación a DOCX, diapositivas Beamer, exportación a Typst (.typ), importación de documentos (.docx, .odt, .tex, .html, .epub, .rst, .org, …), Markdown → PDF por la ruta que no usa LaTeX. El PDF ya no lo necesita.
typst	Compilar la salida Typst de pandoc a PDF, y compilación nativa de archivos .typ abiertos directamente en el vault.
zip	Respaldo del vault (exporta como .zip) y exportación de archivo .cmdx.
git	El panel de Git y la colaboración guiada de arriba.
tectonic / xelatex / pdflatex	Un respaldo local opcional de LaTeX: si el motor WASM incluido falla, ComdTeX los prueba en ese orden. También hace falta para SyncTeX real (clic para ir a la fuente desde el PDF); los PDF compilados con WASM caen a una coincidencia por encabezados porque el motor incluido no genera salida synctex.

ComdTeX prueba pandoc, zip y typst al iniciar y muestra un banner de aviso ámbar por cada uno que falte; cada aviso se puede descartar por herramienta y ese descarte persiste entre sesiones. La detección corre a través del plugin de shell de Tauri, que cachea el PATH al iniciar, así que una herramienta instalada después de abrir ComdTeX necesita un reinicio para que se detecte. Instrucciones de instalación por plataforma: docs/installing-deps.md.

Actualizador automático

ComdTeX revisa si hay actualizaciones automáticamente al iniciar. Si hay una versión más nueva disponible, aparece un banner dentro de la app, sin necesidad de visitar GitHub. Todos los artefactos de cada release están firmados con minisign, y el actualizador verifica esa firma antes de aplicar cualquier actualización, así que una actualización solo puede instalarse si salió firmada por el pipeline de release real.