Try writing in AsciiDoc

2025-10-16 (Last Modified: 2025-10-16)

This is a Hugo article written in AsciiDoc.

Markdown Syntax comparison table between AsciiDoc and

Features How to write Markdown How to write AsciiDoc Notes

Features	How to write Markdown	How to write AsciiDoc	Notes
Heading	`# Heading 1` `## Heading 2`	`= Heading 1` `== Heading 2`	AsciiDoc indicates hierarchy by the number of "=
Paragraphs	Separated by a blank line	Separated by a blank line	Common
Emphasis (bold)	`emphasis` or `emphasis`	`Emphasis`	More concise than Markdown
italics	`italic` or`italic`	`italic`	Kanji fonts may not italicize
Strikeout	`_~Strikeout~`	`Strikeout`	Write with attributes
Bullet points (ul)	`- Item` or`* Item`	`* Item`	Similar to Markdown
Numbered lists (ol)	`1. Item`	`. Item .`	Write with periods (automatic sequential numbering)
Link	`[Display name](URL)`	`Display name`	HTML attributes, etc. can also be specified
Image	`![Description](画像.png)`	`image::Image.png[Description]`	Size and position can be specified Examples:.`image::a.png[width=300,align=center]`
Quotations	`> Quote.`	`[quote]` _ ` `Quoted text `_ `	Can be decorated with block syntax
Code (inline)	`code`	`code` or`code`	Almost the same
Code block	```cpp code	[source,cpp] ---- code ----	AsciiDoc specifies language attributes with tags
Horizontal line	--- または *	'---'	Almost the same
Image with link	[![img](a.png)](URL)		Combination is natural
Annotation (FOOTNOTE)	[^1] and at the end of the text [^1]: annotation content	^[1]	AsciiDoc is easier
Block quotations (multi-line)	> Multiple lines	[quote, Author, Source] _ Full text _	Suitable for book style
Table of Contents	Generated by Hugo	:toc: or toc::[]	AsciiDoc can be completed in a single file
Comment	<!-- コメント -→	// Comment	More concise than Markdown
Attribute definitions (variables)	None	:name: Value → {name}	AsciiDoc allows variable expansion
Newline (explicit)	At the end (two spaces)	+(single line)	AsciiDoc is clearer

Heading

# Heading 1
## Heading 2

= Heading 1
== Heading 2

AsciiDoc indicates hierarchy by the number of "=

Paragraphs

Separated by a blank line

Common

Emphasis (bold)

emphasis or emphasis

Emphasis

More concise than Markdown

italics

italic or`italic`

italic

Kanji fonts may not italicize

Strikeout

_~Strikeout~

Strikeout

Write with attributes

Bullet points (ul)

- Item or`* Item`

* Item

Similar to Markdown

Numbered lists (ol)

1. Item

. Item .

Write with periods (automatic sequential numbering)

Link

[Display name](URL)

Display name

HTML attributes, etc. can also be specified

Image

![Description](画像.png)

image::Image.png[Description]

Size and position can be specified
Examples:.image::a.png[width=300,align=center]

Quotations

> Quote.

[quote]
_ ` `Quoted text
`_ `

Can be decorated with block syntax

Code (inline)

code

code or`code`

Almost the same

Code block

```cpp
code

[source,cpp]
----
code
----

AsciiDoc specifies language attributes with tags

Horizontal line

--- または *

'---'

Almost the same

Image with link

[![img](a.png)](URL)

Combination is natural

Annotation (FOOTNOTE)

[^1] and at the end of the text [^1]: annotation content

^[1]

AsciiDoc is easier

Block quotations (multi-line)

> Multiple lines

[quote, Author, Source]
_
Full text
_

Suitable for book style

Table of Contents

Generated by Hugo

:toc: or toc::[]

AsciiDoc can be completed in a single file

Comment

<!-- コメント -→

// Comment

More concise than Markdown

Attribute definitions (variables)

None

:name: Value → {name}

AsciiDoc allows variable expansion

Newline (explicit)

At the end (two spaces)

+(single line)

AsciiDoc is clearer

Example

Bullet points Emphasis ABCItalics

// Code block (Asciidoctor style)
#include <bits/stdc++.h>
int main(){ std::cout << "hello\n"; }

within a line: \(E = mc^2\)

\[\int_0^\infty e^{-x^2}\,dx = \frac{\sqrt{\pi}}{2}\]

1. Annotation content