Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
A

asciidoctor-diagram

> 编程语言
Open source

:left_right_arrow: Asciidoctor diagram extension, with support for AsciiToSVG, BlockDiag (BlockDiag, SeqDiag, ActDiag, NwDiag), Ditaa, Erd, GraphViz, Mermaid, M

477 stars0 likes2 views
WebsiteGitHub

About

:left_right_arrow: Asciidoctor diagram extension, with support for AsciiToSVG, BlockDiag (BlockDiag, SeqDiag, ActDiag, NwDiag), Ditaa, Erd, GraphViz, Mermaid, M

= Asciidoctor Diagram Pepijn Van_Eeckhoudt ; Sarah White :description: README for the Asciidoctor Diagram extension for Asciidoctor.

image:https://github.com/asciidoctor/asciidoctor-diagram/workflows/Linux%20unit%20tests/badge.svg?branch=main["Linux Build Status", link="https://github.com/asciidoctor/asciidoctor-diagram/actions?query=workflow%3A%22Linux+unit+tests%22"] // image:https://github.com/asciidoctor/asciidoctor-diagram/workflows/macOS%20unit%20tests/badge.svg?branch=main["macOS Build Status", link="https://github.com/asciidoctor/asciidoctor-diagram/actions?query=workflow%3A%22macOS+unit+tests%22"] // image:https://github.com/asciidoctor/asciidoctor-diagram/workflows/Windows%20unit%20tests/badge.svg?branch=main["Windows Build Status", link="https://github.com/asciidoctor/asciidoctor-diagram/actions?query=workflow%3A%22Windows+unit+tests%22"] image:https://badge.fury.io/rb/asciidoctor-diagram.svg[Gem Version, link=https://rubygems.org/gems/asciidoctor-diagram]

Asciidoctor Diagram is a set of Asciidoctor extensions that enable you to add diagrams, which you describe using plain text, to your AsciiDoc document. The extension will run the appropriate diagram processor to generate an image from the input text. The generated image is then inserted into your converted document.

Detailed usage instructions can be found on the https://docs.asciidoctor.org/diagram-extension/latest/[Asciidoctor documentation site].

Asciidoctor Diagram was inspired by the https://code.google.com/p/asciidoc-plantuml/[AsciiDoc PlantUML filter].

== Example

The Asciidoctor Diagram enables you to embed a plain text diagram as a block in your document. The example below shows an embedded Ditaa diagram block.


[ditaa]

                     +-------------+
                     |   Diagram   +----------------+
                     |   Renderer  |                |
                     +-------------+                |
                     | Asciidoctor |                |
                     |   Diagram   |                |
                     +-------------+                | Image
                            ^                       |
                            | Diagram source        |

+---------------+ | v | Asciidoc | +------+------+ /-------+------
| with embedded +------>+ Asciidoctor +------->| Beautiful | | diagram {d}| +-------------+ HTML | Output | +---------------+ --------------/


After processing by Asciidoctor, the output file will show a rendered version of the diagram instead of the diagram source code.

image::docs/modules/ROOT/images/asciidoctor-diagram-process.png[]

Issues· 33 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Ruby

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言