Section 10.11 Summary of Common Quarto Syntax
In addition to R functions, Quarto relies on a small set of Markdown syntax rules to format text and structure documents. These elements are not functions, but they are essential for writing clear, readable, and professional reports.
-
Text emphasis:
-
*text*: Italicizes text. -
**text**: Bolds text. -
***text***: Bold and italic text.
-
-
Headings:
-
#: Primary heading (chapter-level). -
##: Section heading. -
###: Subsection heading. -
{#sec-name}: Added after a header to create a label for cross-referencing.
-
-
Lists:
-
-: Creates a bulleted list. -
1.: Creates a numbered list. -
[ ]: Creates a checklist.
-
-
Links:
-
[text](url): Creates a clickable hyperlink.
-
-
Images:
-
: Inserts an image into the document, with alternative text for accessibility.
-
-
Block quotes:
-
>: Highlights a block of text, often used for emphasis or reflection.
-
-
Callout boxes
-
::: {.callout-tip}: Highlights helpful tips or best practices. -
::: {.callout-note}: Provides additional context or clarification. -
::: {.callout-warning}: Draws attention to potential problems or common mistakes. -
::: {.callout-important}: Emphasizes critical information that should not be overlooked. -
::: {.callout-caution}: Signals situations that require extra care. -
:::: Ends a callout box.
-
-
Cross-Referencing
-
@: The symbol used to trigger a link to a label (e.g.,@sec-name,@fig-name, or@tbl-name).
-
