Merge pull request #1672 from quarto-dev/sync-1671-to-prerelease

[Sync to prerelease] Update pdf-basics.qmd

Author: cderv

docs/output-formats/pdf-basics.qmd

@@ -222,17 +222,21 @@ With fonts with appropriate support, Greek symbols render correctly in headings,
 
 ## Raw LaTeX
 
-When creating a PDF document, Pandoc allows the use of [raw LaTeX](https://pandoc.org/MANUAL.html#extension-raw_tex) directives intermixed with markdown. For example:
+When creating a PDF document, Pandoc allows the use of [raw LaTeX](https://pandoc.org/MANUAL.html#extension-raw_tex) directives intermixed with markdown.
+Although Pandoc allows LaTeX to appear unescaped in Markdown, we instead recommend to wrap the content in a raw block. For example:
 
-``` tex
+```` markdown
+```{=latex}
 \begin{tabular}{|l|l|}\hline
 Age & Frequency \\ \hline
 18--25  & 15 \\
 26--35  & 33 \\
 36--45  & 22 \\ \hline
 \end{tabular}
 ```
+````
 
+Raw LaTeX can be specified as a block element (as shown above), or as an inline element, such as `` `\textrm{hello}`{=latex} ``.
 Raw LaTeX commands will be preserved and passed unchanged to the LaTeX writer.
 
 ::: callout-warning