Tu primer vault

Qué es un vault

Un vault es simplemente una carpeta normal de tu sistema de archivos. ComdTeX lee y escribe archivos .md, .tex y .bib directamente: no hay base de datos ni formato oculto. Si borras ComdTeX mañana, tus archivos siguen siendo Markdown y LaTeX legibles con cualquier otro editor.

Al abrir la app por primera vez, haz clic en Abrir Vault y selecciona cualquier carpeta, ya tenga notas dentro o esté vacía. No hay un paso de “crear proyecto”: casi cualquier carpeta sirve. ComdTeX rechaza la raíz del sistema de archivos, tu carpeta personal misma y las carpetas del sistema como /etc; elige una carpeta dentro de tu carpeta personal.

El archivo de bienvenida

La primera vez que ComdTeX abre un vault escribe comdtex.md, un recorrido con un ejemplo vivo de cada función: shorthands, entornos, ecuaciones numeradas, figuras y tablas, tablas y gráficas desde datos, diagramas, callouts, enlaces y citas. Está escrito en el idioma de la interfaz (inglés o español). A su lado, una carpeta comdtex-examples guarda lo que leen los ejemplos: comdtex-biology.md (valores del pipeline, convenciones de genes y especies, enlaces de accesión, secuencias, numeración suplementaria), dos archivos CSV, un archivo de resultados JSON y una figura.

Estos archivos son tuyos: edítalos, muévelos o bórralos. Un archivo de bienvenida borrado no se vuelve a crear. Para tener una copia nueva, ejecuta Restaurar archivos de ejemplo (comdtex.md) desde la paleta de comandos (Ctrl+Shift+P); cualquier archivo que hayas cambiado se guarda a su lado como nombre-old.md (o -old.csv, etc.) antes de reescribirlo.

Desde la 1.33.0, los vaults que se abren con un comdtex.md antiguo reciben el nuevo automáticamente. Una copia antigua sin tocar se reemplaza. Una editada se guarda primero como comdtex-old.md. Una copia que convertiste en tu propia nota, con texto mayormente tuyo, se deja como está.

Los cuatro archivos especiales

ComdTeX reconoce automáticamente cuatro archivos si están en la raíz del vault. Ninguno es obligatorio: la app funciona perfectamente sin ellos, y puedes añadirlos cuando los necesites.

Archivo	Para qué sirve
`macros.md`	Definiciones `\newcommand` que se aplican al renderizado de matemáticas en todos los archivos
`references.bib`	Entradas BibTeX usadas por las citas `[@clave]`
`snippets.md`	Snippets de texto definidos por ti, disponibles en el editor
`custom.css`	CSS personalizado aplicado al panel de vista previa

Al exportar, ComdTeX puede crear una carpeta oculta .comdtex/tmp en el vault. Solo contiene archivos temporales y puedes ignorarla.

ComdTeX también escribe un .comdtex-comments.json en la raíz del vault para guardar los comentarios por línea fuera de banda, así tus archivos .md y .tex se mantienen limpios de anotaciones internas de la app.

Estructura típica

Así se ve el vault de un estudiante de matemáticas:

mi-vault/
├── macros.md
├── references.bib
├── custom.css
├── snippets.md
├── analisis/
│   ├── analisis-real.md
│   └── teoria-de-la-medida.md
├── algebra/
│   └── algebra-lineal.md
├── tesis/
│   ├── tesis-principal.md
│   └── capitulo-01-intro.md
└── notas/
    └── seminario-2026-03-14.md

No hace falta seguir esta estructura al pie de la letra: puedes organizar carpetas y subcarpetas como prefieras, ComdTeX indexa el vault completo. Las notas y carpetas nuevas se crean en línea en el árbol de archivos, dentro de la carpeta donde van a vivir; ver Los paneles.

Abrirlo también en Obsidian

Como el vault son solo archivos en disco, puedes abrir la misma carpeta en Obsidian al mismo tiempo que en ComdTeX. Internamente ComdTeX usa un formato propio mientras editas (CMDX), pero la conversión hacia y desde disco es automática y transparente: al guardar, el archivo se escribe de vuelta en su formato original. Los .md siguen siendo compatibles con Obsidian y los .tex siguen siendo LaTeX válido. Los cambios se sincronizan de forma limpia entre ambas aplicaciones.

Autosave y recuperación ante fallos

ComdTeX guarda tus cambios automáticamente con un pequeño retraso (autosave con debounce), así que no necesitas acordarte de pulsar Guardar constantemente. Si la app se cierra de forma inesperada, un sistema de borradores permite recuperar el contenido no guardado la próxima vez que abras el archivo. También se restaura la sesión completa: pestañas abiertas, archivo activo y pestañas fijadas.

Your first vault

What a vault is

A vault is simply a regular folder on your filesystem. ComdTeX reads and writes .md, .tex, and .bib files directly: no database, no hidden format. If you removed ComdTeX tomorrow, your files would still be plain Markdown and LaTeX, readable in any other editor.

The first time you launch the app, click Open Vault and select any folder, whether it already has notes in it or is empty. There is no “create project” step: almost any folder works. ComdTeX refuses the filesystem root, your home folder itself, and system folders such as /etc; pick a folder inside your home instead.

The welcome file

The first time ComdTeX opens a vault it writes comdtex.md, a tour with a live example of every feature: shorthands, environments, numbered equations, figures and tables, tables and plots from data, diagrams, callouts, links and citations. It is written in the interface language (English or Spanish). Next to it, a comdtex-examples folder holds what the examples read: comdtex-biology.md (pipeline values, gene and species conventions, accession links, sequences, supplementary numbering), two CSV files, a JSON results file and a figure.

These files are yours: edit them, move them or delete them. A deleted welcome file is not recreated. To get a fresh copy, run Restore example files (comdtex.md) from the command palette (Ctrl+Shift+P); any file you changed is kept beside it as name-old.md (or -old.csv and so on) before it is rewritten.

Since 1.33.0, vaults opened with an older comdtex.md get the new one automatically. An untouched old copy is replaced. An edited one is kept as comdtex-old.md first. A copy you have turned into your own note, with mostly your own text, is left alone.

The four special files

ComdTeX automatically recognizes four files if they sit in the vault root. None of them is required: the app works perfectly without them, and you can add them whenever you need them.

File	Purpose
`macros.md`	`\newcommand` definitions applied to every file’s math rendering
`references.bib`	BibTeX entries used by `[@key]` citations
`snippets.md`	User-defined text snippets available in the editor
`custom.css`	Custom CSS applied to the preview pane

ComdTeX may also create a hidden .comdtex/tmp folder in the vault while exporting. It only holds temporary files and can be ignored.

ComdTeX also writes a .comdtex-comments.json in the vault root to persist per-line comments out-of-band, so your .md and .tex files stay free of the app’s internal annotations.

A typical vault

Here is what a math student’s vault might look like:

my-vault/
├── macros.md
├── references.bib
├── custom.css
├── snippets.md
├── analysis/
│   ├── real-analysis.md
│   └── measure-theory.md
├── algebra/
│   └── linear-algebra.md
├── thesis/
│   ├── thesis-main.md
│   └── chapter-01-intro.md
└── notes/
    └── seminar-2026-03-14.md

You don’t need to follow this structure exactly: organize folders and subfolders however you like, ComdTeX indexes the whole vault. New notes and folders are created inline in the file tree, inside the folder they will live in; see The panels.

Opening it in Obsidian too

Since the vault is just files on disk, you can open the same folder in Obsidian at the same time as in ComdTeX. Internally, ComdTeX uses its own format while you edit (CMDX), but the conversion to and from disk is automatic and transparent: when you save, the file is written back in its original format. .md files stay Obsidian-compatible and .tex files stay valid LaTeX. Changes round-trip cleanly between both apps.

Autosave and crash recovery

ComdTeX saves your changes automatically after a short delay (debounced autosave), so you don’t need to remember to hit Save constantly. If the app closes unexpectedly, a draft system lets you recover unsaved content the next time you open the file. The whole session is restored too: open tabs, active file, and pinned tabs.