Asciidoctor Asciidoctor Docs
AsciiDoc
Language Syntax Quick Reference
Processing
Asciidoctor Ruby Asciidoctor.js JavaScript AsciidoctorJ Java
Extensions
Add-on Converters
PDF Ruby EPUB3 Ruby reveal.js Ruby, JavaScript
Source Compilers
Reducer Ruby, JavaScript
Extended Syntax
Asciidoctor Diagram Ruby
Tooling
Build Automation
Maven Tools Java Gradle Plugin Java Asciidoclet Java
Text Editors / Viewers
Browser Extension IntelliJ Plugin
Chat Source Tweets

Asciidoctor

    • Features
    • What’s New in 2.0
    • Install and Update
      • Supported Platforms
      • Install Using Ruby Packaging
      • Install Using Linux Packaging
      • Install on macOS
      • Install on Windows
    • Convert Your First File
    • Converters
      • Available Converters
      • Custom Converter
      • Converter Templates
      • Convertible Contexts
    • Generate HTML
      • Stylesheets
        • Default Stylesheet
        • Stylesheet Modes
        • Apply a Custom Stylesheet
        • Embed a CodeRay or Pygments Stylesheet
      • Manage Images
      • Use Local Font Awesome
      • Add a Favicon
      • Verbatim Block Line Wrapping
      • Skip Front Matter
    • Generate DocBook
    • Generate Manual Pages
    • Process AsciiDoc Using the CLI
      • asciidoctor(1)
      • Specify an Output File
      • Process Multiple Source Files
      • Pipe Content Through the CLI
      • Set Safe Mode
      • CLI Options
    • Process AsciiDoc Using the API
      • Load and Convert Files
      • Load and Convert Strings
      • Generate an HTML TOC
      • Set Safe Mode
      • Enable the Sourcemap
      • Catalog Assets
      • Find Blocks
      • API Options
    • Safe Modes
      • Safe Mode Specific Content
    • AsciiDoc Tooling
    • Syntax Highlighting
      • Highlight.js
      • Rouge
      • CodeRay
      • Pygments
      • Custom Adapter
    • STEM Processing
      • MathJax and HTML
      • Asciidoctor Mathematical
      • STEM Support in the DocBook Toolchain
      • AsciiMath Gem
    • Extensions
      • Register Extensions
      • Log from an Extension
      • Preprocessor
      • Tree Processor
      • Postprocessor
      • Docinfo Processor
      • Block Processor
      • Compound Block Processor
      • Block Macro Processor
      • Inline Macro Processor
      • Include Processor
    • Localization Support
    • Errors and Warnings
    • Migration Guides
      • Upgrade from Asciidoctor 1.5.x to 2.0
      • Migrate from AsciiDoc.py
      • Migrate from DocBook XML
      • Migrate from Markdown
      • Migrate from Confluence XHTML
      • Migrate from MS Word
Asciidoctor 2.0
  • AsciiDoc
  • Asciidoctor
    • 2.0
  • Asciidoctor.js
    • 3.0
    • 2.2
  • AsciidoctorJ
    • 3.0
    • 2.5
  • Asciidoctor PDF
    • 2.3
    • 2.2
    • 2.1
    • 2.0
  • Asciidoctor EPUB3
    • 2.1
  • Asciidoctor reveal.js
    • 5.0
    • 4.1
  • Maven Tools
    • 3.2
  • Gradle Plugin Suite
    • 4.0
  • Asciidoclet
    • 2.0
    • 1.5.6
  • Asciidoctor Diagram
    • 2.3
  • Browser Extension
  • Community
  • Asciidoctor
  • Install and Update
  • Install on Windows
Edit this Page

Install on Windows

To install Asciidoctor on Windows, you can use Chocolatey or RubyInstaller.

Chocolatey

When you already use Chocolatey on your machine, you can use:

C:\> choco install ruby

Then follow the gem installation instructions.

RubyInstaller

Or you use the RubyInstaller, download the package for your Windows Version and after the installation, then follow the gem installation instructions.

Install on macOS Convert Your First File
Asciidoctor
Asciidoctor
  • Docs
  • Chat
  • Source
  • List (archive)

Twitter logo@asciidoctor

Copyright © 2025 Dan Allen, Sarah White, and individual Asciidoctor contributors. Except where noted, the content is licensed under a Creative Commons Attribution 4.0 International (CC BY 4.0) license.

The UI for this site is derived from the Antora default UI and is licensed under the MPL-2.0 license. Several icons are imported from Octicons and are licensed under the MIT license.

AsciiDoc® and AsciiDoc Language™ are trademarks of the Eclipse Foundation, Inc.

Thanks to our backers and contributors for helping to make this project possible. Additional thanks to:

OpenDevise Logo Zulip logo Algolia logo Deploys by Netlify

Authored in AsciiDoc.
Produced by Antora and Asciidoctor.