`margin-header`, `body-header`, etc. should document they allow HTML

What would you like to do?

Report an issue on quarto.org

Description

The documentation about margin-header, body-header, etc. states that it only allows Markdown text or string, but The "subscribe" example shows the use of HTML file with raw HTML.

• https://quarto.org/docs/websites/website-blog.html#subscriptions

As pointed out by @cderv, Quarto is handling the HTML case here but does not state it does.

• https://github.com/quarto-dev/quarto-cli/blob/2a4799429cdfca4a055aa465bc56790d7ff0483f/src/project/types/website/website-navigation-md.ts#L716-L731

This can lead to confusion about why some fields allow HTML while asking for Markdown but not all of them.

I initially updated the "subscribe" example (I did not know Quarto was adding the raw block at the time):

• https://github.com/quarto-dev/quarto-web/pull/1752

After some discussion, it might be better to actually document that these fields actually support HTML:

• https://quarto.org/docs/websites/website-tools.html#headers-footers
• https://quarto.org/docs/reference/projects/websites.html#section

Start with the Headers and Footers section in website-tools.html and the corresponding section in reference/projects/websites.html, then compare the subscribe example in website-blog.html. Check website-navigation-md.ts around lines 716-731 for the HTML handling, and update the documentation so the supported HTML behavior is stated consistently.