Welcome to Vivliostyle Documentation
Vivliostyle is a CSS typesetting ecosystem for creating beautifully formatted documents using web technologies.
Changelog
September 15, 2026
Updated the documentation carried here to Vivliostyle.js v2.45.1 / Vivliostyle CLI v11.3.3 / Vivliostyle Themes v3 (theme-base 3.0.0) / VFM 2.7.2.
- Vivliostyle Themes v3 — A major change to how themes are written, with a new migration guide covering every step and the full variable rename tables.
- Vivliostyle CLI v11.3.3 — Themes can now be imported from CSS by npm package name, and the docs add creating a theme and using PostCSS.
- Awesome Vivliostyle — Adds three more Gijutsu-Hyoron titles to the list of books made with Vivliostyle.
What is Vivliostyle?
Vivliostyle is an open-source project that provides:
- Vivliostyle Viewer - View and paginate HTML/CSS documents in the browser
- Vivliostyle CLI - Command-line tool for generating PDF / EPUB from HTML/Markdown
- VFM (Vivliostyle Flavored Markdown) - Extended Markdown syntax for publishing
- Vivliostyle Themes - Pre-designed themes for beautiful documents
For Vivliostyle Beginners
Cookbook
Practical, cross-product guides to recently added Vivliostyle features:
- Footnotes — DPUB-ARIA footnotes, the standard
@page { @footnote { } }rule, and the new VFMfootnotemodes (v2.41) - CMYK Conversion —
device-cmyk()and CLI PDF CMYK output (v2.40) - Page Groups — Named pages and the
:nth(An+B of C)page selector (v2.39) - CSS Nesting Guide — CSS Nesting in Vivliostyle.js v2.42, including typesetting pseudo-elements
Single Source, Multi Output
One of the key benefits of Vivliostyle is SSMO (Single Source Multi Output):
From a single Markdown source, you can generate:
VFM Features Demo
Ruby Text
This demonstrates VFM's Ruby support.
VFM Markdown source:
This demonstrates VFM's {Ruby|ルビ} support.Footnotes
The term "hypertext" was coined by Ted Nelson in 1963, long before the invention of the World Wide Web1.
VFM Markdown source:
The term "hypertext" was coined by Ted Nelson in 1963, long before the invention of the World Wide Web[^1].
[^1]: Nelson, T. H. (1965). "Complex information processing: a file structure for the complex, the changing and the indeterminate".Downloads (built by Vivliostyle CLI)
Web Pub, PDF and EPUB were generated from the documents (Markdown source) on this site using Vivliostyle CLI (Single Source, Multi Output).
| Product | Vivliostyle Viewer | EPUB | |
|---|---|---|---|
| Vivliostyle Viewer | WebPub ↗ | EPUB | |
| Vivliostyle CLI | WebPub ↗ | EPUB | |
| VFM | WebPub ↗ | EPUB | |
| Vivliostyle Themes | WebPub ↗ | EPUB | |
| Reference | WebPub ↗ | EPUB | |
| Cookbook | WebPub ↗ | EPUB |
- Nelson, T. H. (1965). "Complex information processing: a file structure for the complex, the changing and the indeterminate".↩