# hangulmath — Hangul jamo as mathematical symbols

Version 0.8 (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.

```latex
\usepackage{hangulmath}
...
\[ \hangulsum\tiut_{k=1}^{n} \giug_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`). `\hangulsum`, `\hangulint` and `\hangullim` turn any symbol into
a sum-, integral- or limit-like operator.

## 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
  fonts (`hangulmath-sans` and `hangulmath-sans-light`).

## Files

| File | Purpose |
|---|---|
| `hangulmath.sty` | the package |
| `hangulmath-metrics.def` | glyph metrics for the bundled font |
| `hangulmath-sans.otf`, `hangulmath-sans-light.otf` | bundled symbol fonts, OpenType (SIL OFL 1.1) |
| `hangulmath-sans.pfb`, `hangulmath-sans-light.pfb`, `.tfm` | the same fonts as Type 1 for pdfLaTeX (SIL OFL 1.1) |
| `hangulmath.map` | font map for pdfTeX, dvips and dvipdfmx |
| `hangulmath-doc.tex`, `hangulmath-doc.pdf` | documentation |
| `hangulmath-minimal.tex` | one-page minimal example in English (no Korean font needed) |
| `hangulmath-metrics.py` | generates a metrics file for another font (Python 3.10+, fontTools) |
| `hangulmath-fonts.py` | rebuilds the bundled OpenType fonts from Noto Sans CJK KR |
| `hangulmath-type1.py` | builds the Type 1 fonts, TFMs and map from the OpenType fonts (Python 3.10+, fontTools, pltotf) |
| `OFL.txt` | license of the bundled fonts |

## Installation

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

    hangulmath.sty  hangulmath-metrics.def
    hangulmath-sans.otf  hangulmath-sans-light.otf     (XeLaTeX, LuaLaTeX)
    hangulmath-sans.pfb  hangulmath-sans-light.pfb     (pdfLaTeX)
    hangulmath-sans.tfm  hangulmath-sans-light.tfm     (pdfLaTeX)

In a TDS tree:

| Files | Directory |
|---|---|
| `.sty`, `.def` | `tex/latex/hangulmath/` |
| `.otf` | `fonts/opentype/public/hangulmath/` |
| `.pfb` | `fonts/type1/public/hangulmath/` |
| `.tfm` | `fonts/tfm/public/hangulmath/` |
| `.map` | `fonts/map/dvips/hangulmath/` |

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

On **Overleaf**, upload the same eight files; the default pdfLaTeX
compiler works, as do XeLaTeX and LuaLaTeX.

The documentation is compiled with `xelatex hangulmath-doc` (twice); it
uses the Noto Serif CJK KR font for its Korean prose.

## 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`를 보십시오.