Ako mi umelá inteligencia pomohla vyriešiť problém zobrazenia vzorcov v historických textoch

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: Ag3SbS3\text{Ag}_3\text{SbS}_3 (\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:


Možnosť 1: Vlastný ľahký prevodník do čistého HTML (bez knižníc a CSS)

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. v markdown-it parameter { html: true }, v marked je povolené štandardne).


Možnosť 2: Existujúce Node.js rozšírenia (KaTeX)

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.

A. Ak používaš marked

Nainš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$.');

B. Ak používaš markdown-it

Nainš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$.');

C. Ak používaš remark / unified

npm install remark-math rehype-katex

V pipeline stačí pridať .use(remarkMath) a následne .use(rehypeKatex, { output: 'mathml' }).


Ktorú cestu zvoliť?

  • Ak v článkoch používaš iba chemické vzorce minerálov, stupne a jednoduché prepočty mier, Možnosť 1 (vlastná funkcia) je najčistejšia – výsledkom je obyčajný text s <sub> a <sup>, ktorý sa perfektne prispôsobí tvojmu existujúcemu fontu na stránke a ľahko sa kopíruje.
  • Ak plánuješ v budúcnosti publikovať aj banské technické výpočty so zlomkami či odmocninami (napr. z Rittingerových alebo Rauenových štúdií), siahni po Možnosti 2 (marked-katex-extension alebo markdown-it-katex).

Výsledok

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.

  • Všimol si, že v pôvodnom preloženom texte nie je vzorec formátovaný.
  • Vie, že sme preložili už dva články z ročenky a že hneď za týmto textom je ešte tretí, ktorý sa týka danej témy.

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:

  • pri keramohalite: (Al2O3, 3 SO3+18 H₂O) →\rightarrow 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}$)
  • pri pyrargyrite: (3 Ag₂S · Sb₂S₃) →\rightarrow ($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?