Markdown's Big Brother: Say Hello to AsciiDoc

#1

Post by pointnova » Thu, Feb 06, 2025, 8:18 AM UTC

Markdown's Big Brother: Say Hello to AsciiDoc
git-tower.com

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#2

Post by keyle » Thu, Feb 06, 2025, 9:19 AM UTC

Congratulations, you've reinvented HTML 1.0! With if/else you're almost at DHTML.

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#3

Post by ognyankulev » Thu, Feb 06, 2025, 9:23 AM UTC

I was hoping Eclipse AsciiDoc would already deliver stable spec, TCK and (new) reference implementation: https://asciidoc-wg.eclipse.org/projects/

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#4

Post by meta-level » Thu, Feb 06, 2025, 9:23 AM UTC

keyle wrote: post #2

Congratulations, you've reinvented HTML 1.0! With if/else you're almost at DHTML.

What exactly is your comment about? Have you heard about asciidoc before?

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#5

Post by dqv » Thu, Feb 06, 2025, 9:24 AM UTC

Any Markdown implementation which allows for custom directives and is CommonMark-compliant is good enough for me.

MyST, for example, lets you do

    :::{makeup-highlight}
    :lang: elixir
    defmodule A do
      def b, do: :ok
    end
    :::

    :::{pygments-highlight}
    :lang: python
    class B:
        pass
    :::

Since MyST has intermediaries that just give you an AST, you have a lot more extensibility using directives and roles to do special things (including includes). You can of course just use MyST proper, but getting to transform the AST myself how I see fit is a big win in my eyes. Pandoc does have AST and all that too, but MyST's implementation strikes the best balance for me.

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#6

Post by [deleted] » Thu, Feb 06, 2025, 9:29 AM UTC

[deleted]

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#7

Post by stragies » Thu, Feb 06, 2025, 9:37 AM UTC

Is there anybody here, who migrated to AsciiDoc from ORG-Mode, and could detail the reasons?

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#8

Post by Tomte » Thu, Feb 06, 2025, 9:38 AM UTC

meta-level wrote: post #4

keyle wrote: post #2

Congratulations, you've reinvented HTML 1.0! With if/else you're almost at DHTML.

What exactly is your comment about? Have you heard about asciidoc before?

AsciiDoc is even older than Markdown.

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#9

Post by sausagefeet » Thu, Feb 06, 2025, 9:56 AM UTC

I've been using AsciiDoc since Oxide did a podcast on their RFDs and I love it. I find it so much saner than Markdown, and it covers more usecases. I wish there were more implementations but asciidoctor works great. Hugo also supports AsciiDoc.

Re: Markdown's Big Brother: Say Hello to AsciiDoc

#10

Post by Y-bar » Thu, Feb 06, 2025, 9:57 AM UTC

Sorry, I know this sounds like a stupid question… But I search the linked quick guide as well as the features page, but does this only support ASCII and not UTF characters?