Is pre-computed .qmd valid pandoc markdown? #11628

noamross · 2024-12-07T14:57:39Z

noamross
Dec 7, 2024

Description

Is .qmd format itself fully valid pandoc markdown syntax, such that you could expect everything in it to be represented in pandoc's AST? I think comment-style options in code cells, the limitations of inline code in YAML metadata, and the structure of shortcodes all together make the format fully parsable by pandoc.

I ask because I am implementing some pre-render stage processing scripts and thought that if they can be implemented as lua filters they will be more portable and possibly compatible with pre-render document hooks in the future.

I think @jjallaire mentioned this somewhere in an issue before but can't find it.

Answered by cscheid

Dec 9, 2024

Two bits of genuinely custom syntax in Quarto:

shortcodes, especially if you want substrings like -- or *hello* to not be converted to markdown. (For example, Pandoc will butcher {{< video https://youtube.com/this--are--not--en-dashes >}})

executable code cells. Pandoc 3 doesn't like the following syntax:

```{python}
print("Hello, world")
```

Look at this:

$ pandoc -f markdown -t native
```{python}
print("Hello, world")
```
^D
[ Para
    [ Code ( "" , [] , [] ) "{python} print(\"hello, world\")" ]
]
$ pandoc -f markdown -t native
```python
print("Hello, world")
```
^D
[ CodeBlock
    ( "" , [ "python" ] , [] ) "print(\"Hello, world\")"
]

View full answer

mcanouil · 2024-12-07T15:40:36Z

mcanouil
Dec 7, 2024
Collaborator

If you use only plain markdown and none of Quarto features such as Callouts, tablets, code cells evaluation, etc. then it should be as after all, Quarto uses Pandoc.

0 replies

noamross · 2024-12-07T16:13:27Z

noamross
Dec 7, 2024
Author

Yes, but I mean exactly those features. Callouts, for instance, are pandoc markdown native divs with a class and attributes, which quarto itself processes with lua filters. Code cells, by having options as comments rather than what were non-pandoc valid options in the code cell header in R Markdown, become valid pandoc markdown code blocks. I'm wondering if this is the case of all quarto features by design.

7 replies

mcanouil Dec 7, 2024
Collaborator

Callouts are custom AST nodes.

Quarto is a mixture of TypeScript and Lua. Some features come from the two types of scripts.

Since Quarto document are markdown and than most features are based on a valid Pandoc syntax, Pandoc should not complain but don't expect callouts, etc. to be processed as such by Pandoc.

pandoc --from markdown document.qmd --to ...

noamross Dec 7, 2024
Author

Yes, callouts won't be processed without quarto's filters, but they are valid parts of the AST and can be manipulated. My question hinges on the "most" part. If it's just "most", what quarto syntax is not in the pandoc AST or would fail to parse?

mcanouil Dec 7, 2024
Collaborator

I can't think of a syntax that would cause real trouble to Pandoc.
There are more chances that Pandoc will simply ignore the offending parts.

Here a concrete example:

---
title: "Quarto Playground"
---

This is a playground for Quarto.

{{< lipsum 1 >}}

![An image]({{< placeholder 600 400 >}}){#fig-placeholder}

::: {.callout-note}
## A Note

This is a note about @fig-placeholder
:::

quarto render index.qmd --to gfm # native will render as:

AST

Pandoc
  Meta
    { unMeta =
        fromList
          [ ( "title"
            , MetaInlines [ Str "Quarto" , Space , Str "Playground" ]
            )
          ]
    }
  [ Para
      [ Str "This"
      , Space
      , Str "is"
      , Space
      , Str "a"
      , Space
      , Str "playground"
      , Space
      , Str "for"
      , Space
      , Str "Quarto."
      ]
  , Para
      [ Str "Proin"
      , Space
      , Str "sodales"
      , Space
      , Str "neque"
      , Space
      , Str "erat,"
      , Space
      , Str "varius"
      , Space
      , Str "cursus"
      , Space
      , Str "diam"
      , Space
      , Str "tincidunt"
      , Space
      , Str "sit"
      , Space
      , Str "amet."
      , Space
      , Str "Etiam"
      , Space
      , Str "scelerisque"
      , Space
      , Str "fringilla"
      , Space
      , Str "nisl"
      , Space
      , Str "eu"
      , Space
      , Str "venenatis."
      , Space
      , Str "Donec"
      , Space
      , Str "sem"
      , Space
      , Str "ipsum,"
      , Space
      , Str "scelerisque"
      , Space
      , Str "ac"
      , Space
      , Str "venenatis"
      , Space
      , Str "quis,"
      , Space
      , Str "hendrerit"
      , Space
      , Str "vel"
      , Space
      , Str "mauris."
      , Space
      , Str "Praesent"
      , Space
      , Str "semper"
      , Space
      , Str "erat"
      , Space
      , Str "sit"
      , Space
      , Str "amet"
      , Space
      , Str "purus"
      , Space
      , Str "condimentum,"
      , Space
      , Str "sit"
      , Space
      , Str "amet"
      , Space
      , Str "auctor"
      , Space
      , Str "mi"
      , Space
      , Str "feugiat."
      , Space
      , Str "In"
      , Space
      , Str "hac"
      , Space
      , Str "habitasse"
      , Space
      , Str "platea"
      , Space
      , Str "dictumst."
      , Space
      , Str "Nunc"
      , Space
      , Str "ac"
      , Space
      , Str "mauris"
      , Space
      , Str "in"
      , Space
      , Str "massa"
      , Space
      , Str "feugiat"
      , Space
      , Str "bibendum"
      , Space
      , Str "id"
      , Space
      , Str "in"
      , Space
      , Str "dui."
      , Space
      , Str "Praesent"
      , Space
      , Str "accumsan"
      , Space
      , Str "urna"
      , Space
      , Str "at"
      , Space
      , Str "lacinia"
      , Space
      , Str "aliquet."
      , Space
      , Str "Proin"
      , Space
      , Str "ultricies"
      , Space
      , Str "eu"
      , Space
      , Str "est"
      , Space
      , Str "quis"
      , Space
      , Str "pellentesque."
      , Space
      , Str "In"
      , Space
      , Str "vel"
      , Space
      , Str "lorem"
      , Space
      , Str "at"
      , Space
      , Str "nisl"
      , Space
      , Str "rhoncus"
      , Space
      , Str "cursus"
      , Space
      , Str "eu"
      , Space
      , Str "quis"
      , Space
      , Str "mi."
      , Space
      , Str "In"
      , Space
      , Str "eu"
      , Space
      , Str "rutrum"
      , Space
      , Str "ante,"
      , Space
      , Str "quis"
      , Space
      , Str "placerat"
      , Space
      , Str "justo."
      , Space
      , Str "Etiam"
      , Space
      , Str "euismod"
      , Space
      , Str "nibh"
      , Space
      , Str "nibh,"
      , Space
      , Str "sed"
      , Space
      , Str "elementum"
      , Space
      , Str "nunc"
      , Space
      , Str "imperdiet"
      , Space
      , Str "in."
      , Space
      , Str "Praesent"
      , Space
      , Str "gravida"
      , Space
      , Str "nunc"
      , Space
      , Str "vel"
      , Space
      , Str "odio"
      , Space
      , Str "lacinia,"
      , Space
      , Str "at"
      , Space
      , Str "tempus"
      , Space
      , Str "nisl"
      , Space
      , Str "placerat."
      , Space
      , Str "Aenean"
      , Space
      , Str "id"
      , Space
      , Str "ipsum"
      , Space
      , Str "sed"
      , Space
      , Str "est"
      , Space
      , Str "sagittis"
      , Space
      , Str "hendrerit"
      , Space
      , Str "non"
      , Space
      , Str "in"
      , Space
      , Str "tortor."
      ]
  , Plain
      [ Image
          ( "" , [] , [] )
          []
          ( "data:image/png;base64,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"
          , ""
          )
      ]
  , Div
      ( "" , [] , [] )
      [ BlockQuote
          [ Para [ Strong [ Str "A" , Space , Str "Note" ] ]
          , Para
              [ Str "This"
              , Space
              , Str "is"
              , Space
              , Str "a"
              , Space
              , Str "note"
              , Space
              , Str "about"
              , Space
              , Link
                  ( "" , [ "quarto-xref" ] , [] )
                  [ Str "Figure" , Str "\160" , Str "1" ]
                  ( "#fig-placeholder" , "" )
              ]
          ]
      ]
  ]

Markdown / GFM

# Quarto Playground


This is a playground for Quarto.

Etiam congue quam eget velit convallis, eu sagittis orci vestibulum.
Vestibulum at massa turpis. Curabitur ornare ex sed purus vulputate,
vitae porta augue rhoncus. Phasellus auctor suscipit purus, vel
ultricies nunc. Nunc eleifend nulla ac purus volutpat, id fringilla
felis aliquet. Duis vitae porttitor nibh, in rhoncus risus. Vestibulum a
est vitae est tristique vehicula. Proin mollis justo id est tempus
hendrerit. Praesent suscipit placerat congue. Aliquam eu elit gravida,
consequat augue non, ultricies sapien. Nunc ultricies viverra ante, sit
amet vehicula ante volutpat id. Etiam tempus purus vitae tellus mollis
viverra. Donec at ornare mauris. Aliquam sodales hendrerit ornare.
Suspendisse accumsan lacinia sapien, sit amet imperdiet dui molestie ut.

<div id="fig-placeholder">

![](data:image/png;base64,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)

Figure 1: An image

</div>

> [!NOTE]
>
> ### A Note
>
> This is a note about
> <a href="#fig-placeholder" class="quarto-xref">Figure 1</a>

quarto pandoc --from markdown index.qmd --to gfm # native will render as:

AST

 Para
    [ Str "This"
    , Space
    , Str "is"
    , Space
    , Str "a"
    , Space
    , Str "playground"
    , Space
    , Str "for"
    , Space
    , Str "Quarto."
    ]
, Para
    [ Str "{{<"
    , Space
    , Str "lipsum"
    , Space
    , Str "1"
    , Space
    , Str ">}}"
    ]
, Figure
    ( "fig-placeholder" , [] , [] )
    (Caption
       Nothing [ Plain [ Str "An" , Space , Str "image" ] ])
    [ Plain
        [ Image
            ( "" , [] , [] )
            [ Str "An" , Space , Str "image" ]
            ( "%7B%7B%3C%20placeholder%20600%20400%20%3E%7D%7D" , "" )
        ]
    ]
, Div
    ( "" , [ "callout-note" ] , [] )
    [ Header
        2 ( "a-note" , [] , [] ) [ Str "A" , Space , Str "Note" ]
    , Para
        [ Str "This"
        , Space
        , Str "is"
        , Space
        , Str "a"
        , Space
        , Str "note"
        , Space
        , Str "about"
        , Space
        , Cite
            [ Citation
                { citationId = "fig-placeholder"
                , citationPrefix = []
                , citationSuffix = []
                , citationMode = AuthorInText
                , citationNoteNum = 1
                , citationHash = 0
                }
            ]
            [ Str "@fig-placeholder" ]
        ]
    ]
]

Markdown / GFM

This is a playground for Quarto.

{{\< lipsum 1 \>}}

<figure id="fig-placeholder">
<img src="%7B%7B%3C%20placeholder%20600%20400%20%3E%7D%7D"
alt="An image" />
<figcaption aria-hidden="true">An image</figcaption>
</figure>

<div class="callout-note">

## A Note

This is a note about @fig-placeholder

</div>

cscheid Dec 9, 2024
Maintainer

Two bits of genuinely custom syntax in Quarto:

shortcodes, especially if you want substrings like -- or *hello* to not be converted to markdown. (For example, Pandoc will butcher {{< video https://youtube.com/this--are--not--en-dashes >}})

executable code cells. Pandoc 3 doesn't like the following syntax:

```{python}
print("Hello, world")
```

Look at this:

$ pandoc -f markdown -t native
```{python}
print("Hello, world")
```
^D
[ Para
    [ Code ( "" , [] , [] ) "{python} print(\"hello, world\")" ]
]
$ pandoc -f markdown -t native
```python
print("Hello, world")
```
^D
[ CodeBlock
    ( "" , [ "python" ] , [] ) "print(\"Hello, world\")"
]

Answer selected by noamross

cscheid Dec 9, 2024
Maintainer

I'm quite confident (let's say ~90%) that we won't make any other syntax additions to Pandoc's markdown in at least 2-3 years.

With that said, we are considering changing the way YAML metadata is interpreted in a .qmd document. We would like to (again, in the next 2-3 years, so long-termish) have more predictable scoping for Quarto. Specifically, we would like to allow for metadata to be scoped, so that, for example:

---
title: Hello # this is document-wide
---

::: {}
---
echo: true # this only takes effect inside the fenced div
---

```{python}
print("this should echo")
```
:::

```{python}
print("this should not echo")
```

It's going to take a lot of work to implement something like this. Crucially, Pandoc merges all YAML metadata to the document top-level, independently of scope, and we have to work around it. With that said, we are already putting effort in a direction that enables this.

The plan is for div classes and attributes to have a more consistent lexical scoping interpretation throughout Quarto's processing.

noamross Dec 9, 2024
Author

Thanks both! I'm surprised at the code cells, I wonder if making a specific class executable (e.g., {.python-quarto}) would make sense.

Similarly, would using code blocks for YAML (e.g., use a {.metadata-yaml} block rather than fencing with ---) be a way to keep Pandoc from merging in the scoped metadata?

cscheid Dec 9, 2024
Maintainer

We are not going to break backwards compatibility with RMarkdown's syntax, and so we'll always need to support our own syntax instead.

Both .python-quarto and .metadata-yaml are too ugly for users to type on a regular basis, and the dot becomes misleading: these two blocks do something fundamentally different from regular "non-executable code blocks", and deserve a syntax of their own.

The way we'll solve this is to create a well-defined "Quarto surface syntax", from which we will emit well-defined Pandoc markdown (or, even more likely, Quarto will eventually call Pandoc with a pre-made AST through Pandoc's JSON or native input).

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Is pre-computed .qmd valid pandoc markdown? #11628

{{title}}

Replies: 2 comments 7 replies

{{title}}

{{title}}

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

{{title}}

{{title}}

{{title}}

Select a reply

Is pre-computed .qmd valid pandoc markdown? #11628

noamross Dec 7, 2024

Description

Replies: 2 comments · 7 replies

mcanouil Dec 7, 2024 Collaborator

noamross Dec 7, 2024 Author

mcanouil Dec 7, 2024 Collaborator

noamross Dec 7, 2024 Author

mcanouil Dec 7, 2024 Collaborator

cscheid Dec 9, 2024 Maintainer

cscheid Dec 9, 2024 Maintainer

noamross Dec 9, 2024 Author

cscheid Dec 9, 2024 Maintainer

noamross
Dec 7, 2024

Replies: 2 comments 7 replies

mcanouil
Dec 7, 2024
Collaborator

noamross
Dec 7, 2024
Author

mcanouil Dec 7, 2024
Collaborator

noamross Dec 7, 2024
Author

mcanouil Dec 7, 2024
Collaborator

cscheid Dec 9, 2024
Maintainer

cscheid Dec 9, 2024
Maintainer

noamross Dec 9, 2024
Author

cscheid Dec 9, 2024
Maintainer