Documentation generators and custom syntax highlighting

This page summarizes the projects mentioned and recommended in the original post on /r/ProgrammingLanguages

Our great sponsors
  • WorkOS - The modern identity platform for B2B SaaS
  • InfluxDB - Power Real-Time Data Analytics at Scale
  • SaaSHub - Software Alternatives and Reviews
  • Highlight.js

    JavaScript syntax highlighter with language auto-detection and zero dependencies.

  • I use Asciidoctor, highlightjs, a custom highlight.js language definition and that bash script:

  • Asciidoctor

    :gem: A fast, open source text processor and publishing toolchain, written in Ruby, for converting AsciiDoc content to HTML 5, DocBook 5, and other formats.

  • I use Asciidoctor, highlightjs, a custom highlight.js language definition and that bash script:

  • WorkOS

    The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.

    WorkOS logo
  • markup

    Determines which markup library to use to render a content file (e.g. README) on GitHub

  • I'm not sure 4. works for colors/styling, style attributes are stripped: https://github.com/github/markup/issues/119

  • syntect

    Rust library for syntax highlighting using Sublime Text syntax definitions.

  • Zola (https://www.getzola.org/) can generate from markdown-ish files nice looking documentation websites (and also RSS feeds), it uses syntect (https://github.com/trishume/syntect) which supports sublime syntax highlight files. For github readme I don't have a solution besides using a png.

  • gutenberg

    A fast static site generator in a single binary with everything built-in. https://www.getzola.org

  • Zola (https://www.getzola.org/) can generate from markdown-ish files nice looking documentation websites (and also RSS feeds), it uses syntect (https://github.com/trishume/syntect) which supports sublime syntax highlight files. For github readme I don't have a solution besides using a png.

  • InfluxDB

    Power Real-Time Data Analytics at Scale. Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.

    InfluxDB logo
NOTE: The number of mentions on this list indicates mentions on common posts plus user suggested alternatives. Hence, a higher number means a more popular project.

Suggest a related project

Related posts