I do like markdown for its simplicity as well, but mostly for something basic. Anything slightly more complex - asciidoc is way better but it's still mostly for authoring.
all in all - use the tools for what they were intended :)
all in all - use the tools for what they were intended :)
October 15, 2025 at 7:25 PM
Everybody can reply
Sadly I'm losing faith in AsciiDoc. I love it, but it seems it has stalled a bit. I wish GitHub would have not abandoned their 10 years old bugs about it. Good templates and end user tooling is not as good as with markdown. Sad to say this, and I might be wrong, I hope I am. #opensource #asciidoc
October 11, 2025 at 2:03 AM
Everybody can reply
1 likes
Trying out #RevealJS with #Asciidoc and liking it a lot so far.
Some good resources/examples I've used:
8vi.cat/build-beauti...
zenika.github.io/adoc-present...
github.com/martsec/asci...
marketplace.visualstudio.com/items?itemNa...
Some good resources/examples I've used:
8vi.cat/build-beauti...
zenika.github.io/adoc-present...
github.com/martsec/asci...
marketplace.visualstudio.com/items?itemNa...
If I'm not using Keynote (which I probably will tho), what are my text-based slidewriting options these days? Ideally something asciidoc based, but can live with Markdown. It needs to not look like crap when presenting, too…
October 10, 2025 at 7:11 AM
Everybody can reply
1 likes
1 saves
Yeah, it's because of serde that I'm thinking that the visitor pattern might be a good one to use for my AsciiDoc converters in github.com/nlopes/acdc
GitHub - nlopes/acdc: AsciiDoc tooling in rust
AsciiDoc tooling in rust. Contribute to nlopes/acdc development by creating an account on GitHub.
github.com
October 9, 2025 at 9:35 PM
Everybody can reply
1 likes
If I'm not using Keynote (which I probably will tho), what are my text-based slidewriting options these days? Ideally something asciidoc based, but can live with Markdown. It needs to not look like crap when presenting, too…
October 8, 2025 at 3:00 PM
Everybody can reply
1 quotes
1 likes
1 saves
Fala @ramalho.org vc usa algum linter para Asciidoc? tipo vale
October 5, 2025 at 6:06 PM
Everybody can reply
1 likes
Quando a gente faz o que gosta é normal trabalhar alguns sábados.
Foto: monitor vertical com PDF do Python Fluente 2e, volume 2, monitor horizontal com código Asciidoc, páginas impressas do capítulo 9 com marcações em vermelho.
Para revisar, nada melhor que texto impresso e caneta vermelha!
Foto: monitor vertical com PDF do Python Fluente 2e, volume 2, monitor horizontal com código Asciidoc, páginas impressas do capítulo 9 com marcações em vermelho.
Para revisar, nada melhor que texto impresso e caneta vermelha!
October 4, 2025 at 11:37 PM
Everybody can reply
2 reposts
36 likes
Yessss I love AsciiDoc, everyone should use it! It renders natively on GitHub too, by using the .adoc file suffix, so you can even use it for your readmes and the like
October 2, 2025 at 6:42 AM
Everybody can reply
1 reposts
1 likes
Seriously. Asciidoc is probably a good fit. I’ve done docbook and it’s…a lot. But it’s very cool too.
The thing that sparked all this is I keep running into everyone making these incompatible markdown preprocessors and MDX. The need is there. But it’s all nonstandard when other options exist.
The thing that sparked all this is I keep running into everyone making these incompatible markdown preprocessors and MDX. The need is there. But it’s all nonstandard when other options exist.
October 1, 2025 at 9:22 PM
Everybody can reply
As someone who has used both Markdown and AsciiDoc, I would definitely pick AsciiDoc for tech docs.
Markdown is a lower threshold to be an effective author, but AsciiDoc has niceties that just aren't available in Markdown.
Brian mentions a few, but one that I miss is automatic references.
Markdown is a lower threshold to be an effective author, but AsciiDoc has niceties that just aren't available in Markdown.
Brian mentions a few, but one that I miss is automatic references.
Yesterday I published Issue 45 of my monthly newsletter, and it's about why Markdown might not be the best way to implement content.
Read it and subscribe to be the first to read next month's issue.
https://newsletter.bphogan.com/archive/issue-45-markdown-is-holding-you-back/
Read it and subscribe to be the first to read next month's issue.
https://newsletter.bphogan.com/archive/issue-45-markdown-is-holding-you-back/
October 1, 2025 at 9:15 PM
Everybody can reply
1 likes
A verdade é que a gente tem que controlar o TOC e relaxar porque o comprimento das linhas no markdown, html, asciidoc, latex NÃO IMPORTA!
Então, uma vez que fez hard-wrap, desencana de manter as linhas do mesmo tamanho.
No semantic linebreak vão ficar tamanhos muito diferentes, e TUDO BEM!
Então, uma vez que fez hard-wrap, desencana de manter as linhas do mesmo tamanho.
No semantic linebreak vão ficar tamanhos muito diferentes, e TUDO BEM!
September 28, 2025 at 10:19 PM
Everybody can reply
1 likes
O soft-wrap padrão em editores de código é uma armadilha para quem escreve documentos longos em markdown, asciidoc, etc. A gente escreve um parágrafo de 7 linhas em uma única linha física com mais de 500 caracteres de largura. Isso inutiliza os diffs, tornando a revisão bem difícil.
A solução...
A solução...
September 28, 2025 at 5:00 PM
Everybody can reply
10 likes
2 saves
Amazing example of #Asciidoc for slide generation
Power Catch-up: Everything Practical and Important in Java 9 to 13
bentolor.github.io
September 26, 2025 at 4:07 PM
Everybody can reply
1 reposts
1 quotes
4 likes
1 saves
September 26, 2025 at 2:32 PM
Everybody can reply
@bcantrill.bsky.social I love hearing Oxide employees raving about Asciidoc, because I also love it. But this issue:
github.com/asciidoctor/...
has been open for 11 years, and I lose my mind every time I think about it. I wonder if asciidocr would consider going rogue on this one point.
github.com/asciidoctor/...
has been open for 11 years, and I lose my mind every time I think about it. I wonder if asciidocr would consider going rogue on this one point.
Add support for en dash · Issue #1174 · asciidoctor/asciidoctor
Per http://asciidoctor.org/docs/asciidoc-writers-guide/, I see that asciidoctor replaces -- with an em dash (—). Has similar support for en dashes (–) been considered, perhaps whereby foo--bar woul...
github.com
September 26, 2025 at 8:44 AM
Everybody can reply
asciidoctor/asciidoctor.js: :scroll: A JavaScript port of Asciidoctor, a modern implementation of AsciiDoc github.com/asciidoctor/...
AsciiDoc ってどれくらい普及してるんだろう。便利そうではあるけれど
AsciiDoc ってどれくらい普及してるんだろう。便利そうではあるけれど
github.com
September 23, 2025 at 10:45 PM
Everybody can reply
The real mismatch I've found is that Asciidoc expects you to be writing the entire document in it, but what people mostly end up writing in markdown are fragments of a page 😞
But yeah, Asciidoc is so much nicer and feels more thought-through
But yeah, Asciidoc is so much nicer and feels more thought-through
September 20, 2025 at 7:13 PM
Everybody can reply
I wish Asciidoc(tor) footnotes were implemented better, support for outputting multiple pages was better, that Asciidoctor wasn't the elephant in the room and non-standard, and that editors actually existed, tho
September 20, 2025 at 7:09 PM
Everybody can reply
passei um tempo avaliando formatos para escrever textos técnicos e acabei escolhendo AsciiDoc, mas reST (restructured text) também me pareceu bem completo.
September 20, 2025 at 5:32 PM
Everybody can reply
1 reposts
5 likes
Nah, asciidoc supports ``` too.
They tried to make it easier for people to switch.
You can use the more verbose format to highlight lines and such though.
They tried to make it easier for people to switch.
You can use the more verbose format to highlight lines and such though.
September 20, 2025 at 3:48 PM
Everybody can reply
1 likes
Nah
Default for code blocks is
[source, language]
---
Code
---
Or not?
And markdown is just three back ticks that I apparently don't know how to do on my phone 🙈
Don't get me wrong, I like asciidoc a lot. We wrote the whole book in asciidoc.
Just saying I understand why markdown for small stuff
Default for code blocks is
[source, language]
---
Code
---
Or not?
And markdown is just three back ticks that I apparently don't know how to do on my phone 🙈
Don't get me wrong, I like asciidoc a lot. We wrote the whole book in asciidoc.
Just saying I understand why markdown for small stuff
September 20, 2025 at 3:45 PM
Everybody can reply
1 likes
The same markdown to do that is equivalent in asciidoc but when you need more, it's available
September 20, 2025 at 3:31 PM
Everybody can reply
1 likes
I mean asciidoc gives you a lot more options and flexibility but like for small things I'm all good with markdown.
Let's say I need a GitHub readme. What more do I need than two styles of headings, code block and bullet list
Let's say I need a GitHub readme. What more do I need than two styles of headings, code block and bullet list
September 20, 2025 at 2:54 PM
Everybody can reply
1 likes
I really wish more people would use asciidoc.
Markdown was a huge mistake
Markdown was a huge mistake
September 20, 2025 at 12:36 PM
Everybody can reply
2 reposts
4 likes
AsciiDoc or reStructuredText?
September 20, 2025 at 11:34 AM
Everybody can reply