# hangulmath — Hangul jamo as mathematical symbols

Version 0.7 (2026-10-15)

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

* **XeLaTeX or LuaLaTeX** (the package uses `fontspec`; pdfLaTeX is not
  supported).
* LaTeX kernel 2022-06-01 or later.
* No Korean font needs to be installed: the symbols come from the bundled
  fonts `hangulmath-sans.otf` and `hangulmath-sans-light.otf`.

## 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 (SIL OFL 1.1) |
| `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 fonts from Noto Sans CJK KR |
| `OFL.txt` | license of the bundled fonts |

## Installation

Install from CTAN with your TeX distribution (`tlmgr install hangulmath`),
or copy `hangulmath.sty`, `hangulmath-metrics.def` and the two `.otf`
files next to your document. In a TDS tree, put the `.sty` and `.def`
files in `tex/latex/hangulmath/` and the fonts in
`fonts/opentype/public/hangulmath/`.

On **Overleaf**, upload the same four files and set the compiler to
XeLaTeX (or add a `latexmkrc` file containing `$pdf_mode = 5;`).

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 패키지입니다. XeLaTeX 또는 LuaLaTeX에서
동작하며, 기호용 글꼴이 함께 들어 있어 한글 글꼴을 따로 설치할 필요가
없습니다. 자세한 사용법은 `hangulmath-doc.pdf`를 보십시오.