Hugo Themes Logo Hugo Themes
Hugo Theme Vivliocli screenshot

Hugo Theme Vivliocli

Author Avatar Theme by Mochimochiki
Updated: 2 Aug 2025
10 Stars

Hugo theme for building document site that can output typeset PDFs using Vivliostyle CLI.

Github Live Preview

Overview:

hugo-theme-vivliocli is a Hugo theme that allows users to build document sites that can output typeset PDF. It utilizes Vivliostyle CLI to generate PDF files with cover, table of contents, bookmarks, chapter numbers, and page numbers. The theme offers various customization options such as selecting a book style or a simple style for the PDF output, specifying the output level and format of chapter numbers, and supporting multiple editions of PDF output.

Features:

  • Typeset PDF: Any section of the site with an _pdf.md file can be output as a typeset PDF with cover, table of contents, bookmarks, chapter numbers, and page numbers.
  • Drawing complex tables with merged cells: Users can easily draw complex tables by including a CSV file in Markdown, with support for vertical and horizontal cell merging.
  • Supports Mermaid and Mathjax: The theme supports the use of Mermaid and Mathjax to create powerful diagrams, charts, and math formulas.
  • Multiple editions of PDF output: ShowIf / HideIf shortcodes can be used to selectively include or exclude content in specific editions, allowing for the creation of sets of PDFs with different levels of detail.

Installation:

To use the hugo-theme-vivliocli, please follow these steps:

  1. Install Hugo (v0.94.0 or later).
  2. Install Vivliostyle CLI (v5.3.0 or later).
  3. Clone or download the theme repository.
  4. Copy the theme folder to the themes directory of your Hugo site.
  5. Configure your site’s config.toml file to use hugo-theme-vivliocli.
  6. Customize the theme’s settings and content according to your needs.

For detailed instructions, please refer to the User Guide.

Summary:

hugo-theme-vivliocli is a feature-rich Hugo theme that allows users to build document sites and generate typeset PDFs. With support for complex tables, Mermaid, and Mathjax, as well as the ability to create multiple editions of PDF output, this theme offers a comprehensive solution for creating and publishing professional-looking documents. Installing the theme is straightforward, and its customizable settings allow users to tailor the appearance and functionality to their specific requirements.