usfm2html

Convert USFM to HTML using Proskomma and Sofria renderers.

Repository: https://github.com/unfoldingWord/node-usfm2html

Install

# npm
npm install -g usfm2html

# pnpm
pnpm add -g usfm2html

# yarn
yarn global add usfm2html

Usage

# Write to stdout
usfm2html path/to/file.usfm > output.html

# Write to a file directly
usfm2html path/to/file.usfm -o output.html

# Read from stdin
cat path/to/file.usfm | usfm2html - > output.html

Options

-o, --out <path>   Write output to a file instead of stdout
-h, --help         Show help
-v, --version      Show version

Notes

• Alignment markers are removed before rendering.
• Output is a full HTML document with embedded CSS.
• The renderer matches the Sofria HTML output used in the door43 preview app.