Eleventy plugin to add support for AsciiDoc. You don't need to use to shortcodes. You can directly use AsciiDoc files (.adoc), just like Markdown (.md).

The plugin uses Asciidoctor.js under the hood.

Requires Eleventy 1.0.0-beta.10, 1.0.0-canary.50 or newer.

• Supports the default YAML front matter.
• Supports AsciiDoc document title
• Other attributes in the AsciiDoc files are made available in templates through asciidocAttributes.
  • Example :author: Jane Doe in the .adoc file will be available as asciidocAttrbutes.author

npm install eleventy-plugin-asciidoc

Usually .eleventy.js:

const eleventyAsciidoc = require("eleventy-plugin-asciidoc");

module.exports = function (eleventyConfig) {
  eleventyConfig.addPlugin(eleventyAsciidoc);
};

You can pass options to convert() of Asciidoctor.js as second argument in addPlugin(). These are the available options.

const eleventyAsciidoc = require("eleventy-plugin-asciidoc");

module.exports = function (eleventyConfig) {
  eleventyConfig.addPlugin(eleventyAsciidoc, {
    attributes: {
      showtitle: true /* Default value: undefined */,
    },
    safe: "unsafe" /* Default value: undefined */,
  });
};

The base_dir of convert options is relative to the document. This can be changed using above options.

The plugin does not include any CSS styles. It is up to you to style the content.

The quick way to style the content is to use the CSS file from Asciidoctor.js. The CSS file is available on cdnjs.

• Tutorial on adding syntax highlighting