== Try AsciiDoc now: Experience the magic of a lightweight markup language
== Try AsciiDoc now!: Experience the magic of a lightweight markup language
You write AsciiDoc using plain text.
You write AsciiDoc using plain text.
That means most of what you type is what you want to communicate.
That means most of what you type is what you want to communicate.
You only enter markup characters when you need to encode meaning that can't be inferred.
You only need to add markup characters when you want to encode meaning that can't be inferred.
[.attn]#Try writing with AsciiDoc in the editor below to see for yourself!#
For example, a section title starts with a series of equals signs and an unordered list item begins with one or more asterisks.
// The next two lines should be used as hints in the content already in the interactive editor
[.attn]#Try writing AsciiDoc in the editor below to see for yourself!#
//Start a line with a series of equal signs to make a section title.
//Prefix text with an asterisk to make an item in a list.
[#editor-code,asciidoc]
[#editor-code,asciidoc]
------
------
...
@@ -116,11 +115,11 @@ puts 'Hello, World!'
...
@@ -116,11 +115,11 @@ puts 'Hello, World!'
[#compare.compare]
[#compare.compare]
== How AsciiDoc stacks up: Compare AsciiDoc to other markup languages
== How AsciiDoc stacks up: Compare AsciiDoc to other markup languages
AsciiDoc is designed to strike a balance between systematic, machine-oriented syntax and plain text with minimalist markup.
AsciiDoc is designed to strike a balance between systematic, machine-oriented syntax and plain text with minimal markup.
In fact, AsciiDoc can capture and encode nearly all of the semantics of a structured language while still being readable in source form.
This design affords AsciiDoc the ability to capture and encode nearly all the semantics of a structured language while still being readable in source form.
Want to see how AsciiDoc stacks up against alternatives?
Want to see how AsciiDoc stacks up against alternatives?
Browse the sample documents below to compare.
Browse the sample documents in this section to compare.
[.tab.compare]
[.tab.compare]
--
--
...
@@ -282,21 +281,21 @@ AsciiDoc processors bundle a **stylesheet** that requires **no web development**
...
@@ -282,21 +281,21 @@ AsciiDoc processors bundle a **stylesheet** that requires **no web development**
[#specifications]
[#specifications]
== Specification process: Governed by a language specification, always evolving
== Specification process: Governed by a language specification, always evolving
The AsciiDoc Language specification will ensure AsciiDoc is processed consistently by implementations that span language runtimes, authoring environments, and application integrations.
The AsciiDoc Language specification was established to ensure that AsciiDoc continues to evolve and that it's processed consistently by implementations across language runtimes, authoring environments, and application integrations.
The specification is managed and governed by the AsciiDoc Language project and, at a higher level, by the AsciiDoc Working Group at the Eclipse Foundation.
The specification is managed and governed by the AsciiDoc Language project and, at a higher level, by the AsciiDoc Working Group at the Eclipse Foundation.
Development of the specification is currently underway.
Development of the specification is currently underway.