Unidades, química y convenciones
Los papers necesitan cantidades y fórmulas químicas con un formato consistente, no solo tipografiadas. ComdTeX incluye cuatro atajos para eso: si(), num(), unit() y ce(). Los escribes una vez y se renderizan de dos formas: en la vista previa del editor mediante KaTeX, y en la exportación a LaTeX como comandos reales de siunitx y mhchem, que es lo que las revistas realmente exigen.
Los atajos
| Atajo | Vista previa | Exportación |
|---|---|---|
si(9.81, m/s^2) | 9.81 m s^-2 (unidades verticales) | \qty{9.81}{\meter\per\second\squared} |
si(1.5(2), mol/L) | 1.5(2) mol L^-1 (incertidumbre concisa) | \qty{1.5(2)}{\mole\per\litre} |
num(6.022e23) | 6.022 x 10^23 | \num{6.022e23} |
unit(mol/L) | mol L^-1 | \si{\mole\per\litre} |
ce(H2SO4) | renderizado por la extensión mhchem de KaTeX | \ce{H2SO4} |
si() toma un valor y una unidad; num() toma un número suelto; unit() toma solo una expresión de unidad; ce() toma una fórmula química. La notación científica (6.022e23) y la incertidumbre entre paréntesis (1.5(2)) se entienden de forma nativa.
Tanto siunitx como mhchem se cargan solo cuando un documento realmente usa si()/num()/unit() o ce(). Los documentos que nunca tocan química o cantidades no pagan el costo de compilación, algo que importa porque las versiones recientes de mhchem no son gratis en tiempo de compilación.
Vocabulario de unidades
El analizador entiende un vocabulario cerrado, no texto arbitrario, de modo que un error tipográfico degrada con elegancia en lugar de adivinar.
Base del SI: m, s, kg, g, mol, K, A, cd
Derivadas del SI: Hz, N, Pa, J, W, C, V, F, ohm, S, T, H, lm, lx, Bq, Gy, Sv, kat, rad, sr
No-SI aceptadas: L/l (litro), t (tonelada), min, h, d, au, eV, u, Da, bar, percent, degC, degF, deg, arcmin, arcsec
Astronomía: pc, kpc, Mpc, ly, Msun, Lsun, Rsun, Jy, mag. siunitx no tiene macros para estas, así que viajan como texto vertical en la exportación en lugar de romperla.
Biología y química: M (molar), bp, kb, rpm, cfu, OD
Puedes combinar unidades con *, / y ^n para productos, divisiones y exponentes: mol/L, kg*m/s^2, W/m^2.
Prefijos del SI
El conjunto completo de prefijos del SI está soportado y se aplica a cualquier unidad conocida: q (quecto), r (ronto), y (yocto), z (zepto), a (atto), f (femto), p (pico), n (nano), u/µ/μ (micro), m (mili), c (centi), d/da (deca), h (hecto), k (kilo), M (mega), G (giga), T (tera), P (peta), E (exa), Z (zetta), Y (yotta), R (ronna), Q (quetta). Así, km, µmol y GHz se resuelven todos como prefijo más unidad base.
Una unidad desconocida nunca rompe la compilación
Si escribes una unidad que no está en el vocabulario, no lanza un error. Degrada a texto vertical: \text{} dentro del argumento de siunitx para la exportación, y el texto literal en la vista previa. Un error tipográfico en el nombre de una unidad es un problema estético, nunca un PDF roto.
Chequeo de convenciones tipográficas de biología
Las revistas biomédicas devuelven manuscritos por dos reglas tipográficas que casi nadie revisa a mano: los binomios taxonómicos deben ir en cursiva (Escherichia coli, E. coli), y los símbolos de genes deben ir en cursiva mientras sus productos proteicos se mantienen verticales (TP53 el gen frente a p53 la proteína).
Actívalo por documento con frontmatter:
---
comdtex.domain: biology
---Una vez activado, el editor ADVIERTE sobre posibles violaciones y sugiere la forma en cursiva. Nunca reescribe tu texto automáticamente: una palabra como Bacillus puede ser un género o un apellido, y solo el autor lo sabe.
El chequeo es cuidadoso con dónde mira y qué marca:
- El código, las fórmulas, los enlaces y el texto que ya está en cursiva se ignoran, así que el chequeo nunca se dispara dentro de un bloque con comillas invertidas o de una fórmula.
- Las siglas comunes de laboratorio no se confunden con símbolos de genes.
PCR,ELISA,DNAy una lista larga de abreviaturas similares (RNA,HPLC,NMR,WHO,FDA,ATP, entre otras) están excluidas a propósito, porque el patrón de un símbolo de gen (de 2 a 6 letras mayúsculas, seguidas opcionalmente de dígitos) las atraparía también. - Los símbolos dentro de encabezados se omiten, ya que un encabezado suele ser el título de una sección, no una afirmación sobre un gen.
El resultado es una sugerencia, no una reescritura: tú decides si Bacillus se convierte en Bacillus o se queda como apellido.
Units, chemistry and conventions
Papers need quantities and chemical formulas formatted consistently, not just typeset. ComdTeX ships four shorthands for that: si(), num(), unit() and ce(). Type them once and they render two ways: in the editor’s preview through KaTeX, and in the LaTeX export as real siunitx and mhchem commands, which is what journals actually check for.
The shorthands
| Shorthand | Preview | Export |
|---|---|---|
si(9.81, m/s^2) | 9.81 m s^-2 (upright units) | \qty{9.81}{\meter\per\second\squared} |
si(1.5(2), mol/L) | 1.5(2) mol L^-1 (concise uncertainty) | \qty{1.5(2)}{\mole\per\litre} |
num(6.022e23) | 6.022 x 10^23 | \num{6.022e23} |
unit(mol/L) | mol L^-1 | \si{\mole\per\litre} |
ce(H2SO4) | rendered by KaTeX’s mhchem extension | \ce{H2SO4} |
si() takes a value and a unit; num() takes a bare number; unit() takes a unit expression alone; ce() takes a chemical formula. Scientific notation (6.022e23) and parenthesized uncertainty (1.5(2)) are both understood natively.
Both siunitx and mhchem load only when a document actually uses si()/num()/unit() or ce(). Documents that never touch chemistry or quantities do not pay the compile-time cost, which matters because recent mhchem versions are not free.
Unit vocabulary
The parser understands a closed vocabulary, not arbitrary text, so a typo degrades gracefully instead of guessing.
SI base: m, s, kg, g, mol, K, A, cd
SI derived: Hz, N, Pa, J, W, C, V, F, ohm, S, T, H, lm, lx, Bq, Gy, Sv, kat, rad, sr
Accepted non-SI: L/l (litre), t (tonne), min, h, d, au, eV, u, Da, bar, percent, degC, degF, deg, arcmin, arcsec
Astronomy: pc, kpc, Mpc, ly, Msun, Lsun, Rsun, Jy, mag. siunitx has no macros for these, so they ride as upright text in the export rather than breaking it.
Biology and chemistry: M (molar), bp, kb, rpm, cfu, OD
You can combine units with *, / and ^n for products, divisions and exponents: mol/L, kg*m/s^2, W/m^2.
SI prefixes
The full SI prefix set is supported and applied to any known unit: q (quecto), r (ronto), y (yocto), z (zepto), a (atto), f (femto), p (pico), n (nano), u/µ/μ (micro), m (milli), c (centi), d/da (deca), h (hecto), k (kilo), M (mega), G (giga), T (tera), P (peta), E (exa), Z (zetta), Y (yotta), R (ronna), Q (quetta). So km, µmol and GHz all resolve to their prefix plus base unit.
Unknown units never break a compile
If you write a unit that is not in the vocabulary, it does not throw an error. It degrades to upright text: \text{} inside the siunitx argument for the export, and the literal text in the preview. A typo in a unit name is a cosmetic issue, never a broken PDF.
Biology typography check
Biomedical journals return manuscripts over two typographic rules that almost nobody checks by hand: taxonomic binomials must be italic (Escherichia coli, E. coli), and gene symbols must be italic while their protein products stay upright (TP53 the gene versus p53 the protein).
Opt in per document with frontmatter:
---
comdtex.domain: biology
---Once enabled, the editor WARNS about likely violations and suggests the italicized form. It never rewrites your text automatically: a word like Bacillus can be a genus or a surname, and only the author knows which.
The check is careful about where it looks and what it flags:
- Code, math, links and text that is already italic are ignored, so the check never fires inside a fenced block or a formula.
- Common lab acronyms are not mistaken for gene symbols.
PCR,ELISA,DNAand a long list of similar abbreviations (RNA,HPLC,NMR,WHO,FDA,ATP, and others) are excluded on purpose, because a gene-symbol pattern (2 to 6 uppercase letters, optionally followed by digits) would otherwise catch them too. - Symbols inside headings are skipped, since a heading is usually a section title, not a claim about a gene.
The result is a suggestion, not a rewrite: you decide whether Bacillus becomes Bacillus or stays a surname.