ComdTeX

Plantillas de journal

La sección Journals

El selector de plantillas (Ctrl+P → “nueva desde plantilla”) tiene una sección Journals con cuatro plantillas listas para usar:

PlantillaClase LaTeX real
IEEEIEEEtran
ACMacmart
Elsevierelsarticle
APA 7apa7

Cada una arranca con la estructura típica de ese journal: bloque de autores, resumen, secciones habituales. Escribes en Markdown normal con toda la sintaxis de ComdTeX (shorthands, entornos de teorema, ecuaciones numeradas, citas): la plantilla no te obliga a escribir LaTeX crudo.

Cómo funciona comdtex.texclass

Lo que hace que estas plantillas sean distintas de una plantilla académica genérica es un campo en el frontmatter: comdtex.texclass. Al usar Exportar como .tex, ComdTeX lee ese campo y genera el .tex con la clase de documento real, no un article genérico:

---
title: Mi paper
comdtex.texclass: ieeetran
---

Cada clase trae su propia gramática de bloque de título (por ejemplo, \IEEEauthorblock para IEEE, la lista de autores de acmart, el entorno de frontmatter de elsarticle, \authorsnames de apa7) y su propia configuración de entornos tipo teorema, respetando lo que la clase ya define. acmart, por ejemplo, predefine su propia familia de entornos teorema; ComdTeX solo agrega los que faltan, en vez de duplicar definiciones que romperían la compilación. Si el documento no tiene comdtex.texclass en el frontmatter, la exportación se comporta como siempre: sin cambios.

El resultado compila en Overleaf

El objetivo declarado de esta función es que el .tex exportado compile en Overleaf sin ediciones manuales. Eso es lo que estás comprando al usar una plantilla de journal en vez de escribir la clase a mano: subes el archivo, eliges el motor correcto en el proyecto de Overleaf si la revista lo pide, y compila.

Plantillas académicas generales

Además de las de journal, el mismo selector ofrece plantillas académicas de propósito general: artículo, apuntes, lista de problemas, hoja de teoremas, notas de investigación, paper de Overleaf, tesis y libro. Estas no llevan comdtex.texclass; exportan como un article estándar salvo que lo cambies tú.

Exportación de proyecto multi-archivo

Para tesis o libros con varios capítulos, el documento principal marca comdtex.main: true en su frontmatter e incluye los demás archivos con transclusiones:

---
title: Mi tesis
comdtex.main: true
---

![[capitulos/01-introduccion]]
![[capitulos/02-antecedentes]]

El panel Project de Diagnósticos detecta el documento principal y las transclusiones que arrastra. Exportar proyecto como .tex compone un único .tex listo para Overleaf a partir de ese árbol, respetando también comdtex.texclass si el documento principal lo define: puedes escribir una tesis entera capítulo por capítulo y exportarla como un solo documento de journal o de libro coherente.

Journal templates

The Journals section

The template picker (Ctrl+P → “new from template”) has a Journals section with four ready-to-use templates:

TemplateReal LaTeX class
IEEEIEEEtran
ACMacmart
Elsevierelsarticle
APA 7apa7

Each one starts with the structure typical of that journal: author block, abstract, common sections. You write in plain Markdown with the full ComdTeX syntax (shorthands, theorem environments, numbered equations, citations); the template never forces you to write raw LaTeX.

How comdtex.texclass drives it

What makes these templates different from a generic academic template is a frontmatter field: comdtex.texclass. When you use Export as .tex, ComdTeX reads that field and generates the .tex targeting the real document class, not a generic article:

---
title: My paper
comdtex.texclass: ieeetran
---

Each class brings its own title-block grammar (for example \IEEEauthorblock for IEEE, the acmart author list, the elsarticle frontmatter environment, apa7’s \authorsnames) and its own theorem-environment setup, respecting what the class already defines. acmart, for instance, predefines its own theorem family; ComdTeX only adds the environments that are missing, instead of duplicating definitions that would break the compile. If the document has no comdtex.texclass in its frontmatter, the export behaves as always: unchanged.

The result compiles on Overleaf

The stated goal of this feature is that the exported .tex compiles on Overleaf without hand edits. That is what you are buying by using a journal template instead of writing the class by hand: upload the file, pick the right engine in the Overleaf project if the journal requires one, and it compiles.

General academic templates

Beyond the journal ones, the same picker offers general-purpose academic templates: article, notes, problem set, theorem sheet, research notes, Overleaf paper, thesis, and book. These carry no comdtex.texclass; they export as a standard article unless you change it yourself.

Multi-file project export

For a thesis or a book with several chapters, the main document sets comdtex.main: true in its frontmatter and pulls in the other files with transclusions:

---
title: My thesis
comdtex.main: true
---

![[chapters/01-introduction]]
![[chapters/02-background]]

The Project tab of Diagnostics detects the main document and the transclusions it pulls in. Export project as .tex composes a single Overleaf-ready .tex from that tree, also honoring comdtex.texclass when the main document sets it: you can write a whole thesis chapter by chapter and export it as one coherent journal or book document.