Getting Started

Vivliostyle currently consists of two products. This page will show you how to use it. It also explains the new services we’re releasing this year.

Vivliostyle Viewer v2.18.3

  • A browser-based formatting engine that reads HTML and displays the results of the typesetting in the browser.
  • 💡To use Vivliostyle in a local environment, the recommend tool is Vivliostyle CLI, which includes the Vivliostyle Viewer. 👉Vivliostyle CLI User Guide
  1. Use Vivliostyle Viewer
  1. Page view to fit window size

  2. Page view by fixed size

For more information about Vivliostyle Viewer, see Vivliostyle Viewer User Guide.

Vivliostyle CLI v5.6.2

  • CSS typesetting on the command line with output to PDF.
  • PDF/X-1a output supported by merging PRESS-READY in v2. Ghostscript and Xpdf are required for this feature. See PRESS-READY for more information.
  1. How to install

    • You need to install Node.js prior to using it.
    • It can be installed from the npm package.

    Vivliostyle CLI will be released as an npm package. Also, Node.js must be installed.

    $ npm install -g @vivliostyle/cli
  2. Create PDF from HTML

    • On the command line you can use the build command to specify an HTML file to convert into a PDF file typeset with CSS.

    In the Terminal command line, run it with your HTML file to output PDF file with CSS typesetting. There is also a preview option.

    $ vivliostyle build index.html
  3. Preview

    • With the preview command, you can check what the results would look like.
    • Use -h to see details of the usage. Also check the help help [cmd] for each command.
    $ vivliostyle preview index.html

For more information about Vivliostyle CLI, see Vivliostyle CLI User Guide.

Vivliostyle Pub (Alpha version to be released in April 2022) v0.0.0

Edit text/Markdown/HTML in the left pane and preview the formatted results in the right pane.