README file from
GithubHWP to PDF
Convert Korean HWP / HWPX documents to PDF (and optionally Markdown) the
moment they land in your vault — fully offline. Conversion runs through a
Rust + WebAssembly renderer (@rhwp/core),
so no external server, upload, or API key is involved. Your documents never leave
your machine.
Features
-
Automatic conversion when an
.hwp/.hwpxfile is added (or run it manually via the command palette). -
Three output styles, chosen in settings:
Output Colour & photos Searchable Size Image-based PDF exact, like the original yes (invisible text layer) large Text-based PDF black & white, no photos yes, pixel-perfect highlights tiny Markdown note — yes very small Image-based PDFs embed an invisible text layer (each run horizontally scaled to match the page image) so they are searchable with well-aligned highlights. Markdown reconstructs paragraphs and tables (merged cells become HTML tables).
-
Offline & private — everything runs locally via WebAssembly.
-
Korean / English UI — follows your app language.
Settings
- PDF conversion mode — image-based, text-based, or none.
- Markdown note — also extract the text as a
.mdnote. - Convert on add — auto-convert new files, or command-only.
- Delete original after conversion — move the source file to the trash.
- Render scale / JPEG quality — image-based PDF resolution and size.
Limitations
- Image-based PDFs are large; text-based PDFs render all text in a single bundled font (NanumGothic) and omit colour and embedded photos.
- Output quality depends on the
@rhwp/corerenderer; complex tables, equations, or unusual fonts may not be perfectly reproduced. - Desktop only.
Development
npm install
npm run build # type-check, then bundle to main.js (WASM + font inlined)
The build inlines the WASM renderer and the font into main.js, so the release
ships just main.js, manifest.json, and styles.css.
Credits & licenses
@rhwp/core— HWP/HWPX WebAssembly renderer (MIT)pdf-liband@pdf-lib/fontkit(MIT)- NanumGothic font © Naver Corp. (SIL Open Font License 1.1)
This project is released under the MIT License. See LICENSE.