You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: posts/2026-03-xx/index.qmd
+4-4Lines changed: 4 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -39,7 +39,7 @@ This creates a project with two pieces: an `_extension.yml` that declares the en
39
39
40
40
### `_extension.yml`
41
41
42
-
The extension metadata lives in `_extensions/{name}/_extension.yml`. For an engine extension, the important part is `contributes.engines`:
42
+
The extension metadata lives in [`_extensions/{name}/_extension.yml`](https://quarto.org/docs/extensions/). For an engine extension, the important part is `contributes.engines`:
43
43
44
44
```yaml
45
45
title: My Engine
@@ -137,7 +137,7 @@ interface ExecutionTarget {
137
137
138
138
Most engines do the same thing here — read the file as a `MappedString` and extract its YAML. `MappedString` is a string that carries source location mapping so that error messages can point back to the right line in the original file. Use `quarto.mappedString.fromFile()` to create one.
139
139
140
-
`{{< include >}}`shortcodes can appear inside code blocks to import code. Call `context.resolveFullMarkdownForFile()` here to expand them before `execute()` sees the document — see [`EngineProjectContext`](#engineprojectcontext). Both knitr and Jupyter do this.[^2]
140
+
[`{{< include >}}` shortcodes](https://quarto.org/docs/authoring/includes.html) can appear inside code blocks to import code. Call `context.resolveFullMarkdownForFile()` here to expand them before `execute()` sees the document — see [`EngineProjectContext`](#engineprojectcontext). Both knitr and Jupyter do this.[^2]
141
141
142
142
[^2]: Currently, neither marimo nor the Julia engine calls `resolveFullMarkdownForFile`.
143
143
@@ -158,7 +158,7 @@ The most important fields of `ExecuteResult`:
158
158
159
159
- `markdown`— the processed markdown (this is the main output)
160
160
- `supporting`— paths to supporting files like figures
161
-
- `filters`— pandoc filters to apply
161
+
- `filters`— [pandoc filters](https://quarto.org/docs/extensions/filters.html) to apply
162
162
- `includes`— content to inject into the document header, footer, etc.
163
163
164
164
Other fields include `metadata`, `pandoc`, `engine`, `engineDependencies`, `preserve`, `postProcess`, and `resourceFiles`.
@@ -288,7 +288,7 @@ This is the top-level interface your engine exports as its default export. It ha
288
288
: File extensions this engine supports beyond `.qmd` — for example, Jupyter returns `[".ipynb"]`. Most engine extensions return `[]`.
289
289
290
290
`canFreeze`
291
-
: Whether your engine supports freezing (caching execution results so they aren't re-run).
291
+
: Whether your engine supports [freezing](https://quarto.org/docs/projects/code-execution.html#freeze) (caching execution results so they aren't re-run).
0 commit comments