Is there a way to disable the pandoc smart extension for HTML output?

[rsalmond]

Description

I understand from previous discussions #10511 that the conversion of vertical quotation marks to curly quotation marks is handled by the pandoc smart extension, but I haven't found a way to disable that behaviour. I see in this discussion that it may have something to do with a variant but I was unable to determine from the docs I found about variants how to achieve the results I want.

format:
  html:
    variant: -smart

This produces unexpected results: eg. empty listing page, loss of header navigation elements and search on individual pages.

Is there a way to either disable the quotation conversion or disable the smart plugin while retaining the other style elements?

Thanks!
-Rob

[mcanouil]

Here is what you did is actually disabling: https://pandoc.org/chunkedhtml-demo/7.1-typography.html

This produces unexpected results: eg. empty listing page, loss of header navigation elements and search on individual pages.

Is there a way to either disable the quotation conversion or disable the smart plugin while retaining the other style elements?

Unfortunately without any small reproducible example there is no way for us to help you more.

Could you share a small self-contained "working" (reproducible) example to work with, i.e., a complete Quarto document or a Git repository? The goal is to make it as easy as possible for us to recreate your problem so that we can fix it: please help us help you! Thanks.

---

You can share a self-contained "working" (reproducible) Quarto document using the following syntax, i.e., using more backticks than you have in your document (usually four ````).
See https://quarto.org/bug-reports.html#small-is-beautiful-aim-for-a-single-document-with-10-lines.

If you have multiple files (and if it is absolutely required to have multiple files), please share as a Git repository.

R	Python
````qmd --- title: "Reproducible Quarto Document" format: html engine: knitr --- This is a reproducible Quarto document. {{< lipsum 1 >}} ```{r} x <- c(1, 2, 3, 4, 5) y <- c(1, 4, 9, 16, 25) plot(x, y) ``` {#fig-placeholder} {{< lipsum 1 >}} The end after @fig-placeholder. ````	````qmd --- title: "Reproducible Quarto Document" format: html engine: jupyter --- This is a reproducible Quarto document. {{< lipsum 1 >}} ```{python} import matplotlib.pyplot as plt x = [1, 2, 3, 4, 5] y = [1, 4, 9, 16, 25] plt.plot(x, y) plt.show() ``` {#fig-placeholder} {{< lipsum 1 >}} The end after @fig-placeholder. ````

Additionally and if not already given, please share the output of quarto check within a code block (i.e., using three backticks ```txt), see https://quarto.org/bug-reports.html#check.

[mcanouil]

I just recall, but variant applies to output.
You want smart to not be applied to the input, so you need from.

Note that these comes directly from Pandoc.

Input	Output
--- format: html --- # "Quarto"
--- format: html from: markdown-smart --- # "Quarto"

[rsalmond]

Thanks @mcanouil that is exactly what was needed!

When you say "it comes directly from Pandoc" does that mean that there's somewhere in the Pandoc documentation I could have found this information? Or to put it another way, that it doesn't belong in the Quarto docs? If I'm wrong about that I would be happy to contribute a docs PR to help folks find their way to this feature.

[mcanouil]

Quarto already copied a lot of Pandoc documentation, but it's quite extensive so Quarto cannot duplicate it all.

Here you are in an "advanced" setup which most users won't even need, so in those cases the answer could be in Pandoc documentation: https://pandoc.org/MANUAL.html

Reminder of the "workflow" from the "Get Started" page:

Jupyter	knitr

[rsalmond]

Or perhaps to state my intention more clearly, is there a way I can help make this information more accessible to help avoid further questions about how it works?

[mcanouil]

about Pandoc extensions?

[rsalmond]

While we're talking about it, it appears this solution does not apply to the title of the page.

$ cat index.qmd
---
title: This title contains "quotation marks"
from: markdown-smart
---

"This is a Quarto website."

To learn more about Quarto websites visit <https://quarto.org/docs/websites>.

$ cat _quarto.qmd

project:
  type: website

website:
  title: "."
  navbar:
    left:
      - href: index.qmd
        text: Home
      - about.qmd

format:
  html:
    from: markdown-smart
    theme: cosmo
    css: styles.css
    toc: true

[mcanouil]

Indeed, I noticed ... likely because it needs to be processed by Quarto first for the website layout.

• See pandoc: option to ignore curly quotes jgm/pandoc#7225

You can escape the quotes it seems.

[rsalmond]

Ah beautiful, this works! Thanks again @mcanouil <3

---
title: This title contains \"quotation marks\"
from: markdown-smart
---

"This is a Quarto website."