Los paneles
Moverte sin usar el mouse
Antes de los paneles, tres cosas te llevan a cualquier parte de un vault rápido:
- Paleta de comandos (
Ctrl+P): un lanzador categorizado y consciente de la selección. Los comandos se agrupan en ocho categorías (Editar / Insertar / Matemáticas / Vista / Exportar / IA / Vault / Navegación), cada uno con un ícono y una etiqueta de atajo. Los comandos con variantes (colores de resaltado, encabezados, listas, símbolos, operaciones matemáticas, entornos) abren submenús. Con texto seleccionado, los comandos de formato envuelven la selección en vez de insertar en el cursor.
- Selector rápido (
Ctrl+;): un cambiador de archivo más liviano, para cuando ya sabes el nombre que buscas.
- Barra de migas de pan e historial de navegación (
Alt+Left / Alt+Right): la barra de migas muestra tu ruta relativa al vault; el historial te permite retroceder entre archivos como el botón atrás de un navegador.
- Marcadores (
Ctrl+Shift+B para verlos, Ctrl+Shift+1…9 para fijar o limpiar una ranura, Ctrl+Alt+1…9 para saltar): fija los archivos a los que vuelves constantemente, independiente del árbol de archivos.
Abrir cualquiera de los paneles de abajo despliega automáticamente la barra lateral si estaba colapsada.
Orientarte dentro de un archivo
| Panel | Para qué sirve |
|---|
| Árbol de archivos | La estructura de carpetas del vault, con menú contextual para renombrar, borrar y mover arrastrando. |
| Búsqueda | Búsqueda de texto completo en todo el vault, en archivos abiertos y cerrados. |
| Búsqueda y reemplazo | El mismo alcance que Búsqueda, pero con una vista previa de cada coincidencia antes de confirmar un reemplazo. |
Outline (Ctrl+Shift+E) | La estructura de encabezados del archivo actual. Arrastra un encabezado para reordenar esa sección directamente en el código fuente. |
| Backlinks | Cada archivo que enlaza al que tienes abierto, vía [[wikilink]]. |
| Migas de pan | Ruta relativa al vault, siempre visible para el archivo activo, y también la puerta de entrada al historial de navegación. |
Matemáticas y estructura
| Panel | Para qué sirve |
|---|
| Outline | El mismo panel de arriba, útil aquí como tabla de contenidos mientras escribes demostraciones largas. |
| Entornos | Cada bloque theorem / lemma / corollary / proposition / definition / example / exercise / proof / remark / note de todo el vault, no solo del archivo actual. |
| Ecuaciones | Cada bloque $$...$$ numerado en el archivo actual, con su {#eq:etiqueta} si tiene una. |
| Labels | Audita de una sola vez todas las etiquetas estructurales del vault: referencias rotas del estilo @sec:/@eq:/@fig:/@tbl:/@thm:, etiquetas duplicadas y etiquetas definidas pero nunca referenciadas. |
| Math backlinks | El inverso de una referencia: para una etiqueta dada, qué secciones y bloques la citan. También es una de las pestañas de Document Lab (más abajo), disponible aquí aparte para consultas rápidas mientras editas. |
| Selector de símbolos | Una grilla visual de símbolos matemáticos y comandos LaTeX que puedes insertar sin recordar el shorthand ni el comando crudo. |
| Frontmatter / Propiedades | Un editor gráfico para los campos YAML del frontmatter (título, autor, fecha, resumen, etiquetas) en vez de editar a mano el bloque al inicio del archivo. |
Organizar el vault
| Panel | Para qué sirve |
|---|
| Tags | Explora los archivos agrupados por el campo tags del frontmatter. |
| Graph | Un mapa visual de los [[wikilinks]] del vault, con agrupamiento y filtros para que un vault grande no se vuelva ilegible. |
| Todo | Junta en una sola lista cada ítem - [ ] de todos los archivos abiertos. |
| Estadísticas del vault | Cantidad de archivos, cantidad de palabras, salud de los enlaces, cantidad de ecuaciones y cantidad de citas de todo el vault. |
| Comentarios | Anotaciones por línea en cualquier archivo. Los comentarios se guardan fuera de banda en .comdtex-comments.json, en la raíz del vault, así que el código fuente .md/.tex se mantiene limpio: nada de lo que escribes aquí termina dentro del documento. |
Antes de exportar: Document Lab
El panel Document Lab (también llamado Diagnóstico) es la lista de chequeo previa a exportar. Agrupa todo lo que puede salir mal antes de entregarle un documento a Overleaf, a una revista o a un colega, en cinco pestañas:
| Pestaña | Propósito |
|---|
| Diagnóstico | Referencias rotas, etiquetas duplicadas, citas faltantes, matemáticas mal formadas y otros riesgos de exportación. |
| Exportar | Un puntaje de compatibilidad para Overleaf/LaTeX y para Markdown de Obsidian. |
| Proyecto | Detecta un documento principal (comdtex.main: true en el frontmatter) y las ![[transclusiones]] que incluye. |
| Estructura | Chequeos de estructura académica: título presente en el frontmatter, proximidad entre teorema y demostración. |
| Math backlinks | Qué secciones y bloques referencian cada etiqueta estructural. |
Correr Document Lab antes de exportar detecta el tipo de error que solo aparece cuando ya estás mirando una compilación fallida en Overleaf.
Trabajar con alguien más
| Panel | Para qué sirve |
|---|
| Git | Rama, cambios preparados/sin preparar, commit, push y las superficies habituales de Git (ramas, remotos, stash) para vaults bajo control de versiones. |
| Colaboración guiada | Una sección en la parte superior del panel de Git, en lenguaje simple, para quien no sabe Git: comparte un vault con un coautor, trae o envía cambios con un botón, y resuelve conflictos de “mantener la mía / usar la suya” sin tocar la línea de comandos. Ver Escribir con alguien más para el recorrido completo. |
| Sincronización en la nube | Una insignia de estado y un panel de conflictos para vaults sincronizados a través del cliente propio de Dropbox, OneDrive o Google Drive. Ver Integraciones para entender cómo funciona la detección. |
Ayudas para escribir
| Panel | Para qué sirve |
|---|
| Temporizador de enfoque | Ciclos estilo Pomodoro de trabajo/descanso/descanso largo, más estadísticas en vivo de la sesión de escritura: delta de palabras, palabras por minuto y avance hacia una meta diaria. Se abre como un popover anclado a la barra superior, no como panel lateral, así se puede consultar de un vistazo sin desplazar el árbol de archivos. |
IA (Ctrl+Shift+A) | El panel opcional del asistente, con proveedor propio (bring-your-own-provider). Desactivado por defecto; ver Integraciones. |
Ayuda (?) | La referencia completa de sintaxis, filtrable, que cubre shorthands, entornos y cada otro panel de esta página. |
| Vista previa PDF | El panel de PDF compilado en vivo, renderizado con pdf.js y virtualizado para que el scroll se mantenga fluido incluso en documentos grandes. |
Resumen de atajos
| Atajo | Abre |
|---|
Ctrl+P | Paleta de comandos |
Ctrl+; | Selector rápido |
Ctrl+Shift+B | Marcadores |
Ctrl+Alt+1…9 | Saltar a la ranura de marcador N |
Alt+Left / Alt+Right | Navegar atrás / adelante |
Ctrl+Shift+E | Panel Outline |
Ctrl+Shift+A | Panel del asistente de IA |
Ctrl+Shift+F | Buscar en todo el vault |
? | Ayuda / referencia de atajos de teclado |
F11 | Modo enfoque (edición sin distracciones, distinto del panel de temporizador) |
Los paneles sin atajo dedicado se abren desde la barra de menú seccionada en la parte superior de la ventana (Archivos / Textos / Matemáticas / Vistas, más los botones directos Enfoque / IA / Sync / Ayuda), o desde la categoría Vista de la Paleta de comandos.
The panels
Getting around without the mouse
Before the panels themselves, three things get you anywhere in a vault fast:
- Command palette (
Ctrl+P): a categorized, selection-aware launcher. Commands are grouped into eight categories (Edit / Insert / Math / View / Export / AI / Vault / Navigation), each shown with an icon and a shortcut chip. Commands with variants (highlight colors, headings, lists, symbols, math operations, environments) drill into sub-menus. With text selected, format commands wrap the selection instead of inserting at the cursor.
- Quick switcher (
Ctrl+;): a lighter-weight file switcher for when you already know the name you want.
- Breadcrumb bar and navigation history (
Alt+Left / Alt+Right): the breadcrumb shows your vault-relative path; the history lets you retrace your steps across files the way a browser’s back button does.
- Bookmarks (
Ctrl+Shift+B to view, Ctrl+Shift+1…9 to set or clear a slot, Ctrl+Alt+1…9 to jump): pin the files you return to constantly, independent of the file tree.
Opening any panel below un-collapses the sidebar automatically.
Finding your way around a file
| Panel | What it is for |
|---|
| File tree | The vault’s folder structure, with a context menu for rename, delete, and drag-to-move. |
| Search | Vault-wide full-text search across every open and closed file. |
| Search and replace | The same reach as Search, but with a preview of each match before you commit a replacement. |
Outline (Ctrl+Shift+E) | The heading structure of the current file. Drag a heading to reorder the section it belongs to directly in the source. |
| Backlinks | Every file that links to the one you have open, via [[wikilink]]. |
| Breadcrumbs | Always-visible vault-relative path for the active file, doubling as the entry point to navigation history. |
Math and structure
| Panel | What it is for |
|---|
| Outline | Same panel as above, useful here as a table-of-contents view while writing long proofs. |
| Environments | Every theorem / lemma / corollary / proposition / definition / example / exercise / proof / remark / note block across the whole vault, not just the current file. |
| Equations | Every numbered $$...$$ block in the current file, with its {#eq:label} if it has one. |
| Labels | Audits every structural label in the vault at once: broken @sec:/@eq:/@fig:/@tbl:/@thm:-style references, duplicate labels, and labels that are defined but never referenced. |
| Math backlinks | The inverse of a reference: for a given label, which sections and blocks cite it. This is also one of the Document Lab tabs (below), surfaced separately here for quick lookups while editing. |
| Symbol picker | A visual grid of math symbols and LaTeX commands you can insert without remembering the shorthand or the raw command. |
| Frontmatter / Properties | A GUI editor for the YAML frontmatter fields (title, author, date, abstract, tags) instead of hand-editing the block at the top of the file. |
Organizing the vault
| Panel | What it is for |
|---|
| Tags | Browse files grouped by their frontmatter tags field. |
| Graph | A visual map of the vault’s [[wikilinks]], with clustering and filtering so a large vault doesn’t collapse into a hairball. |
| Todo | Collects every - [ ] task item across all open files into one list. |
| Vault stats | File count, word count, link health, equation count, and citation count for the whole vault. |
| Comments | Per-line annotations on any file. Comments are stored out of band in .comdtex-comments.json at the vault root, so the .md/.tex source stays clean; nothing you write here ever lands in the document itself. |
Before you export: Document Lab
The Document Lab (also called Diagnostics) panel is the pre-export checklist. It groups everything that could go wrong before you hand a document to Overleaf, a journal, or a colleague into five tabs:
| Tab | Purpose |
|---|
| Diagnostics | Broken references, duplicate labels, missing citations, malformed math, and other export risks. |
| Export | A compatibility score for Overleaf/LaTeX and for Obsidian Markdown. |
| Project | Detects a main document (comdtex.main: true in frontmatter) and the ![[transclusions]] it pulls in. |
| Structure | Academic-structure checks: frontmatter title present, theorem/proof proximity. |
| Math backlinks | Which sections and blocks reference each structural label. |
Running Document Lab before an export catches the kind of mistake that only shows up once you’re staring at a failed Overleaf compile.
Working with someone else
| Panel | What it is for |
|---|
| Git | Branch, staged/unstaged changes, commit, push, and the usual Git surfaces (branches, remotes, stash) for vaults kept under version control. |
| Guided collaboration | A section at the top of the Git panel, in plain language, for people who don’t know Git: share a vault with a coauthor, bring or send changes with one button, and resolve “keep mine / use theirs” conflicts without touching the command line. See Write with someone else for the full walkthrough. |
| Cloud sync | A status badge and a conflicts panel for vaults synced through Dropbox, OneDrive, or Google Drive’s own client. See Integrations for how detection works. |
Writing helpers
| Panel | What it is for |
|---|
| Focus timer | Pomodoro-style work/break/long-break cycles, plus live writing-session stats: word delta, words-per-minute, and progress toward a daily goal. It opens as a popover anchored to the top bar rather than a sidebar panel, so it stays glanceable without displacing the file tree. |
AI (Ctrl+Shift+A) | The optional, bring-your-own-provider assistant panel. Off by default; see Integrations. |
Help (?) | The full syntax reference, filterable, covering shorthands, environments, and every other panel on this page. |
| PDF preview | The live compiled-PDF pane, rendered with pdf.js and virtualized so scrolling stays smooth even on large documents. |
Shortcut summary
| Shortcut | Opens |
|---|
Ctrl+P | Command palette |
Ctrl+; | Quick switcher |
Ctrl+Shift+B | Bookmarks |
Ctrl+Alt+1…9 | Jump to bookmark slot N |
Alt+Left / Alt+Right | Navigate back / forward |
Ctrl+Shift+E | Outline panel |
Ctrl+Shift+A | AI assistant panel |
Ctrl+Shift+F | Search across vault |
? | Help / keyboard shortcuts reference |
F11 | Focus mode (distraction-free editing, separate from the Focus timer panel) |
Panels without a dedicated shortcut open from the sectioned menu bar at the top of the window (Files / Texts / Math / Views, plus the direct Focus / AI / Sync / Help buttons), or from the Command Palette’s View category.
