Escribir con alguien más
Sin cuenta propia de ComdTeX, sin la nube de ComdTeX
ComdTeX no tiene un servicio propio de sincronización. En vez de eso, mantiene el vault sincronizado entre coautores usando un repositorio Git que tú controlas: GitHub, GitLab, o cualquier host de Git. Todo esto se maneja desde una sección del panel de Git llamada “Escribir con alguien más”, en lenguaje simple. No necesitas saber Git para usarla.
Compartir un vault, una sola vez
- Abre el panel de Git (el botón de rama en la barra superior). Si el vault todavía no tiene repositorio, el mismo panel lo inicializa.
- En “Escribir con alguien más”, haz clic en Crear repositorio en GitHub. Créalo privado y vacío, sin README.
- Copia la dirección del repositorio (la que empieza con
https://…ogit@…) y pégala en el cuadro; haz clic en Conectar. Tu vault se sube y se convierte en la copia compartida. - Invita a tu coautor desde la configuración del repositorio (Colaboradores). Ellos lo clonan una vez y abren esa carpeta como vault en ComdTeX.
El día a día
La sección siempre muestra una frase que describe dónde estás parado, y uno o dos botones:
| Dice | Significa | Qué presionar |
|---|---|---|
| Tienes trabajo sin guardar en el historial | Escribiste algo desde el último punto de guardado | Guardar y enviar (el mensaje es opcional; si lo dejas vacío se usa uno honesto con la fecha) |
| Hay N cambios nuevos de tu coautor | Te enviaron trabajo que todavía no tienes | Traer cambios |
| Tienes N cambios guardados esperando enviarse | Tus puntos de guardado no llegaron a la copia compartida | Enviar cambios |
| Todo al día con la copia compartida | No hay nada que hacer | Nada |
Si intentas enviar y tu coautor llegó primero, ComdTeX te avisa que traigas sus cambios antes y vuelvas a enviar. Nada se pierde en ese intercambio.
Cuando los dos editaron las mismas líneas
Traer cambios puede detenerse en un conflicto: las mismas líneas cambiaron en ambos lados, y ningún programa debería decidir en silencio cuál versión de un párrafo sobrevive. La sección lista cada archivo en conflicto con dos botones:
- Mantener la mía: se queda tu versión de ese archivo.
- Usar la suya: se queda la versión de tu coautor.
Para un resultado mixto, abre el archivo en el editor en su lugar: las regiones en conflicto están marcadas entre líneas <<<<<<<, ======= y >>>>>>>. Deja lo que quieras, borra las marcas, y guarda. Cuando todos los archivos estén resueltos, presiona Terminar la fusión, y luego envía.
Por dónde viaja tu vault, y cómo lo dice ComdTeX
Ajustes tiene una sección Sync que abre con tu situación real en una frase, en vez de una lista de opciones:
| Tu situación | Qué significa |
|---|---|
| Versionado y compartido | Cada cambio queda registrado, y hay una copia fuera de esta máquina |
| Versionado, solo aquí | El historial existe únicamente en este disco |
| Viajan copias, sin versiones | Una carpeta sincronizada, sin historial, y un conflicto deja un segundo archivo |
| Nada sale de este disco | Ninguna copia en ningún lado |
Cada una viene con su único paso siguiente y un botón que te lleva al panel de Git.
Un repositorio dentro de una carpeta de la nube es el caso a evitar
Si tu vault es un repositorio Git y está dentro de una carpeta de Dropbox, Google Drive o OneDrive, ComdTeX te avisa, y conviene hacerle caso. El cliente de la nube y Git escriben sobre los mismos archivos internos, en el orden en que cada uno termina, y una máquina que baje un estado a medio subir se encuentra un repositorio que el propio Git reporta como roto. No se nota hasta el día en que se nota.
Saca el vault de la carpeta sincronizada y compártelo con un remoto: para eso está un remoto, y así conservas el historial que un repositorio Git existe para conservar.
La detección de nube que sigue ahí
Si nunca vas a usar Git, ComdTeX igual vigila las copias en conflicto que dejan estos servicios (nota (copia en conflicto 2026-05-04).md y similares) y te ofrece abrir ambas, quedarte con la tuya o tomar la de la otra máquina. Nunca mueve ni borra nada por su cuenta. Es una red de seguridad, no un mecanismo de sincronización: no te puede decir qué cambió, y los conflictos de Google Drive no se pueden detectar en absoluto, porque sobrescribe en silencio.
Notas
- Las secciones avanzadas del panel de Git (ramas, staging, stash, remotos) siguen disponibles: la sección guiada es una capa encima, no un reemplazo.
- Funciona con cualquier host de Git, no solo GitHub; el botón de crear simplemente abre GitHub porque es donde ya está la mayoría de los coautores.
- Repositorio privado más historial de Git significa que tus borradores son tuyos, quedan versionados, y no pasan por ningún servidor salvo el que tú elegiste. Es la misma postura local-first del resto de ComdTeX.
Write with someone else
No ComdTeX account, no ComdTeX cloud
ComdTeX has no sync service of its own. Instead, it keeps a vault in sync between coauthors using a Git repository you control: GitHub, GitLab, or any Git host. All of this is driven from a section of the Git panel called “Write with someone else”, in plain language. You never need to know Git to use it.
Sharing a vault (once)
- Open the Git panel (the branch button in the top bar). If the vault has no repository yet, the same panel initializes one.
- In “Write with someone else”, click Create repository on GitHub. Create it private and empty, no README.
- Copy the repository address (the one starting with
https://…orgit@…) and paste it into the box; click Connect. Your vault is uploaded and becomes the shared copy. - Invite your coauthor from the repository’s settings (Collaborators). They clone it once and open that folder as a vault in ComdTeX.
Day to day
The section always shows one sentence describing where you stand, and one or two buttons:
| It says | It means | What to press |
|---|---|---|
| You have work not yet saved to the history | You wrote things since the last save point | Save and send (the message is optional; an honest dated one is used if you leave it empty) |
| There are N new changes from your coauthor | They sent work you do not have yet | Bring changes |
| You have N saved changes waiting to be sent | Your save points have not reached the shared copy | Send changes |
| Everything level with the shared copy | Nothing to do | Nothing |
If you try to send and your coauthor got there first, ComdTeX tells you to bring their changes first, then send again. Nothing is ever lost in that exchange.
When you both edited the same lines
Bringing changes can stop on a conflict: the same lines changed on both sides, and no program should decide silently which version of a paragraph survives. The section lists each conflicted file with two buttons:
- Keep mine: your version of that file stays.
- Use theirs: your coauthor’s version stays.
For a mixed outcome, open the file in the editor instead: the conflicting regions are marked between <<<<<<<, =======, and >>>>>>> lines. Keep what you want, delete the markers, and save. When every file is settled, press Finish the merge, then send.
Where your vault travels, and how ComdTeX says so
Settings has a Sync section that opens with your actual situation in one sentence, rather than a list of options:
| Your situation | What it means |
|---|---|
| Versioned and shared | Every change has a record, and a copy lives outside this machine |
| Versioned, only here | The history exists on this disk alone |
| Copies travel, nothing versioned | A synced folder, no history, and a conflict leaves a second file |
| Nothing leaves this disk | No copies anywhere |
Each one comes with its single next step and a button that takes you to the Git panel.
A repository inside a cloud folder is the case to avoid
If your vault is a Git repository and it sits inside a Dropbox, Google Drive or OneDrive folder, ComdTeX warns you, and it is worth acting on. The cloud client and Git write to the same internal files, in whatever order each finishes, and a machine that pulls a half-uploaded state gets a repository Git itself reports as broken. It stays silent until the day it is not.
Move the vault out of the synced folder and share it with a remote instead: that is what a remote is for, and it keeps the history a Git repository exists to keep.
The cloud detection that remains
If you never want to use Git, ComdTeX still watches for the conflict copies these services leave behind (note (conflicted copy 2026-05-04).md and the like) and offers to open both, keep yours, or take theirs. It never moves or deletes anything on its own. It is a safety net, not a sync mechanism: it cannot tell you what changed, and Google Drive’s conflicts cannot be detected at all, because it overwrites silently.
Notes
- The advanced sections of the Git panel (branches, staging, stash, remotes) remain available: the guided section is a layer on top, not a replacement.
- Works with any Git host, not only GitHub; the create button simply opens GitHub because it is where most coauthors already are.
- A private repository plus Git history means your drafts stay yours, versioned, and off every server except the one you chose. This is the same local-first stance as the rest of ComdTeX.