MANUAL.txt: `gfm` and `markdown_github` (GitHub-Flavored Markdown)

MANUAL.txt: `gfm` and `markdown_github` (GitHub-Flavored Markdown)

[Kolen Cheung]

[-- Attachment #1.1: Type: text/plain, Size: 1399 bytes --]



Currently, in the MANUAL.txt line 3816 
<https://github.com/jgm/pandoc/blob/3f0ceaf6eef73500935b044e00aff0747569810e/MANUAL.txt#L3816>, 
it mentions that both gfm and markdown_github are equivalent to a bunch of 
pandoc markdown extensions. But as far as I understand, gfm is a very 
different beast, and should not be understood as a bunch of pandoc markdown 
extensions activated, right?

I didn’t make a pull request on this however, because I think more expanded 
description on the gfm variant is needed. For example, I guess it is 
impossible to add extension to gfm, unlike other variants (where the 
MANUAL.txt has mentioned this briefly at line 284). And for example I would 
have a question on how extra gfm extension that pandoc doesn’t have will be 
handled, e.g. the gfm checkbox.
​

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/01068d42-c013-4d0d-8439-92202707d485%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 9410 bytes --]

Re: MANUAL.txt: `gfm` and `markdown_github` (GitHub-Flavored Markdown)

[John MACFARLANE]

This could probably use more clarification in the manual.

gfm is implemented as some extensions on top of commonmark.

We should note, however, that you can't use arbitrary pandoc
extensions on top of commonmark; the commonmark parser and
writer only support a limited subset of extensions
(basically, the ones that define gfm, plus smart).

+++ Kolen Cheung [Oct 27 17 01:16 ]:
>   Currently, in the [1]MANUAL.txt line 3816, it mentions that both gfm
>   and markdown_github are equivalent to a bunch of pandoc markdown
>   extensions. But as far as I understand, gfm is a very different beast,
>   and should not be understood as a bunch of pandoc markdown extensions
>   activated, right?
>
>   I didn’t make a pull request on this however, because I think more
>   expanded description on the gfm variant is needed. For example, I guess
>   it is impossible to add extension to gfm, unlike other variants (where
>   the MANUAL.txt has mentioned this briefly at line 284). And for example
>   I would have a question on how extra gfm extension that pandoc doesn’t
>   have will be handled, e.g. the gfm checkbox.
>   ​
>
>   --
>   You received this message because you are subscribed to the Google
>   Groups "pandoc-discuss" group.
>   To unsubscribe from this group and stop receiving emails from it, send
>   an email to [2]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>   To post to this group, send email to
>   [3]pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>   To view this discussion on the web visit
>   [4]https://groups.google.com/d/msgid/pandoc-discuss/01068d42-c013-4d0d-
>   8439-92202707d485%40googlegroups.com.
>   For more options, visit [5]https://groups.google.com/d/optout.
>
>References
>
>   1. https://github.com/jgm/pandoc/blob/3f0ceaf6eef73500935b044e00aff0747569810e/MANUAL.txt#L3816
>   2. mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
>   3. mailto:pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
>   4. https://groups.google.com/d/msgid/pandoc-discuss/01068d42-c013-4d0d-8439-92202707d485-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org?utm_medium=email&utm_source=footer
>   5. https://groups.google.com/d/optout

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/20171027181341.GD63405%40protagoras.
For more options, visit https://groups.google.com/d/optout.

Re: MANUAL.txt: `gfm` and `markdown_github` (GitHub-Flavored Markdown)

[John MACFARLANE]

Thanks, I made some improvements here in d039f231cb.

+++ Kolen Cheung [Oct 27 17 01:16 ]:
>   Currently, in the [1]MANUAL.txt line 3816, it mentions that both gfm
>   and markdown_github are equivalent to a bunch of pandoc markdown
>   extensions. But as far as I understand, gfm is a very different beast,
>   and should not be understood as a bunch of pandoc markdown extensions
>   activated, right?
>
>   I didn’t make a pull request on this however, because I think more
>   expanded description on the gfm variant is needed. For example, I guess
>   it is impossible to add extension to gfm, unlike other variants (where
>   the MANUAL.txt has mentioned this briefly at line 284). And for example
>   I would have a question on how extra gfm extension that pandoc doesn’t
>   have will be handled, e.g. the gfm checkbox.
>   ​
>
>   --
>   You received this message because you are subscribed to the Google
>   Groups "pandoc-discuss" group.
>   To unsubscribe from this group and stop receiving emails from it, send
>   an email to [2]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>   To post to this group, send email to
>   [3]pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>   To view this discussion on the web visit
>   [4]https://groups.google.com/d/msgid/pandoc-discuss/01068d42-c013-4d0d-
>   8439-92202707d485%40googlegroups.com.
>   For more options, visit [5]https://groups.google.com/d/optout.
>
>References
>
>   1. https://github.com/jgm/pandoc/blob/3f0ceaf6eef73500935b044e00aff0747569810e/MANUAL.txt#L3816
>   2. mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
>   3. mailto:pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
>   4. https://groups.google.com/d/msgid/pandoc-discuss/01068d42-c013-4d0d-8439-92202707d485-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org?utm_medium=email&utm_source=footer
>   5. https://groups.google.com/d/optout

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/20171027232440.GB82754%40protagoras.
For more options, visit https://groups.google.com/d/optout.