Add python support to quarto-authoring skill

quarto/quarto-authoring/SKILL.md

@@ -1,12 +1,11 @@
 ---
 name: quarto-authoring
 description: >
-  Writing and authoring Quarto documents (.qmd), including code cell options,
-  figure and table captions, cross-references, callout blocks (notes, warnings,
-  tips), citations and bibliography, page layout and columns, Mermaid diagrams,
-  YAML metadata configuration, and Quarto extensions. Also covers converting and
-  migrating R Markdown (.Rmd), bookdown, blogdown, xaringan, and distill projects
-  to Quarto, and creating Quarto websites, books, presentations, and reports.
+  Writing and authoring Quarto documents (.qmd) with R (knitr) and Python (Jupyter)
+  engines. Covers code cells, figures, tables, cross-references, callouts, citations,
+  layout, Mermaid diagrams, YAML metadata, and extensions. Also covers migrating
+  R Markdown, bookdown, blogdown, xaringan, distill, and Jupyter notebooks to Quarto,
+  and creating websites, books, presentations, and reports.
 metadata:
   author: Mickaël Canouil (@mcanouil)
   version: "1.2"
@@ -74,6 +73,7 @@ Only read the one matching the source format when the user explicitly asks to co
 - 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)
+- Jupyter notebook (.ipynb) to Quarto: [references/conversion-jupyter.md](references/conversion-jupyter.md)
 
 ## QMD Essentials
 
@@ -124,6 +124,8 @@ Quarto uses the language's comment symbol + `|` for cell options. Options use **
 - Mermaid: `%%|`
 - Graphviz/DOT: `//|`
 
+R example (knitr engine):
+
 ````markdown
 ```{r}
 #| label: fig-example
@@ -134,6 +136,27 @@ plot(x, y)
 ```
 ````
 
+Python example (Jupyter engine):
+
+````markdown
+```{python}
+#| label: fig-example
+#| echo: false
+#| fig-cap: "A scatter plot example."
+
+import matplotlib.pyplot as plt
+plt.scatter(x, y)
+plt.show()
+```
+````
+
+Quarto auto-detects the engine from the first executable cell. To force an engine, set in YAML:
+
+```yaml
+engine: knitr   # for R
+engine: jupyter # for Python
+```
+
 Common execution options:
 
 | Option    | Description       | Values                    |
@@ -164,6 +187,8 @@ Labels must start with a type prefix. Reference with `@`:
 - Section: `sec-` prefix, e.g., `{#sec-intro}` → `@sec-intro`
 - Equation: `eq-` prefix, e.g., `{#eq-model}` → `@eq-model`
 
+R:
+
 ````markdown
 ```{r}
 #| label: fig-plot
@@ -174,6 +199,20 @@ plot(1)
 See @fig-plot for the results.
 ````
 
+Python:
+
+````markdown
+```{python}
+#| label: fig-plot
+#| fig-cap: "A caption for the plot."
+import matplotlib.pyplot as plt
+plt.plot([1])
+plt.show()
+```
+
+See @fig-plot for the results.
+````
+
 Details: [references/cross-references.md](references/cross-references.md)
 
 ### Callout Blocks

quarto/quarto-authoring/references/code-cells.md

@@ -68,6 +68,16 @@ library(ggplot2)
 ```
 ````
 
+````markdown
+```{python}
+#| echo: false
+
+# This code runs but is not shown
+import pandas as pd
+import matplotlib.pyplot as plt
+```
+````
+
 Show fenced code block with attributes:
 
 ````markdown
@@ -96,6 +106,8 @@ Options for controlling figure output:
 
 ### Figure Example
 
+R:
+
 ````markdown
 ```{r}
 #| label: fig-analysis
@@ -111,8 +123,26 @@ ggplot(data, aes(x, y)) +
 ```
 ````
 
+Python:
+
+````markdown
+```{python}
+#| label: fig-analysis
+#| fig-cap: "Analysis results showing the relationship between variables."
+#| fig-alt: "Scatter plot with trend line showing positive correlation."
+#| fig-width: 10
+#| fig-height: 6
+#| fig-align: center
+
+import seaborn as sns
+sns.regplot(x=data["x"], y=data["y"])
+```
+````
+
 ### Multiple Figures
 
+R:
+
 ````markdown
 ```{r}
 #| label: fig-panels
@@ -127,6 +157,25 @@ hist(y)
 ```
 ````
 
+Python:
+
+````markdown
+```{python}
+#| label: fig-panels
+#| fig-cap: "Multiple panel figure."
+#| fig-subcap:
+#|   - "Distribution of X"
+#|   - "Distribution of Y"
+#| layout-ncol: 2
+
+import matplotlib.pyplot as plt
+plt.hist(x)
+plt.show()
+plt.hist(y)
+plt.show()
+```
+````
+
 ## Table Options
 
 Options for controlling table output:
@@ -140,6 +189,8 @@ Options for controlling table output:
 
 ### Table Example
 
+R:
+
 ````markdown
 ```{r}
 #| label: tbl-summary
@@ -149,6 +200,29 @@ knitr::kable(summary_data)
 ```
 ````
 
+Python (pandas — `output: asis` renders markdown table in all formats):
+
+````markdown
+```{python}
+#| label: tbl-summary
+#| tbl-cap: "Summary statistics by group."
+#| output: asis
+
+print(summary_df.to_markdown(index=False))
+```
+````
+
+Python (pandas — plain `df` auto-displays as HTML table in HTML output):
+
+````markdown
+```{python}
+#| label: tbl-summary
+#| tbl-cap: "Summary statistics by group."
+
+summary_df
+```
+````
+
 ## Caching and Freeze
 
 Control caching of code cell results:
@@ -161,6 +235,8 @@ Control caching of code cell results:
 
 ### Caching Example
 
+R:
+
 ````markdown
 ```{r}
 #| label: slow-computation
@@ -171,6 +247,18 @@ result <- slow_function(data)
 ```
 ````
 
+Python:
+
+````markdown
+```{python}
+#| label: slow-computation
+#| cache: true
+
+# This expensive computation is cached
+result = slow_function(data)
+```
+````
+
 ### Project-Level Freeze
 
 In `_quarto.yml`:
@@ -240,6 +328,8 @@ plot(1:10)
 
 Add annotations to explain code:
 
+R:
+
 ````markdown
 ```{r}
 #| code-annotations: hover
@@ -255,6 +345,22 @@ mtcars |>                 # <1>
 2. Filter to cars with MPG over 20
 3. Select only the columns we need
 
+Python:
+
+````markdown
+```{python}
+#| code-annotations: hover
+
+import pandas as pd                          # <1>
+df = pd.read_csv("data.csv")                 # <2>
+result = df[df["mpg"] > 20][["mpg", "cyl"]] # <3>
+```
+````
+
+1. Import pandas for data manipulation
+2. Load the dataset from a CSV file
+3. Filter rows and select columns of interest
+
 Annotation styles: `hover`, `select`, `below`, `beside`.
 
 ## Filename Display