Welcome to Vivliostyle Documentation

Vivliostyle is a CSS typesetting ecosystem for creating beautifully formatted documents using web technologies.

Changelog

August 24, 2026

Updated the documentation carried here to Vivliostyle.js v2.45.0 / Vivliostyle CLI v11.2.0 / VFM 2.7.2 / theme-base 2.1.1.

Vivliostyle Viewer / Core v2.45.0 — Supported CSS features now cover CSS Cascade Layers (@layer) and the revert-layer and revert-rule keywords that roll the cascade back.
Vivliostyle CLI v11.2.0 — Adds the toc.compose option for composing the contents of the ToC navigation element.
VFM 2.7.2 — Documentation caught up with the options added in the 2.7 line, and a Plugin options page was added.

See the full changelog →

What is Vivliostyle?

Vivliostyle products (Shinyu Murakami / Katsuhiro Ogata “Vivliostyleでなにができるの？” from gihyo.jp ↗)

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 VFM footnote modes (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:

WebPub - HTML pages for online viewing
PDF - Print-ready documents
EPUB - E-book format

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 Web¹.

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	PDF	EPUB
Vivliostyle Viewer	WebPub ↗	PDF	EPUB
Vivliostyle CLI	WebPub ↗	PDF	EPUB
VFM	WebPub ↗	PDF	EPUB
Vivliostyle Themes	WebPub ↗	PDF	EPUB
Reference	WebPub ↗	PDF	EPUB
Cookbook	WebPub ↗	PDF	EPUB

Nelson, T. H. (1965). "Complex information processing: a file structure for the complex, the changing and the indeterminate".↩