Skip to content
Novus Examples
adoc723 B

AsciiDoc Guide (ADOC source)

An AsciiDoc getting-started guide with source blocks, an admonition, and a table — for testing AsciiDoc renderers (Asciidoctor), editors, and conversion to HTML/PDF.

Preview — first 40 linesadoc
= Novus Widget: Getting Started
Novus Examples <docs@example.com>
:toc:
:icons: font

A sample AsciiDoc document for testing renderers and editors.

== Installation

[source,bash]
----
npm install novus-widget
----

== Usage

Import the widget and mount it:

[source,js]
----
import { Widget } from "novus-widget";
new Widget("#app").render();
----

TIP: Call `render()` after the DOM is ready.

== Options

[cols="1,1,3", options="header"]
|===
| Option | Default | Description
| theme  | light   | Colour theme (light or dark)
| size   | md      | One of sm, md, lg
| locale | en      | BCP-47 language tag
|===

== License

Free for any use. This text is synthetic sample content.

Specifications

Format
AsciiDoc
Features
headings, source blocks, admonition, table

What is a .adoc file?

AsciiDoc is a lightweight plain-text markup language for writing documentation, articles, and books. It is more powerful than Markdown — with admonitions, includes, tables, and cross-references — and converts to HTML, PDF, DocBook, and man pages via tools like Asciidoctor. The .adoc extension is the common file type.

How to use this file

Use an example .adoc file to test AsciiDoc editors and renderers, syntax highlighting, and Asciidoctor conversion to HTML or PDF.

Generated by generation/docs_realworld.py. Free for any use, no attribution required — license.