whatisgithub

What is htmlbook?

hadley/htmlbook — explained in plain English

Analysis updated 2026-07-07 · repo last pushed 2023-01-26

12HTMLAudience · writerComplexity · 2/5DormantSetup · moderate

In one sentence

Converts Quarto books into O'Reilly's HTML format for their Atlas publishing platform, saving authors from manual reformatting when publishing technical books.

Mindmap

mindmap
  root((repo))
    What it does
      Converts Quarto to HTML
      For OReilly Atlas platform
      Single command conversion
    Tech stack
      HTML
      Quarto
      Command line tool
    Use cases
      Publish Quarto book on OReilly
      Convert technical book elements
      Save manual reformatting effort
    Audience
      Technical book authors
      Quarto users
      Data science writers
    Proven books
      R for Data Science
      R Packages
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Convert a Quarto book manuscript into O'Reilly-ready HTML for their Atlas platform.

USE CASE 2

Publish a data science or technical book written in Quarto through O'Reilly without manual reformatting.

USE CASE 3

Generate properly structured HTML with chapters, figures, code blocks, and cross-references for O'Reilly.

What is it built with?

HTMLQuartoCLI

How does it compare?

hadley/htmlbookkhaosdoctor/dontquotetheaimastodon/activitypub
Stars121212
LanguageHTMLHTMLHTML
Last pushed2023-01-262017-09-07
MaintenanceDormantDormant
Setup difficultymoderateeasyeasy
Complexity2/51/51/5
Audiencewriterdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an existing Quarto book project and manual editing of a configuration file to set chapter order before running the conversion.

No license information is provided in this repository.

So what is it?

If you've written a book using Quarto and want to publish it through O'Reilly, this tool bridges the gap. It converts your Quarto book into O'Reilly's specific HTML format, so you can get your manuscript onto their publishing platform without manually reformatting everything. The workflow is straightforward. You first render your Quarto book as you normally would, then run a single command from this tool. It generates a new folder containing the HTML files ready for O'Reilly's Atlas platform. You do need to manually handle one piece: updating a configuration file to make sure your chapters appear in the right order. The tool handles the core elements of a technical book: overall structure with parts and appendices, figures, code blocks, cross-references, callouts, and footnotes. The author notes it's "far from perfect," but it has been used successfully on two real books, R for Data Science and R Packages, so it works for production-quality publishing. This is a niche tool for a specific audience: authors who write in Quarto (popular in the R and data science community) and publish through O'Reilly. If you're not in that intersection, you likely won't need it. But if you are, it saves what would otherwise be a tedious manual conversion process.

Copy-paste prompts

Prompt 1
I have a Quarto book project. Help me install and run htmlbook to convert it into O'Reilly Atlas HTML format, including how to configure the chapter order file.
Prompt 2
My Quarto book has callouts, footnotes, cross-references, and code blocks. Will htmlbook handle all of these correctly when converting to O'Reilly HTML? Walk me through what is supported.
Prompt 3
I'm writing a technical book in Quarto and want to publish with O'Reilly. Set up the full workflow: render the Quarto book, run the htmlbook conversion, and prepare the output folder for Atlas upload.

Frequently asked questions

What is htmlbook?

Converts Quarto books into O'Reilly's HTML format for their Atlas publishing platform, saving authors from manual reformatting when publishing technical books.

What language is htmlbook written in?

Mainly HTML. The stack also includes HTML, Quarto, CLI.

Is htmlbook actively maintained?

Dormant — no commits in 2+ years (last push 2023-01-26).

What license does htmlbook use?

No license information is provided in this repository.

How hard is htmlbook to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is htmlbook for?

Mainly writer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.