Typst

Typst como ciudadano de primera clase

Desde la versión 1.20.0, los archivos .typ no son un formato de exportación de segunda categoría: son ciudadanos del vault, igual que tus .md y .tex. Aparecen en el árbol de archivos, se abren como cualquier otra pestaña, y ComdTeX les da su propio resaltado de sintaxis de Monaco (encabezados, #funciones, etiquetas y referencias, matemática, bloques raw). A diferencia de los archivos .md o .tex, un .typ se edita crudo: no pasa por la conversión CMDX, porque su sintaxis ya es la suya propia y no necesita traducción.

Compilación nativa con el binario local

Con un .typ abierto, el comando “Compilar PDF (archivo Typst)” invoca el binario typst instalado en tu sistema, sin pasar por pandoc. Compila incluso el contenido sin guardar del buffer activo, y el resultado alimenta el mismo panel de vista previa de PDF que usa el resto de la app.

Esto es importante: el binario typst es requerido para este camino de compilación nativa. Si no lo tienes instalado, esta función no funciona; ComdTeX muestra un aviso de dependencia faltante al iniciar, con un enlace a la guía de instalación. Instálalo desde github.com/typst/typst o el gestor de paquetes de tu distro.

Recompilar al guardar, a la velocidad de Typst

Con la recompilación automática activada, cada vez que guardas un .typ, ComdTeX vuelve a compilarlo en el lugar y actualiza la vista previa. Typst compila mucho más rápido que un motor LaTeX tradicional, así que en la práctica esto se siente como una vista previa en vivo: escribes, guardas, y el PDF ya está actualizado antes de que termines de mirar la pantalla.

La vista previa de Markdown se hace a un lado

Para un archivo .md o .tex, la pestaña de vista previa te muestra el HTML renderizado del documento. Para un .typ, eso no tendría sentido: su “vista previa” es directamente el PDF compilado. ComdTeX detecta esto automáticamente y, al abrir una pestaña .typ, la vista previa de Markdown se hace a un lado en favor del panel de PDF.

Exportar a Typst desde Markdown

Esto es independiente de lo anterior: si escribes en Markdown normal (con shorthands, entornos de teorema, ecuaciones numeradas) y quieres un .typ como formato de salida, Exportar a Typst sigue disponible desde el menú de exportación, vía pandoc. Es el camino inverso: partes de un documento ComdTeX y terminas en Typst, en vez de escribir Typst directamente. Ese camino necesita pandoc instalado, no typst; si además quieres que ese .typ exportado se convierta a PDF en el mismo paso, ahí sí entra typst de nuevo.

Qué instalar según lo que quieras hacer

Quiero	Necesito
Escribir `.typ` a mano y compilarlo a PDF dentro de ComdTeX	`typst`
Exportar un documento Markdown existente a `.typ`	`pandoc`
Que ese `.typ` exportado compile a PDF también	`pandoc` y `typst`

Si falta alguna de estas dos herramientas, el aviso ámbar de dependencias en el arranque de ComdTeX te lo dice, con la opción de descartarlo por herramienta si no lo necesitas por ahora.

Typst

Typst as a first-class citizen

Since version 1.20.0, .typ files are not a second-tier export format: they are vault citizens, just like your .md and .tex files. They show up in the file tree, open as any other tab, and ComdTeX gives them their own Monaco syntax highlighting (headings, #functions, labels and references, math, raw blocks). Unlike .md or .tex files, a .typ file is edited raw: it never goes through CMDX conversion, because its syntax is already its own and needs no translation.

Native compilation with the local binary

With a .typ file open, the “Compile PDF (Typst file)” command invokes the typst binary installed on your system, with no pandoc in the path. It compiles even unsaved content from the active buffer, and the result feeds the same PDF preview panel the rest of the app uses.

This matters: the typst binary is required for this native compile path. If you don’t have it installed, this feature does not work; ComdTeX shows a missing-dependency warning on startup, with a link to the install guide. Install it from github.com/typst/typst or your distro’s package manager.

Recompile on save, at Typst speed

With auto-rebuild enabled, every time you save a .typ file, ComdTeX recompiles it in place and refreshes the preview. Typst compiles much faster than a traditional LaTeX engine, so in practice this feels like a live preview: you type, you save, and the PDF is already up to date before you finish looking at the screen.

The Markdown preview steps aside

For a .md or .tex file, the preview tab shows the rendered HTML of the document. For a .typ file, that would not make sense: its “preview” is directly the compiled PDF. ComdTeX detects this automatically, and when you open a .typ tab, the Markdown preview steps aside in favor of the PDF panel.

Exporting to Typst from Markdown

This is separate from the above: if you write in plain Markdown (with shorthands, theorem environments, numbered equations) and want a .typ as output, Export as Typst remains available from the export menu, via pandoc. It’s the reverse path: you start from a ComdTeX document and end up with Typst, instead of writing Typst directly. That path needs pandoc installed, not typst; if you also want that exported .typ converted to PDF in the same step, typst comes back into play.

What to install depending on what you want

I want to	I need
Write `.typ` by hand and compile it to PDF inside ComdTeX	`typst`
Export an existing Markdown document to `.typ`	`pandoc`
Have that exported `.typ` also compile to PDF	`pandoc` and `typst`

If either of these tools is missing, ComdTeX’s amber dependency warning on startup tells you so, with the option to dismiss it per tool if you don’t need it right now.