# Support for AsciiDoc format to write posts

**URL:** https://meta.discourse.org/t/support-for-asciidoc-format-to-write-posts/262807
**Category:** Feature
**Created:** [April 25, 2023, 11:00am UTC](https://meta.discourse.org/t/support-for-asciidoc-format-to-write-posts/262807 "2023-04-25T11:00:55Z")
**Posts on this page:** 6
**Page:** 1

<div class="post-metadata">

### Author: ![Stephen\_Ma](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/stephen_ma/32/301713_2.png) [@Stephen\_Ma](https://meta.discourse.org/u/Stephen_Ma)
#### Post date: [April 25, 2023, 11:00am UTC](https://meta.discourse.org/t/support-for-asciidoc-format-to-write-posts/262807/1 "2023-04-25T11:00:55Z")

</div>

Is there anyway to allow write posts in AsciiDoc format?

[AsciiDoc](https://docs.asciidoctor.org/asciidoc/latest/) is lightweight markup language similiar to Markdown. We use AsciiDoc for writing and use [Antora](https://docs.antora.org/antora/latest/) to render Documentation Site. Meantime, we are using Discourse as our community.

The community and the Documentation Site may share some common information/knowledge. There are needs to migrate some documentation contents to community.

---

<div class="post-metadata">

### Author: ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [April 25, 2023, 1:24pm UTC](https://meta.discourse.org/t/support-for-asciidoc-format-to-write-posts/262807/2 "2023-04-25T13:24:07Z")

</div>

Welcome, Stephen 🙂

There is currently no way to write post in AsciiDoc format.  
I believe it would require a plugin, and I suspect it would be hard to implement if it conflicts with the regular use of Markdown-it that Discourse uses. I’m not a developer though.

> [@Stephen\_Ma](#):
>
> The community and the Documentation Site may share some common information/knowledge. There are needs to migrate some documentation contents to community.

Can you elaborate on what you mean by this? I’m not sure I understand it.

---

<div class="post-metadata">

### Author: ![sam](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sam/32/102149_2.png) [@sam](https://meta.discourse.org/u/sam)
#### Post date: [April 26, 2023, 6:43am UTC](https://meta.discourse.org/t/support-for-asciidoc-format-to-write-posts/262807/3 "2023-04-26T06:43:29Z")

</div>

> [@Canapin](#):
>
> I believe it would require a plugin, and I suspect it would be hard to implement if it conflicts with the regular use of Markdown-it that Discourse uses. I’m not a developer though.

As long as it was implemented in islands, building a plugin to do so would not be too hard. I would estimate building it at a week of work more or less eg:

````plaintext
```asciidoc
YOUR ASCIIDOC HERE
```

````

Antora integration and publishing would add a fair bit of complexity and may push this into multiple weeks of work.

---

<div class="post-metadata">

### Author: ![mattdm](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/mattdm/32/216484_2.png) [@mattdm](https://meta.discourse.org/u/mattdm)
#### Post date: [April 28, 2023, 1:13am UTC](https://meta.discourse.org/t/support-for-asciidoc-format-to-write-posts/262807/4 "2023-04-28T01:13:48Z")

</div>

Ooh. We use Antora too. This would be neat!

---

<div class="post-metadata">

### Author: ![Stephen\_Ma](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/stephen_ma/32/301713_2.png) [@Stephen\_Ma](https://meta.discourse.org/u/Stephen_Ma)
#### Post date: [August 26, 2023, 8:08am UTC](https://meta.discourse.org/t/support-for-asciidoc-format-to-write-posts/262807/5 "2023-08-26T08:08:09Z")

</div>

Yes. A plugin would be nice. Since our posts may need a lot of tables, which is Markdown not good at. Also, some posts may need to be translated to other language, after translation, the format is a mess.

Glad to know it is not hard to develop such a plugin. Could you help share some instuctions or a tutorial for developing it? Then I can ask our engineers to develop it.

---

<div class="post-metadata">

### Author: ![sam](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/sam/32/102149_2.png) [@sam](https://meta.discourse.org/u/sam)
#### Post date: [August 26, 2023, 8:10am UTC](https://meta.discourse.org/t/support-for-asciidoc-format-to-write-posts/262807/6 "2023-08-26T08:10:21Z")

</div>

Have you seen the svgbob component?
