# asciidoctor-intellij-plugin **Repository Path**: ideplugin/asciidoctor-intellij-plugin ## Basic Information - **Project Name**: asciidoctor-intellij-plugin - **Description**: mirror of https://github.com/asciidoctor/asciidoctor-intellij-plugin/ - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: 0.29.x - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2021-12-09 - **Last Updated**: 2021-12-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README = IntelliJ AsciiDoc Plugin Alexander Schwartz :experimental: :url-ci-travis: https://travis-ci.org/asciidoctor/asciidoctor-intellij-plugin image::https://api.travis-ci.org/asciidoctor/asciidoctor-intellij-plugin.svg?branch=master[link={url-ci-travis}] A plugin for the IntelliJ platform (IntelliJ IDEA, RubyMine, etc) that provides support for the http://www.asciidoc.org[AsciiDoc] markup language. To support the authors of Asciidoctor, please consider supporting us via https://opencollective.com/asciidoctor[OpenCollective]. *You can meet the maintainers in person:* Please ping them via eMail or chat before or during the event! * https://www.ahus1.de/[Alex] at https://2019.javazone.no/[JavaZone (Oslo, NO)], 2019-09-11..12 * https://www.ahus1.de/[Alex] at https://baselone.ch/[BaselOne (Basel, CH)], 2019-10-17 == Installation You can install the plugin (named "AsciiDoc") from the plugins section inside your JetBrains IDE or download it from the https://plugins.jetbrains.com/plugin/7391[JetBrains Plugin Repository]. The most advanced and recommended preview mode (and default for new installations) 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. From 2017.1 onwards a JetBrains OpenJDK 64bit is included even in the Windows versions. Please only use the JDK provided by JetBrains, as the JavaFX rendering seems to be most stable in the JetBrains JDK. See https://intellij-support.jetbrains.com/hc/en-us/articles/206544879-Selecting-the-JDK-version-the-IDE-will-run-under[Selecting the JDK version the IDE will run under] for more details. == Features * Recognizes the AsciiDoc file extension (.adoc, .asciidoc, .ad) * Provides a two-pane AsciiDoc preview editor based on https://github.com/asciidoctor/asciidoctorj[AsciidoctorJ] with live preview. * Toolbar and context menu for basic formatting and to create tables. * Refactor Markdown to AsciiDoc: Right click on a file, or use the Refactor menu, and the Markdown document will be replaced by the AsciiDoc equivalent. Also supports undo, in case you're not happy with the result! Refer to the link:FEATURES.adoc[Features list] for a detailed overview of the features. If you are missing features, please don't hesitate to let me know on Twitter: http://www.twitter.com/ahus1de[@ahus1de] or create an issue in the GitHub issue tracker! Refer to the link:CHANGELOG.adoc[CHANGELOG] for a complete list of changes in older releases. == Dependencies This project uses AsciiDoctorJ and JRuby for the rendering of the AsciiDoc content. For the conversion of Markdown to AsciiDoc, we use Pegdown and the https://github.com/bodiam/markdown-to-asciidoc[Markdown to AsciiDoc] converter. == Building an Contributing Please have a look at the link:CONTRIBUTING.adoc["How to Build and Contribute"] documentation. == Copyright and Licensing Copyright (C) 2013-2019 Julien Viet, Erik Pragt and Alexander Schwartz. Released under the Apache License, Version 2.0 (see link:LICENSE[LICENSE]). == Credits This plugin is based on the https://github.com/nicoulaj/idea-markdown[Intellij Markdown plugin by Julien Nicoulaud]. Also, great help was received from Erik Pragt, Harro Lissenberg, Alexander Schwartz and Dan Allen. Thank you all for your support!