Move highlight to main doc about pdf images from svg

Author: cderv

docs/output-formats/pdf-basics.qmd

@@ -214,7 +214,26 @@ With fonts with appropriate support, Greek symbols render correctly in headings,
 ![Greek symbols in a rendered PDF](images/pdf-unicode-greek.png){.border fig-alt="Screenshot of at PDF displaying the Greek symbol alpha in a heading, main text and code cell."}
 
 
- 
+## SVG Images {#svg-images}
+
+Quarto supports rendering of PDF documents that include SVG files, automatically converting them to PDF images if `rsvg-convert` is available on the system path during rendering.
+
+You can learn more about installing `librsvg`{spellcheck="false"} (which provides `rsvg-convert`{spellcheck="false"}), see <https://wiki.gnome.org/Projects/LibRsvg>. To install on specific platforms:
+
+-   On MacOS, use Homebrew: `brew install librsvg`{spellcheck="false"}
+-   On Linux, tarballs available at: <https://download.gnome.org/sources/librsvg/>
+-   On Windows, install using chocolatey: `choco install rsvg-convert`{spellcheck="false"}
+
+::: callout-note
+## SVG Format for Diagrams
+
+When using Mermaid or Graphviz diagrams in PDF documents, the default PNG format is recommended. While SVG output is possible with `mermaid-format: svg`, it requires `rsvg-convert` and may have rendering issues such as text clipping in diagrams with multi-line labels. See [Diagrams](/docs/authoring/diagrams.qmd#mermaid-formats) for more information.
+:::
+
+## Remote Images
+
+When rendering PDFs, Quarto automatically fetches remote image references and properly embeds them within the PDF.
+
 ## Citations
 
 {{< include _pdf-citations.md >}}