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”: cualquier carpeta sirve.

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

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.

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: any folder works.

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 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.

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.