Is there an official syntax for specifying markdown extensions in a YAML block?

Is there an official syntax for specifying markdown extensions in a YAML block?

[Brian Danielak]

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

I asked this question on 
StackOverflow: http://stackoverflow.com/questions/32492145/how-can-i-specify-pandocs-markdown-extensions-using-a-yaml-block

Someone answered <http://stackoverflow.com/a/32492257/180626> with a way to 
specify those options using RMarkdown 
it: http://rmarkdown.rstudio.com/pdf_document_format.html#markdown-extensions

But, I couldn't find that particular technique documented anywhere on the 
current Pandoc User's Guide <http://pandoc.org/README.html>, so:

   1. Is the above solution an officially-supported way to specify markdown 
   extensions in a YAML block?
   2. If so, why did I have such a hard time finding it in the Pandoc 
   User's Guide? Did I miss it?
   3. If it's not currently in the Pandoc User's guide, should it be? (My 
   opinion is yes, but I don't know that I'm representative of a common use 
   case.)
   4. If this mechanism should be documented in the Pandoc User's Guide, is 
   there a way I can help?

- B

-- 
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/ef28e782-4328-4018-aec8-c6fc2719fb19%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

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

Re: Is there an official syntax for specifying markdown extensions in a YAML block?

[Ivan Lazar Miljenovic]

On 14 September 2015 at 08:25, Brian Danielak <brian.danielak-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
> I asked this question on StackOverflow:
> http://stackoverflow.com/questions/32492145/how-can-i-specify-pandocs-markdown-extensions-using-a-yaml-block
>
> Someone answered with a way to specify those options using RMarkdown it:
> http://rmarkdown.rstudio.com/pdf_document_format.html#markdown-extensions
>
> But, I couldn't find that particular technique documented anywhere on the
> current Pandoc User's Guide, so:
>
> Is the above solution an officially-supported way to specify markdown
> extensions in a YAML block?
> If so, why did I have such a hard time finding it in the Pandoc User's
> Guide? Did I miss it?
> If it's not currently in the Pandoc User's guide, should it be? (My opinion
> is yes, but I don't know that I'm representative of a common use case.)
> If this mechanism should be documented in the Pandoc User's Guide, is there
> a way I can help?

It's not entirely clear, but yes, you can store variables in YAML
metadata.  The closest to an explanation/example I could find in the
User's Guide is here;
http://pandoc.org/README.html#extension-yaml_metadata_block

For example, I tweak the settings I use with reveal.js at the bottom
of my markdown file here (note that I used a slightly tweaked
template): https://raw.githubusercontent.com/ivan-m/CanFP-Parsing/master/Slides.md

>
> - B
>
> --
> 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/ef28e782-4328-4018-aec8-c6fc2719fb19%40googlegroups.com.
> For more options, visit https://groups.google.com/d/optout.



-- 
Ivan Lazar Miljenovic
Ivan.Miljenovic-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org
http://IvanMiljenovic.wordpress.com

Re: Is there an official syntax for specifying markdown extensions in a YAML block?

[John MacFarlane]

No, YAML blocks only affect metadata.  They don't affect
the input format, which currently must be specified on the
command line.

+++ Brian Danielak [Sep 13 15 15:25 ]:
>   I asked this question on
>   StackOverflow: http://stackoverflow.com/questions/32492145/how-can-i-sp
>   ecify-pandocs-markdown-extensions-using-a-yaml-block
>   [1]Someone answered with a way to specify those options using RMarkdown
>   it: http://rmarkdown.rstudio.com/pdf_document_format.html#markdown-exte
>   nsions
>   But, I couldn't find that particular technique documented anywhere on
>   the current [2]Pandoc User's Guide, so:
>    1. Is the above solution an officially-supported way to specify
>       markdown extensions in a YAML block?
>    2. If so, why did I have such a hard time finding it in the Pandoc
>       User's Guide? Did I miss it?
>    3. If it's not currently in the Pandoc User's guide, should it be? (My
>       opinion is yes, but I don't know that I'm representative of a
>       common use case.)
>    4. If this mechanism should be documented in the Pandoc User's Guide,
>       is there a way I can help?
>
>   - B
>
>   --
>   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 [3]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>   To post to this group, send email to
>   [4]pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>   To view this discussion on the web visit
>   [5]https://groups.google.com/d/msgid/pandoc-discuss/ef28e782-4328-4018-
>   aec8-c6fc2719fb19%40googlegroups.com.
>   For more options, visit [6]https://groups.google.com/d/optout.
>
>References
>
>   1. http://stackoverflow.com/a/32492257/180626
>   2. http://pandoc.org/README.html
>   3. mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
>   4. mailto:pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
>   5. https://groups.google.com/d/msgid/pandoc-discuss/ef28e782-4328-4018-aec8-c6fc2719fb19-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org?utm_medium=email&utm_source=footer
>   6. https://groups.google.com/d/optout