Skip to content

Commit 3f1926a

Browse files
committed
Add \QuartoMarkdownBase64{} in advanced docs
1 parent 83bd671 commit 3f1926a

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

docs/advanced/latex-raw.qmd

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
title: Include Quarto Markdown in LaTeX Raw Blocks
3+
summary: Allows library authors to emit raw blocks that include Quarto features like cross-references or shortcodes.
4+
---
5+
6+
Use the syntax `\QuartoMarkdownBase64{<<base64-encoded-markdown-content>>}`
7+
to include Quarto Markdown in LaTeX raw blocks.
8+
When this syntax is detected by Quarto, the contents will be decoded,
9+
processed in Quarto (including user filters), and then inserted back into the LaTeX raw block.
10+
This allows libraries that emit raw blocks to benefit
11+
from Quarto features such as cross-reference resolution and shortcodes.
12+
13+
This is useful for third-party libraries that seek to emit LaTeX content that nevertheless
14+
can have "quarto content". Note that, unlike the [equivalent HTML feature](/docs/authoring/tables.qmd#html-tables),
15+
Quarto currently only supports base-64 encoded content in LaTeX blocks.
16+
17+
This LaTeX feature cannot currently be disabled.
18+
We expect this to not be necessary because `QuartoMarkdownBase64` is unlikely to conflict with
19+
existing LaTeX environments.

0 commit comments

Comments
 (0)