Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Vivliostyle

vivliostyle.org

  • Free plan
  • Open source
  • Windows
  • macOS
  • Linux
  • Web
  • API
  • Self-hosted
8.5 Club score Visit vivliostyle.org

What Vivliostyle is

Vivliostyle is a free, open-source typesetting project for digital and web publishing, built on web standards. Its Viewer renders HTML with CSS typesetting in a browser and can display EPUB files and web publications. The command-line tool typesets HTML and CSS and exports PDFs, including from EPUB files. For print output, its PRESS-READY option supports PDF/X-1a and requires Ghostscript and Xpdf. Vivliostyle Pub is a web app for editing text, Markdown, or HTML and previewing the result; its new version is in alpha. Themes come as npm packages and can be applied through vivliostyle.config.js. The Viewer can show HTML hosted on GitHub or Gist, or be copied to a public web server directory. The CLI requires Node.js, and its installation tutorial lists macOS, Windows, and Linux. Vivliostyle uses the AGPLv3 license, with modification and commercial use subject to reciprocal terms. Its FAQ says publications need not publish their HTML or CSS source data.

Who it suits

Vivliostyle suits publishers and developers who work with HTML and CSS and want browser preview or PDF output. It also offers an editing and previewing web app for text, Markdown, and HTML.

Good to know, and what to watch

  • Free, open-source typesetting project
  • Viewer displays EPUB, HTML, and web publications
  • CLI exports PDFs from HTML or EPUB
  • Themes can be applied through configuration
  • CLI requires Node.js
  • PDF/X-1a PRESS-READY output requires Ghostscript and Xpdf
  • New Vivliostyle Pub version is in alpha

Vivliostyle

Free

Open source

Getting started

  1. Open the Vivliostyle website
  2. Install the CLI with Node.js on macOS, Windows, or Linux
  3. Use Vivliostyle Viewer in a browser with HTML, EPUB, or web publications
  4. Edit text, Markdown, or HTML in Vivliostyle Pub
  5. Apply npm themes through vivliostyle.config.js
  6. Run the CLI to export PDF files

Limits to check

Vivliostyle is free with no paid plan or stated usage limits. The new version of Vivliostyle Pub is in alpha, and PRESS-READY PDF/X-1a output depends on Ghostscript and Xpdf.

The verdict

Vivliostyle offers browser viewing, command-line PDF creation, and a web editing option in an open-source project. The CLI depends on Node.js, and its print-ready PDF/X-1a workflow requires two additional tools.

Questions people ask

Is Vivliostyle free?

Yes. The project is free and open source under AGPLv3; no paid plan is listed.

Which formats can Vivliostyle import or display?

Viewer displays EPUB, HTML, and web publications. Listed import formats also include Markdown, EPUB OPF, publication manifests, and WebBook.

Can Vivliostyle export PDFs?

Yes. Vivliostyle CLI exports PDFs from HTML and can generate PDFs from EPUB files.

What platforms are supported?

The project supports Linux, macOS, Windows, the web, and self-hosted use. CLI installation guidance covers macOS, Windows, and Linux.

Do publications have to publish their source files?

No. The FAQ says publications made with Vivliostyle do not need to publish their HTML or CSS source data.

What the maker publishes

API
Documentation publishes Core API, CLI configuration reference and a JavaScript API reference. source
Browser editor
Vivliostyle Pub is a web application for editing text, Markdown, or HTML and previewing typesetting, and its new version is in alpha. source
Changelog
GitHub release notes record fixes for Node 22 compatibility, CSS import resolution, interrupted-build cleanup and browser updates. source
CLI
Vivliostyle CLI typesets HTML or Markdown from the command line and generates publication files. source
CLI output
Vivliostyle CLI typesets HTML with CSS on the command line and exports PDF. source
Commercial use
The FAQ permits commercial use, but modified distributed Vivliostyle code must provide corresponding source under AGPL obligations. source
Dependencies
PDF/X-1a output requires Ghostscript and Xpdf in addition to Vivliostyle CLI. source
Documentation depth
Documentation includes user guides, supported CSS references, API references, contribution guides and a development plan. source
EPUB support
Viewer and CLI can load unzipped EPUB content, and CLI can convert EPUB files to PDF. source
Extensibility
Developers can create and publish custom Vivliostyle themes as npm packages with a theme scaffolding command. source
Formats
Vivliostyle Viewer can display EPUB, HTML, and web publications, while CLI can generate PDFs from EPUB files. source
Founded
2018 source
Headquarters
Saitama, Japan source
Headquarters
The foundation lists its location as Minami-ku, Saitama-shi, Saitama 336-0015, Japan. source
Independent description
The Mind the Gap software survey describes Vivliostyle as browser-based CSS typesetting for paginated EPUB, web publications and PDF export. source
Independent pipeline
The ADA Multi-Format guide documents a publishing pipeline connecting Fidus Writer and Git repositories with Vivliostyle CSS typesetting. source
Independent use
A Typebase engineer chose Vivliostyle because Markdown authoring and an npm plus Node.js setup were convenient. source
Integrations
Viewer can display HTML files hosted on GitHub or Gist, and it can be copied into a public directory on a web server for website use. source
License
Vivliostyle uses AGPLv3, which permits modification and commercial use subject to its reciprocal license terms. source
License
Vivliostyle Core, Viewer and CLI use the GNU AGPL version 3 license. source
Limit: automatic TOC
The Typebase review found automatic TOC generation showed chapter titles but not section entries, so the author wrote a custom script. source
Limit: Markdown expressiveness
The Typebase review reports that Markdown-based authoring limits expression compared with more specialized systems. source
Limit: page counters
The Typebase review describes manual counter-reset adjustments as necessary when front-matter page counts change. source
Maker
Vivliostyle Foundation is represented by Shinyu Murakami and was founded in August 2018. source

Checked against the maker's pages on 15 Oct 2026.