AsciiDoc

Compatible with: IntelliJ IDEA PhpStorm WebStorm PyCharm RubyMine AppCode CLion GoLand DataGrip Rider MPS Android Studio
Mar 04, 2019
455 243

AsciiDoc language support for IntelliJ platform.

AsciiDoc is a text document format, similar to formats like Markdown, for writing notes, documentation, articles, books, ebooks, slideshows, web pages, man pages and blogs. AsciiDoc files can be translated to many formats including HTML, PDF, EPUB, man page. AsciiDoc is, in contrast to Markdown, highly configurable: both the AsciiDoc source file syntax and the backend output markups (which can be almost any type of SGML/XML markup) can be customized and extended by the user.

The most advanced and recommended preview mode is JavaFX. To use the JavaFX preview instead of the Swing preview, you'll need to run IntelliJ with 64bit Java and JavaFX installed. Oracle JDK installations include JavaFX, but can make the IDE unstable and crash. Pre-bundled OpenJDK installations usually don't include JavaFX. Therefore, JetBrains OpenJDK pre-bundled with your IDE is recommended. See Selecting the JDK version the IDE will run under for more details.

For better legibility in the JavaFX preview, this package includes DejaVu fonts. See here for the free fonts license.

Recent change notes

  • 0.24.3 Filter out problematic pass-through JavaScript with Twitter being the first candidate (#235)
  • 0.24.2 Support JDK11 as of IntelliJ 2019.1 EAP (#238)
  • 0.24.1 Upgrade to AsciidoctorJ 1.6.2 and JRuby 9.2.6.0 (it's still backed by Asciidoctor 1.5.8)
    Upgrade to asciidoctor diagram 1.5.12
    Additional logging to analyze errors (#236)
  • 0.24.0 Upgrade to AsciidoctorJ 1.6.1 and JRuby 9.2.5.0 (it's still backed by Asciidoctor 1.5.8)
    Upgrade to asciidoctor diagram 1.5.11
    Updated parser for old style multiline headings to be more specific (#233)
    Added description for old style heading inspection (#233)
  • 0.23.2 Resource cleanup for Asciidoctor Ruby Extensions (#220)
  • 0.23.1 Updated file icon with less intrusive icon, also introducing SVG for icons (#230)
    Editor notification to switch to JetBrains 64bit JDK (#189)
    Tuning support for Asciidoctor Ruby Extensions (#220)
  • 0.23.0 EXPERIMENTAL: Support Asciidoctor Ruby Extensions when placed in _.asciidoctor/lib_ (#220)
  • 0.22.0 Update to AsciidoctorJ 1.5.8.1
    Workaround for incompatible plugins (#226)
    Toggle softwraps only available in context menu of AsciiDoc documents (#227)
    Recognize list continuations plus block instead of marking them as old style headings (#228)
    EXPERIMENTAL: supporting _.asciidoctorconfig_ configuration files (#220)
  • 0.21.4 Add official asciidoctor logo (#219)
    Add soft wrap to tool bar (#221)
    Editor Toolbar show status of toggles
    Update to Asciidoctor Diagram 1.5.10 (#215)
  • 0.21.3 upgrade to MathJAX 2.4.7 (as bundled in AsciidoctorJ 1.5.7)
  • 0.21.2 show title of document again (#217)
  • 0.21.1 allow attributes to be pre-defined in plugin settings (#216)
  • 0.21.0 Update to AsciidoctorJ 1.5.7 and Asciidoctor Diagram 1.5.9
    Treat "line must be non negative" only as a warning (#212)