Asciidoctor Asciidoctor Docs
AsciiDoc
Language Syntax Quick Reference
Processing
Asciidoctor Ruby Asciidoctor.js JavaScript AsciidoctorJ Java
Extensions
Add-on Converters
reveal.js Ruby, JavaScript PDF Ruby EPUB3 Ruby
Extended Syntax
Asciidoctor Diagram Ruby
Tooling
Build Automation
Maven Tools Java Asciidoclet Java
Text Editors / Viewers
Browser Extension IntelliJ Plugin
Chat List 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
    • 2.2
  • AsciidoctorJ
    • 2.5
    • 2.4
  • Browser Extension
    • 3.0
  • Maven Tools
    • 2.2
  • Asciidoclet
    • 1.5.6
  • Asciidoctor reveal.js
    • 4.1
  • Asciidoctor PDF
    • 2.3
    • 2.2
    • 2.1
    • 2.0
  • Asciidoctor EPUB3
    • 1.5
  • Asciidoctor Diagram
    • 2.2
  • 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
  • Home
  • Docs
  • Chat
  • List
  • Source

Twitter logo@asciidoctor

Copyright © 2023 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 Algolia logo Deploys by Netlify

Authored in AsciiDoc.
Produced by Antora and Asciidoctor.