Etiquetas y referencias

ComdTeX numera automáticamente ecuaciones, figuras, tablas, secciones y entornos, y permite referenciarlos desde cualquier parte del documento con la sintaxis @prefijo:nombre. Estas etiquetas también exportan de forma limpia a LaTeX/Overleaf, así que el mismo documento sirve para trabajar en ComdTeX y para compilar en Overleaf sin retocar nada.

Ecuaciones numeradas

Cada bloque $$...$$ se numera secuencialmente; la etiqueta es opcional:

$$
\hat{f}(\xi) = \int_{-\infty}^{\infty} f(x)\, e^{-2\pi i x \xi}\, dx
$$ {#eq:fourier}

Equation @eq:fourier shows that $\hat{f}$ depends linearly on $f$.

@eq:fourier se resuelve como un enlace clicable (1) en la vista previa.

Figuras

Las figuras se numeran igual, con la etiqueta entre llaves después de la imagen:

![Caption](image.png){#fig:label}

La referencia @fig:label se resuelve como un enlace “Figura N”.

Tablas

Las tablas Markdown también se pueden etiquetar, con la etiqueta en su propia línea justo después de la tabla:

# Introduction {#sec:intro}

See @sec:intro and @tbl:constants for notation.

| Symbol | Meaning |
|---|---|
| $G$ | Group |
| $e$ | Identity |
{#tbl:constants}

Encabezados

Cualquier encabezado se puede etiquetar de la misma forma, colocando {#sec:nombre} al final de la línea del título, como se ve arriba con # Introduction {#sec:intro}.

Tabla de prefijos

Prefijo	Uso
sec:	Encabezados
eq:	Ecuaciones en bloque
fig:	Figuras
tbl:	Tablas Markdown
thm:, lem:, cor:, prop:, def:, ex:, exer:	Entornos tipo teorema

El panel de Etiquetas

Abre el panel Etiquetas para auditar todo el sistema de referencias del vault de un vistazo: referencias rotas (apuntan a una etiqueta que no existe), etiquetas duplicadas (dos bloques con el mismo nombre) y etiquetas sin usar (definidas pero nunca referenciadas). Es el lugar donde detectar antes de exportar que un @thm:bolzano quedó mal escrito o que una etiqueta se repitió sin querer.

Referencias entre archivos

Los entornos matemáticos (teoremas, lemas, definiciones, etc.) admiten además referencias cruzadas entre archivos distintos del vault, con la forma @documento@prefijo:nombre, usando la ruta relativa al vault sin extensión. Por ejemplo, @gp/calendario@def:valor referencia la definición valor en el archivo gp/calendario.md. Si el archivo o la etiqueta contienen espacios, existe una forma alternativa entre corchetes: @[mi carpeta/mi nota]@def:valor.

Al exportar a LaTeX, una referencia cruzada entre archivos no puede convertirse en un \ref{} real (el entorno de destino vive en otro documento y está ausente de una exportación de un solo archivo), así que ComdTeX la reemplaza por texto plano que nombra el documento de origen, en vez de dejar un \ref que compilaría como ??.

$$
\hat{f}(\xi) = \int_{-\infty}^{\infty} f(x)\, e^{-2\pi i x \xi}\, dx
$$ {#eq:fourier}

Equation @eq:fourier shows that $\hat{f}$ depends linearly on $f$.

![Caption](image.png){#fig:label}

# Introduction {#sec:intro}

See @sec:intro and @tbl:constants for notation.

| Symbol | Meaning |
|---|---|
| $G$ | Group |
| $e$ | Identity |
{#tbl:constants}