~stick/stma.is

b541df0b8a9f1d12f7e43194b3c00199ebf3ee93 — Stick 5 months ago 889d61d master
post 2020-04-10-markdown-not-asciidoc
1 files changed, 32 insertions(+), 0 deletions(-)

A content/stick/2020-05-21-markdown-not-asciidoc.md
A content/stick/2020-05-21-markdown-not-asciidoc.md => content/stick/2020-05-21-markdown-not-asciidoc.md +32 -0
@@ 0,0 1,32 @@
---
title: "Markdown, not AsciiDoc"
tags: ["software"]
---

So yeah, I had this drafted weeks and weeks ago and I kept thinking I would rewrite it to not be just bullet points.
I decided the bullet points work fine.
See the title for my conclusion (after working really hard to like AsciiDoc...).

## AsciiDoc Advantages

- Comments.
- No need for HTML in markup document.
- Video iframes already [parented](https://blog.theodo.com/2018/01/responsive-iframes-css-trick/).
- Add arbitrary classes to arbitrary elements.
- Citations are `<cite>`

## AsciiDoc Disadvantages

- (Currently) only supported externally in Hugo.
  - AsciiDoc document header attributes/metadata (front matter) not supported in Hugo.
  - Chroma not set up to highlight from AsciiDoc.
- Not supported in [GitHub pages](https://pages.github.com/versions/).
- Not supported for README on [SourceHut](https://todo.sr.ht/~sircmpwn/git.sr.ht/264).
- More verbose around code blocks (linenums?).
- `code` elements space differently with and without `linenums`.
- Requires extra characters for curly quotes.
- I prefer Markdown tables to AsciiDoc tables for writing and plain text reading.
- Limited tooling
  - Vim support limited to [syntax](https://github.com/asciidoc/vim-asciidoc)
  - No automatic formatter (at least in [ALE](https://github.com/dense-analysis/ale)
  - Various plugins available: [vim-ft-asciidoc](https://github.com/jjaderberg/vim-ft-asciidoc), [vim-asciidoctor](https://github.com/habamax/vim-asciidoctor), [vim-asciidoc](https://github.com/dahu/vim-asciidoc); none "`feature-complete`"