Install and Update

Install from VS Code

Launch Visual Studio Code "Quick Open" (Ctrl+P), paste the following command, and press Enter:

ext install asciidoctor.asciidoctor-vscode

Alternatively, open the built-in Extensions browser, search for the AsciiDoc extension by asciidoctor, and install it.

VS Code for the Web

This extension is also available as a pre-release (alpha) in Visual Studio Code for the Web and can be installed using the same procedure.

Not every feature is available in the browser. The table below summarizes what each environment supports.

Feature Desktop Web

Feature	Desktop	Web
Document outline and symbols	✔️	✔️
Bold/italic/monospace shortcuts	✔️	✔️
`include::` directives	✔️	✔️ (relative paths within the workspace)
Equations (via MathJax)	✔️	✔️ (requires security to be disabled)
Export as PDF	✔️	⛔
Kroki integration for diagrams	✔️	✔️
Paste image	✔️	✔️ (via `Ctrl`+`V` in the editor)
Save as HTML	✔️	⛔
Save as DocBook	✔️	⛔
Snippets	✔️	✔️
Syntax highlighting	✔️	✔️ (requires security to be disabled)
Sync scrolling between editor and preview	✔️	✔️

Document outline and symbols

✔️

Bold/italic/monospace shortcuts

✔️

include:: directives

✔️

✔️ (relative paths within the workspace)

Equations (via MathJax)

✔️

✔️ (requires security to be disabled)

Export as PDF

✔️

⛔

Kroki integration for diagrams

✔️

Paste image

✔️

✔️ (via Ctrl+V in the editor)

Save as HTML

✔️

⛔

Save as DocBook

✔️

⛔

Snippets

✔️

Syntax highlighting

✔️

✔️ (requires security to be disabled)

Sync scrolling between editor and preview

✔️

Update

Updates are installed automatically by VS Code.

To roll back to a previous release, open the Extensions browser, click the gear icon next to the AsciiDoc extension, and select Install Another Version…. A menu lets you choose which version to install.