3 ms·

At the risk of Dropboxing myself: what is the advantage of this over the existing Markdown syntax for footnotes[1]? It looks very similar, but with a harder to

At the risk of Dropboxing myself: what is the advantage of this over the existing Markdown syntax for footnotes[1]? It looks very similar, but with a harder to parse grammar. [1]: https://www.markdownguide.org/extended-syntax/ https://www.markdownguide.org/extended-syntax/

SPBS 4y ago
it looks like it aggregates all footnote definitions into one where it can be printed with the keyword 'notes' (hardcoding? too clever? what if you want to separate footnotes?)
- reagle 4y ago
  I can’t see what this offers over pandoc markdown or it’s successor: https://htmlpreview.github.io/?https://github.com/jgm/djot/blob/master/doc/syntax.html#footnote-reference https://htmlpreview.github.io/?https://github.com/jgm/djot/b...
  - pbronez 4y ago
    Shot is new to me, thanks for sharing. Looks like a nice iteration on CommonMark. I’ve preferred Asciidoc for its availability to handle complex nested headers and internal links; djot’s custom attributes and local-first link parsing might handle that well. https://djot.net https://djot.net
tux 4y ago
WOW I didn't even know markdown has footnotes will definantly come in handy for one of my projects. Thank you!
- bmacho 4y ago
  It doesn't have footnotes. Some supersets do.
  - woodruffw 4y ago
    Right, but it's worth noting that those supersets are very common. I'd say it's actually less common to run into a "barebones" Markdown implementation these days than to run into a GFM or close-to-GFM one.
    - deleted 4y ago
      [deleted]
    - deleted 4y ago
      [deleted]
  - teekert 4y ago
    Yes, for example in Hugo [0] I can do this: This is some text with a footnote.[^1] [^1]: And that's the footnote. [0] https://gohugo.io/ https://gohugo.io/
breck 4y ago
> At the risk of Dropboxing myself This made me laugh. I appreciate you. > but with a harder to parse grammar Grammar is actually quite simple once you've mastered the Grammar language (https://pldb.com/languages/grammar.html https://pldb.com/languages/grammar.html) which has almost no documentation and is full of bugs. > what is the advantage of this over the existing Markdown syntax for footnotes[1] I can't speak definitively yet. I think it will be better but I need to use it for a few months to be sure. There are some subtle things I think will be important.
- woodruffw 4y ago
  Thank you for sharing that! In case I came across as overly negative: I think the overall syntax and project here are very cool. I’ll be following your work!

SPBS 4y ago

it looks like it aggregates all footnote definitions into one where it can be printed with the keyword 'notes' (hardcoding? too clever? what if you want to separate footnotes?)

reagle 4y ago
I can’t see what this offers over pandoc markdown or it’s successor: https://htmlpreview.github.io/?https://github.com/jgm/djot/blob/master/doc/syntax.html#footnote-reference https://htmlpreview.github.io/?https://github.com/jgm/djot/b...
- pbronez 4y ago
  Shot is new to me, thanks for sharing. Looks like a nice iteration on CommonMark. I’ve preferred Asciidoc for its availability to handle complex nested headers and internal links; djot’s custom attributes and local-first link parsing might handle that well. https://djot.net https://djot.net

tux 4y ago

WOW I didn't even know markdown has footnotes will definantly come in handy for one of my projects. Thank you!

bmacho 4y ago
It doesn't have footnotes. Some supersets do.
- woodruffw 4y ago
  Right, but it's worth noting that those supersets are very common. I'd say it's actually less common to run into a "barebones" Markdown implementation these days than to run into a GFM or close-to-GFM one.
  - deleted 4y ago
    [deleted]
  - deleted 4y ago
    [deleted]
- teekert 4y ago
  Yes, for example in Hugo [0] I can do this: This is some text with a footnote.[^1] [^1]: And that's the footnote. [0] https://gohugo.io/ https://gohugo.io/

breck 4y ago

> At the risk of Dropboxing myself This made me laugh. I appreciate you. > but with a harder to parse grammar Grammar is actually quite simple once you've mastered the Grammar language (https://pldb.com/languages/grammar.html https://pldb.com/languages/grammar.html) which has almost no documentation and is full of bugs. > what is the advantage of this over the existing Markdown syntax for footnotes[1] I can't speak definitively yet. I think it will be better but I need to use it for a few months to be sure. There are some subtle things I think will be important.

woodruffw 4y ago
Thank you for sharing that! In case I came across as overly negative: I think the overall syntax and project here are very cool. I’ll be following your work!