search

DataONEorg / object-formats

DataONE Object Formats controlled vocabulary
Apache License 2.0
1 stars 3 forks source link

rationale behind R Markdown file (pandoc markdown compatible) #18

Closed twhiteaker closed 2 years ago

twhiteaker commented 3 years ago

The only entry for R Markdown says: R Markdown file (pandoc markdown compatible)

Why is pandoc mentioned? If there are flavors of R Markdown that aren't pandoc compatible, then why isn't there an entry for vanilla R Markdown? If all R Markdown files are pandoc compatible, then why not just remove the pandoc part?

mbjones commented 3 years ago

@csjx @jclark do either of you know why it was listed as 'pandoc markdown compatible'?

mbjones commented 3 years ago

ping @csjx @jeanetteclark again on this RMarkdown format question...

csjx commented 3 years ago

Hmm, good point. I'm not sure why that is. @jeanetteclark do you recall?

mbjones commented 3 years ago

My personal take on this is that there is only 1 RMarkdown syntax, and it supports various formatting directives that vary based on the processor used to convert the markdown. So, there isn't really a 'pandoc compatible' markdown, as much as markup features in markdown and RMarkdown that require certain markdown processors and flags (like citation support in pandoc, but there are many other examples like GFM, tables, and others). So, I think this should just be "R Markdown".

mbjones commented 2 years ago

Chnaged the markdown names as discussed. Remaining metadata like formatId are the same.