Markdown to AsciiDoc converter

Q: What about table alignment?

Markdown column alignment is converted into the cols attribute (<, ^, >).

Move docs from Markdown to AsciiDoc for Asciidoctor or Antora without retyping headings, tables and code blocks.

Markdown

## Release 2.4

This release adds **dark mode**, fixes *two* bugs and drops ~~IE11~~.
See the [changelog](https://example.com/changelog) for details.

- Faster startup
- New `--watch` flag
  - Works on Windows

1. Update the package
2. Restart the server

> Back up your config first.

| Area | Status | Owner |
| :--- | :----: | ----: |
| API | Done | Ana |
| Docs | Review | Kofi |

```bash
npm install forge@2.4
```

AsciiDoc

== Release 2.4

This release adds *dark mode*, fixes _two_ bugs and drops [.line-through]#IE11#. See the https://example.com/changelog[changelog] for details.

* Faster startup
* New `--watch` flag
** Works on Windows

. Update the package
. Restart the server

____
Back up your config first.
____

[cols="<,^,>",options="header"]
|===
|Area |Status |Owner
|API |Done |Ana
|Docs |Review |Kofi
|===

[source,bash]
----
npm install forge@2.4
----

Markdown to AsciiDoc cheat sheet

Markdown	AsciiDoc
`# Title`	`= Title`
`bold`	`bold`
`italic`	`_italic_`
`[text](url)`	`url[text]`
`- item`	`* item`
`1. item`	`. item`
```js	`[source,js] ----`
`table`	`\|=== … \|===`

Why teams switch to AsciiDoc

AsciiDoc adds features Markdown lacks for large documentation sets: includes, admonitions, cross-references and attributes. The Asciidoctor project, the reference implementation, also renders straight to PDF and EPUB. This converter handles the structural part; add AsciiDoc-only features afterwards.

Other formats

Markdown converts to: Confluence, Jira, Slack, LaTeX, BBCode, MediaWiki, reStructuredText, plus HTML, PDF, Word and Excel.

Questions people ask

Is AsciiDoc compatible with Markdown?

Asciidoctor understands a few Markdown forms (such as fenced code and # headings), but the syntax differs, so converting gives cleaner, idiomatic files.

What about table alignment?

Markdown column alignment is converted into the cols attribute (<, ^, >).

Markdown to AsciiDoc cheat sheet

Why teams switch to AsciiDoc

Other formats

Questions people ask

Related tools