changelog

Author: cscheid

news/changelog-1.5.md

@@ -106,6 +106,10 @@ All changes included in 1.5:
 
 - ([#8939](https://github.com/quarto-dev/quarto-cli/pull/8939)): `quarto inspect` now takes an additional optional parameter to specify the output file, and provides the graph of include dependencies for the inspection target.
 
+## Quarto's input format
+
+- Quarto now supports raw block and raw inline elements of types `pandoc-native` and `pandoc-json`, and will use Pandoc's `native` and `json` reader to convert these elements to Pandoc's AST. This is useful in situations where emitting Markdown is not sufficient or convient enough to express the desired structure of a document.
+
 ## Other Fixes and Improvements
 
 - ([#8119](https://github.com/quarto-dev/quarto-cli/issues/8119)): More intelligently detect when ejs templates are modified during development, improving quality of life during preview.

src/resources/filters/normalize/extractquartodom.lua

@@ -25,6 +25,21 @@ function parse_md_in_html_rawblocks()
         end
         return make_scaffold(pandoc.Span, inlines)
       end
+    end,
+    RawBlock = function(raw)
+      if raw.format == "pandoc-native" then
+        return pandoc.read(raw.text, "native").blocks
+      elseif raw.format == "pandoc-json" then
+        return pandoc.read(raw.text, "json").blocks
+      end
+    end,
+    RawInline = function(raw)
+      if raw.format == "pandoc-native" then
+        return quarto.utils.as_inlines(pandoc.read(raw.text, "native").blocks)
+      elseif raw.format == "pandoc-json" then
+        -- let's try to be minimally smart here, and handle lists differently from a single top-level element
+        return quarto.utils.as_inlines(pandoc.read(raw.text, "json").blocks)
+      end
     end
   }
 end

tests/docs/ast/test-quarto-pandoc-json-raw.qmd

@@ -0,0 +1,13 @@
+---
+format: html
+_quarto:
+  tests:
+    html:
+      ensureFileRegexMatches:
+        - ["--"]
+        - ["–"]
+---
+
+(The JSON syntax is decidedly more verbose and not as nice, and really intended to be used by machine-generated markdown.)
+
+Here is a string that shouldn't be escaped: `{"pandoc-api-version":[1,23,1],"meta":{},"blocks":[{"t":"Plain","c":[{"t":"Str","c":"do--not--escape--this"}]}]}`{=pandoc-json}.

tests/docs/ast/test-quarto-pandoc-native-raw.qmd

@@ -0,0 +1,11 @@
+---
+format: html
+_quarto:
+  tests:
+    html:
+      ensureFileRegexMatches:
+        - ["--"]
+        - ["–"]
+---
+
+Here is a string that shouldn't be escaped: `Str "do--not--escape--this"`{=pandoc-native}.