livecode-static/docs/languages/asciidoc.html.md
2025-06-11 22:23:49 +08:00

1.9 KiB
Raw Blame History

AsciiDoc

import LiveCodes from '../../src/components/LiveCodes.tsx';

AsciiDoc is a plain text markup language for writing technical content. Its packed with semantic elements and equipped with features to modularize and reuse content. AsciiDoc content can be composed using a text editor, managed in a version control system, and published to multiple output formats.

In LiveCodes, AsciiDoc is compiled to HTML using Asciidoctor.

Usage

Demo

export const asciidocConfig = { markup: { language: 'asciidoc', content: `= AsciiDoc Demo

== Features

  • Simple
  • Clean
  • Dev-friendly `, }, }

Language Info

Name

asciidoc

Extensions

adoc, asc

Editor

markup

Compiler

Asciidoctor.js

Version

Asciidoctor.js: v2.2.8

Code Formatting

Not supported.

Custom Settings

Custom settings added to the property asciidoc are passed as a JSON object to the convert() function during compile. Please check the documentation and document attributes for full reference.

Please note that custom settings should be valid JSON (i.e. functions are not allowed).

{
  "asciidoc": {
    "attributes": {
      "source-highlighter": "highlight.js",
      "icons": "font"
    }
  }
}

Limitations

  • Some advanced extensions may not work (e.g. diagrams)