hangulmath — Hangul jamo as mathematical symbols

Version 0.9 (2026-10-21)

Mathematical notation draws almost entirely on Latin and Greek letters. hangulmath adds the 40 letters (jamo) of modern Korean Hangul as math symbols: 14 basic consonants, 5 double consonants, 10 basic vowels and 11 compound vowels.

\usepackage{hangulmath}
...
\[ \giug_{\ah}(x) = \sum_k \niun_k x^k , \qquad \mium^2 \vec{A} = -\mu_0 \vec{J} \]

Each symbol has an official name following the Revised Romanization of Korean (\giyeok, \nieun, ...), and consonants have a four-letter alias that is easy to remember (\giug, \niun, \diud, \liul, ...). Vowels are written as pronounced with a trailing h (\ah, \eoh, \uah).

Requirements

• pdfLaTeX, XeLaTeX or LuaLaTeX. With pdfLaTeX (and latex + dvips/dvipdfmx) the bundled Type 1 fonts are used; with XeLaTeX and LuaLaTeX the bundled OpenType fonts are used through fontspec. The output is the same.
• LaTeX kernel 2022-06-01 or later.
• No Korean font needs to be installed: the symbols come from the bundled font hangulmath-sans.

Files

Installation

Install from CTAN with your TeX distribution (tlmgr install hangulmath), or copy these files next to your document:

In a TDS tree:

then run mktexlsr and enable the map (updmap-user --enableMap=hangulmath.map). With pdfLaTeX the package also registers the mapitself, so the fonts work without updmap; dvips and dvipdfmx need the enabled map (or dvips -u +hangulmath.map).

On Overleaf, upload the four pdfLaTeX files for the default compiler, or the three XeLaTeX files if the project uses XeLaTeX (all five font files if you switch between them).

The documentation is compiled with pdflatex hangulmath-doc or xelatex hangulmath-doc (twice). For its Korean prose it uses ko.TeX (kotex) under pdfLaTeX, and the first installed Korean font (e.g. Noto Serif CJK KR) under XeLaTeX.

Using with kotex

hangulmath works with kotex (xetexko / luatexko) in either package order. The symbols always use the bundled symbol font, not kotex's Korean text font.

kotex already uses \rieul as a josa command, so hangulmath leaves that name alone and prints a warning; write ㄹ as \liul or \hangulsym{rieul}. In general, \hangulsym{<name>} reaches any symbol by its official name or alias, even when another package has taken the command name.

Repository

Source code and issue tracker: https://github.com/krunyx/hangulmath

License

Copyright (C) 2026 Inkyu Park <icpark00@gmail.com>

The package files may be distributed and/or modified under the conditions of the LaTeX Project Public License, version 1.3c or (at your option) any later version. The latest version of this license is in https://www.latex-project.org/lppl.txt. This work has the LPPL maintenance status maintained; the Current Maintainer is Inkyu Park.

The bundled fonts are modified (subset and renamed) versions of Noto Sans CJK KR, Copyright 2014-2021 Adobe, distributed under the SIL Open Font License 1.1 (see OFL.txt).

hangulmath — 한글 자모 수학 기호

현대 한글 자모 40자(기본 자음 14, 쌍자음 5, 기본 모음 10, 복모음 11)를 수식 기호로 쓸 수 있게 하는 LaTeX 패키지입니다. pdfLaTeX, XeLaTeX, LuaLaTeX에서 동작하며, 기호용 글꼴이 함께 들어 있어 한글 글꼴을 따로 설치할 필요가 없습니다. 자세한 사용법은 hangulmath-doc.pdf를 보십시오.