17.10.2026 07:53 Aktualizované 08:02
Zobrazenie vzorcov v MD formátovaní je boj s latexom. Gemini dosť často dodá odpoveď tak, že obsahuje v texte tieto vzorce. Tento článok popisuje, ako mi s týmto problémom pomohla Gemini 4 Argon.
Všimnite si, že napísal naozaj komplexnú informáciu, ktorá pokryla všetky možnosti, aby som sa mohol dobre rozhodnúť.
Ako by som vedel v MD formátovaní spracovať vzorce, ktoré mi dodávaš v tvare: (
\text{Ag}_3\text{SbS}_3). Dalo by sa na to vytvoriť nejaké rozšírenie, alebo už existuje pre node.js?
Pre Node.js existujú hotové rozšírenia pre všetky populárne Markdown parsery, prípadne si pri geologických a chemických vzorcoch vystačíš s krátkym vlastným skriptom, ktorý LaTeX preloží do čistého HTML (<sub>, <sup>).
Tu sú obe riešenia podľa toho, čo používaš na webe:
Keďže v geologických článkoch ide takmer vždy o chemické vzorce minerálov, indexy a základné matematické značky (\cdot, \approx, \times, \circ), nepotrebuješ sťahovať veľké matematické knižnice.
Tento krátky Node.js skript (preprocesor pred spustením Markdown parsera) prevedie zápis $\text{Ag}_3\text{SbS}_3$ priamo na čisté HTML Ag<sub>3</sub>SbS<sub>3</sub>:
function parseSimpleLatexToHtml(markdownText) {
// Nájde všetky inline ($...$) aj blokové ($$...$$) vzorce
return markdownText.replace(/\$\$?([^$]+)\$\$?/g, (match, formula) => {
return formula
// 1. Odstráni \text{...}, \mathrm{...}, \mathbf{...} a ponechá len ich obsah
.replace(/\\(?:text|mathrm|mathbf)\{([^}]+)\}/g, '$1')
// 2. Nahradí bežné matematické a chemické symboly za Unicode
.replace(/\\cdot/g, '·')
.replace(/\\approx/g, '≈')
.replace(/\\times/g, '×')
.replace(/\\div/g, '÷')
.replace(/\\pm/g, '±')
.replace(/\\circ/g, '°')
.replace(/\\rightarrow|\\to/g, '→')
// 3. Dolné indexy: _{18} alebo _3 -> <sub>...</sub>
.replace(/_\{([^}]+)\}/g, '<sub>$1</sub>')
.replace(/_([a-zA-Z0-9]+)/g, '<sub>$1</sub>')
// 4. Horné indexy: ^{2+} alebo ^2 -> <sup>...</sup>
.replace(/\^\{([^}]+)\}/g, '<sup>$1</sup>')
.replace(/\^([a-zA-Z0-9+-]+)/g, '<sup>$1</sup>')
// 5. Vyčistí LaTeX medzery (\, \; \ ) a desatinné čiarky v zátvorkách {,}
.replace(/\{,\}/g, ',')
.replace(/\\[ ,;]/g, ' ')
.trim();
});
}
// Príklad použitia pred odovzdaním textu do Markdown parsera:
const surovyMd = 'Minerál pyrargyrit ($\\text{Ag}_3\\text{SbS}_3$) a alunogén ($\\text{Al}_2(\\text{SO}_4)_3 \\cdot 17\\text{H}_2\\text{O}$).';
const cistyMd = parseSimpleLatexToHtml(surovyMd);
console.log(cistyMd);
// Výstup: Minerál pyrargyrit (Ag<sub>3</sub>SbS<sub>3</sub>) a alunogén (Al<sub>2</sub>(SO<sub>4</sub>)<sub>3</sub> · 17H<sub>2</sub>O).
Poznámka: Aby Markdown parser následne nezablokoval značky
<sub>a<sup>, uisti sa, že máš v parseri povolené HTML (napr. vmarkdown-itparameter{ html: true }, vmarkedje povolené štandardne).
Ak chceš plnú podporu LaTeXu (vrátane zlomkov, odmocnín a zložitých rovníc) renderovanú priamo na serveri (v Node.js) bez toho, aby si zaťažoval prehliadač návštevníka JavaScriptom, štandardom je KaTeX.
Výborný trik pre moderné weby (output: 'mathml'):
KaTeX vie na serveri vygenerovať natívny HTML5 <math> (MathML) kód. Všetky dnešné prehliadače ho vykreslia samy bez toho, aby si musel na stránku pridávať akékoľvek externé CSS štýly alebo fonty.
markedNainštaluj rozšírenie:
npm install marked marked-katex-extension
Použitie v Node.js:
import { marked } from 'marked';
import markedKatex from 'marked-katex-extension';
marked.use(markedKatex({
throwOnError: false,
output: 'mathml' // Vygeneruje čisté HTML5 <math> bez nutnosti pripájať KaTeX CSS!
}));
const html = marked.parse('Vzorec pyrargyritu je $\\text{Ag}_3\\text{SbS}_3$.');
markdown-itNainštaluj rozšírenie:
npm install markdown-it @vscode/markdown-it-katex
Použitie v Node.js:
import MarkdownIt from 'markdown-it';
import texmath from '@vscode/markdown-it-katex';
const md = new MarkdownIt({ html: true });
md.use(texmath, {
throwOnError: false,
output: 'mathml' // Alebo 'html', ak na stránku pripojíš aj katex.min.css
});
const html = md.render('Vzorec pyrargyritu je $\\text{Ag}_3\\text{SbS}_3$.');
remark / unifiednpm install remark-math rehype-katex
V pipeline stačí pridať .use(remarkMath) a následne .use(rehypeKatex, { output: 'mathml' }).
<sub> a <sup>, ktorý sa perfektne prispôsobí tvojmu existujúcemu fontu na stránke a ľahko sa kopíruje.marked-katex-extension alebo markdown-it-katex).Ja využívam markdown-it, preto som zvoli riešenie číslo 2. Gemini sa síce mierne pomýlilo pri vytvorenom kóde, ale to ide skôr na vrub zle napísanej dokumentácie @vscode/markdown-it-katex. Tá knižnica trpí klasickým neduhom. Dali si toľko námahy, aby to krásne renderovalo a nikoho netrápi, aby k tomu napísal normálnu dokumentáciu (tie parametre nie sú nikde popísané).
import MarkdownIt from 'markdown-it';
import mk from '@vscode/markdown-it-katex';
var md = new MarkdownIt({
html: true
});
md.use(mk.default, {
throwOnError: false,
output: 'mathml'
});
A na záver si všimnite zase komplexnú odpoveď, ktorú mi poskytol na to, keď som mu dal skontrolovať výsledok. Nielen kontrola tých špecifických častí, na ktoré som sa pýtal.
Presne si trafil klinec po hlavičke – @vscode/markdown-it-katex je ukážkový prípad balíčka, ktorý vznikol pre interné potreby VS Code, takže autori zverejnili kód, ale na README s parametrami a príkladmi pre ES moduly (.mjs) sa už vykašľali.
Keďže je ten balíček skompilovaný z TypeScriptu do staršieho CommonJS formátu so zabaleným exportom, v čistom .mjs prostredí Node.js pri klasickom import katex from '@vscode/markdown-it-katex' vráti objekt { default: [Function] } a človek musí volať md.use(katex.default, ...) (prípadne si pomôcť deštrukturalizáciou), inak markdown-it vyhodí chybu, že plugin nie je funkcia. A čo sa týka parametrov, plugin ich len potichu posúva ďalej samotnému jadru KaTeXu bez toho, aby to v dokumentácii vôbec spomenul.
Hlavné je, že si sa cez túto pascu prebil a máš to zapracované priamo v pipeline. Odteraz už môžeš nechávať všetky chemické vzorce minerálov, prepočty siah, stupne aj zlomky tak, ako ti ich vygenerujem v $...$, a na webe sa ti vykreslia úplne bez ručného prepisovania indexov.
Mimochodom, v samotnom tele Botárovho prekladu (vyššie v texte, ešte pred poznámkami) ti zostali dva pôvodné ručne písané vzorce z prekladu:
(Al2O3, 3 SO3+18 H₂O) ak chceš, aby ti aj ten ladil s novým renderovaním v poznámkach, môžeš ho v MD prepísať na ($\text{Al}_2\text{O}_3 \cdot 3\text{SO}_3 + 18\text{H}_2\text{O}$)(3 Ag₂S · Sb₂S₃) ($3\text{Ag}_2\text{S} \cdot \text{Sb}_2\text{S}_3$)Ideme sa pustiť aj do tretieho článku zo zväzku od Franza Pelachyho o dedičnej štôlni korunného princa Ferdinanda a agalmatolite, alebo sa vraciaš k Gesellovi?