A URL may not display correctly when it contains characters such as underscores (_) or carets (+^). This problem occurs because the markup parser interprets parts of the URL (i.e., the link target) as valid text formatting markup. Most lightweight markup languages have this issue because they don’t use a grammar-based parser. Asciidoctor plans to handle URLs more carefully in the future (see issue #281), which may be solved by moving to a grammar-based parser (see issue #61). Thankfully, there are many ways to include URLs of arbitrary complexity using the AsciiDoc passthrough mechanisms.

Adding source code to ASCIIDoc documents is easy. ASCIIDoctor can be used to easily convert them to HTML5 documents using the html5 backend (which is the default). However, the source code is not rendered with syntax highlighting.

Markdown est un système de publication et de formatage de texte minimaliste de plus en plus utilisé. Ce site se propose de vous aider à l’apprendre rapidement.

Thankfully, Haskell is an almost batteries-included language. And it makes getting yourself up and running MUCH easier than it is for other languages.

AsciiDoc is a lightweight markup language for authoring notes, articles, documentation, books, web pages, slide decks and man pages in plain text. This guide is a quick reference for the common AsciiDoc document and text formatting markup.

AsciiDoc has a slidy backend for generating self contained Slidy HTML slideshows.

This guide provides a gentle introduction to AsciiDoc, a plain text documentation syntax and processor. This introduction is intended for anyone who wants to reduce the effort required to write and publish content, whether for technical documentation, articles, web pages or good ol'-fashioned prose.