fix(quarto): clean up quarto-authoring skill

quarto/quarto-authoring/SKILL.md

@@ -9,34 +9,19 @@ description: >
   to Quarto, and creating Quarto websites, books, presentations, and reports.
 metadata:
   author: Mickaël Canouil (@mcanouil)
-  version: "1.1"
+  version: "1.2"
 license: MIT
 ---
 
 # Quarto Authoring
 
-> This skill is based on Quarto CLI v1.8.26.
+> This skill is based on Quarto CLI v1.9.36 (2026-03-24).
 
 ## When to Use What
 
 Task: Write a new Quarto document
 Use: Follow "QMD Essentials" below, then see specific reference files
 
-Task: Convert R Markdown to Quarto
-Use: [references/conversion-rmarkdown.md](references/conversion-rmarkdown.md)
-
-Task: Migrate bookdown project
-Use: [references/conversion-bookdown.md](references/conversion-bookdown.md)
-
-Task: Migrate xaringan slides
-Use: [references/conversion-xaringan.md](references/conversion-xaringan.md)
-
-Task: Migrate distill article
-Use: [references/conversion-distill.md](references/conversion-distill.md)
-
-Task: Migrate blogdown site
-Use: [references/conversion-blogdown.md](references/conversion-blogdown.md)
-
 Task: Add cross-references
 Use: [references/cross-references.md](references/cross-references.md)
 
@@ -79,6 +64,17 @@ Use: [references/extensions.md](references/extensions.md)
 Task: Apply markdown linting rules
 Use: [references/markdown-linting.md](references/markdown-linting.md)
 
+### Migration (only when converting an existing project)
+
+Do NOT read these references when writing new Quarto documents.
+Only read the one matching the source format when the user explicitly asks to convert or migrate an existing project.
+
+- R Markdown (.Rmd) to Quarto: [references/conversion-rmarkdown.md](references/conversion-rmarkdown.md)
+- bookdown project: [references/conversion-bookdown.md](references/conversion-bookdown.md)
+- xaringan slides: [references/conversion-xaringan.md](references/conversion-xaringan.md)
+- distill article: [references/conversion-distill.md](references/conversion-distill.md)
+- blogdown site: [references/conversion-blogdown.md](references/conversion-blogdown.md)
+
 ## QMD Essentials
 
 ### Basic Document Structure

quarto/quarto-authoring/references/callouts.md

@@ -108,18 +108,18 @@ See @nte-important for details.
 
 ## Nested Callouts
 
-Use more colons for outer divs when nesting:
+Nest callouts inside each other:
 
 ````markdown
-:::: {.callout-note}
+::: {.callout-note}
 
 ## Outer Callout
 
 ::: {.callout-tip}
 Nested callout.
 :::
 
-::::
+:::
 ````
 
 ## Format-Specific Options

quarto/quarto-authoring/references/citations.md

@@ -296,5 +296,3 @@ Or use `@Manual` for R packages.
 - [Quarto Citations](https://quarto.org/docs/authoring/citations.html)
 - [Pandoc Citations](https://pandoc.org/MANUAL.html#citations)
 - [CSL Styles](https://citationstyles.org/)
-
-

quarto/quarto-authoring/references/conditional-content.md

@@ -291,5 +291,3 @@ Basic HTML content.
 
 - [Quarto Conditional Content](https://quarto.org/docs/authoring/conditional.html)
 - [Project Profiles](https://quarto.org/docs/projects/profiles.html)
-
-

quarto/quarto-authoring/references/conversion-blogdown.md

@@ -235,7 +235,7 @@ Install extension: `quarto add sellorm/quarto-social-embeds`
 
 ````markdown
 {{</* youtube VIDEO_ID */>}}
-```
+````
 
 #### Quarto
 
@@ -259,7 +259,7 @@ Install extension: `quarto add sellorm/quarto-social-embeds`
 {{</* highlight r */>}}
 code here
 {{</* /highlight */>}}
-```
+````
 
 #### Quarto
 
@@ -528,4 +528,3 @@ Check for Hugo-specific template syntax in content files.
 - [Quarto Websites](https://quarto.org/docs/websites/)
 - [Quarto Blogs](https://quarto.org/docs/websites/website-blog.html)
 - [Quarto Themes](https://quarto.org/docs/output-formats/html-themes.html)
-

quarto/quarto-authoring/references/conversion-xaringan.md

@@ -374,7 +374,7 @@ Content fades in
 ::: {.fragment .fade-in}
 Content fades in
 :::
-```
+````
 
 Fragment types:
 
@@ -463,4 +463,3 @@ format:
 - [Quarto RevealJS](https://quarto.org/docs/presentations/revealjs/)
 - [RevealJS Options](https://quarto.org/docs/reference/formats/presentations/revealjs.html)
 - [Presentation Features](https://quarto.org/docs/presentations/)
-

quarto/quarto-authoring/references/divs-and-spans.md

@@ -40,7 +40,7 @@ Content with attributes.
 
 ## Nested Divs
 
-Use more colons for outer div:
+Nest divs inside each other:
 
 ````markdown
 ::: {.outer}
@@ -180,7 +180,7 @@ Raw LaTeX content.
 
 ### Inline Raw Content
 
-`arkdown
+````markdown
 Text with `<br>`{=html} line break.
 ````
 
@@ -341,5 +341,3 @@ Special classes:
 
 - [Pandoc Divs and Spans](https://pandoc.org/MANUAL.html#divs-and-spans)
 - [Quarto Markdown Basics](https://quarto.org/docs/authoring/markdown-basics.html)
-
-

quarto/quarto-authoring/references/layout.md

@@ -425,5 +425,3 @@ KOMA classes support margin content automatically.
 - [Quarto Article Layout](https://quarto.org/docs/authoring/article-layout.html)
 - [Page Layout](https://quarto.org/docs/output-formats/page-layout.html)
 - [Figures Layout](https://quarto.org/docs/authoring/figures.html#figure-panels)
-
-

quarto/quarto-authoring/references/markdown-linting.md

@@ -79,7 +79,7 @@ Key points:
 
 - Blank line before opening `:::`.
 - Blank line after closing `:::`.
-- Use `::::` (four+ colons) for nesting outer divs.
+- Use `:::` (three colons) for both opening and closing divs, including when nesting.
 
 ## Resources