feat: add support for Template, Math blocks and Cards in exporter

Author: megayu

deps/graph-parser/src/logseq/graph_parser/exporter.cljs

@@ -693,7 +693,6 @@
                (get-page-uuid page-names-to-uuids ((some-fn ::original-name :block/name) block) {:block block})
                (:block/uuid block))
              properties-text-values))
-    ;; TODO: Add import support for :template. Ignore for now as they cause invalid property types
     (if (contains? props :template)
       {}
       (let [props' (-> (update-built-in-property-values
@@ -782,6 +781,8 @@
            (cond-> block
              true
              (merge block-properties)
+             (:template properties')
+             (update :block/tags (fnil conj []) :logseq.class/Template)
              (seq classes-from-properties)
              ;; Add a map of {:block.temp/new-class TAG} to be processed later
              (update :block/tags
@@ -944,6 +945,7 @@
   use in build-block-tx. This walk is only done once for perf reasons"
   [config ast-blocks]
   (let [results (atom {:simple-queries []
+                       :cards []
                        :asset-links []
                        :embeds []
                        :zotero-imported-files {}
@@ -980,6 +982,10 @@
               parsed-path (common-util/safe-read-string relative-path)]
           (when (string? parsed-path)
             (swap! results update :zotero-linked-files conj parsed-path)))
+         (and (vector? x)
+              (= "Macro" (first x))
+              (= "cards" (:name (second x))))
+         (swap! results update :cards conj x)
          (and (vector? x)
               (= "Macro" (first x))
               (= "query" (:name (second x))))
@@ -1032,7 +1038,20 @@
                 (assoc :block/collapsed? true)))]
         {:block block'
          :pvalues-tx pvalues-tx'})
-      {:block block})))
+      (if-let [cards-macro (first (:cards walked-ast-blocks))]
+        (let [query (-> (:arguments (second cards-macro)) first string/trim)
+              props {:logseq.property/query query}
+              {:keys [block-properties pvalues-tx]}
+              (build-properties-and-values props db page-names-to-uuids
+                                           (select-keys block [:block/properties-text-values :block/name :block/title :block/uuid])
+                                           options)
+              block'
+              (-> (update block :block/tags (fnil conj []) :logseq.class/Cards)
+                  (merge block-properties
+                         {:block/title (string/trim (string/replace-first title #"\{\{cards(.*)\}\}" ""))}))]
+          {:block block'
+           :pvalues-tx pvalues-tx})
+        {:block block}))))
 
 (defn- handle-block-properties
   "Does everything page properties does and updates a couple of block specific attributes"
@@ -1390,6 +1409,23 @@
             :block/tags [:logseq.class/Quote-block]})
     block))
 
+(defn- handle-math
+  "If a block's entire content is a single displayed math formula, convert to #Math-block node.
+  Detects blocks whose title is entirely delimited by $$ markers."
+  [block _opts]
+  (let [title (string/trim (:block/title block))]
+    (if (and (string/starts-with? title "$$")
+             (string/ends-with? title "$$")
+             (> (count title) 4)
+             ;; ensure there's no nested $$ pair (i.e. not two separate inline formulas)
+             (not (string/includes? (subs title 2 (- (count title) 2)) "$$")))
+      (let [math-content (string/trim (subs title 2 (- (count title) 2)))]
+        (merge block
+               {:block/title math-content
+                :logseq.property.node/display-type :math
+                :block/tags [:logseq.class/Math-block]}))
+      block)))
+
 (defn- split-title-by-code-fences
   "Parses a block title string line-by-line, splitting into non-code text parts
    and code fence segments. All code fences are extracted regardless of whether
@@ -1492,6 +1528,7 @@
                      (update-block-tags db (:user-options options) per-file-state (:all-idents import-state))
                      (handle-embeds page-names-to-uuids walked-ast-blocks (select-keys options [:log-fn]))
                      (handle-quotes (select-keys options [:log-fn]))
+                     (handle-math (select-keys options [:log-fn]))
                      (update-block-marker options)
                      (update-block-priority options)
                      add-missing-timestamps

deps/graph-parser/test/logseq/graph_parser/exporter_test.cljs

@@ -222,6 +222,10 @@
       (is (= 5 (count (d/q '[:find ?b :where [?b :block/tags :logseq.class/Task]] @conn))))
       (is (= 4 (count (d/q '[:find ?b :where [?b :block/tags :logseq.class/Query]] @conn))))
       (is (= 2 (count (d/q '[:find ?b :where [?b :block/tags :logseq.class/Card]] @conn))))
+      (is (= 1 (count (d/q '[:find ?b :where [?b :block/tags :logseq.class/Cards]] @conn))))
+      (is (= 2 (count (d/q '[:find ?b :where [?b :block/tags :logseq.class/Code-block]] @conn))))
+      (is (= 1 (count (d/q '[:find ?b :where [?b :block/tags :logseq.class/Math-block]] @conn))))
+      (is (= 1 (count (d/q '[:find ?b :where [?b :block/tags :logseq.class/Template]] @conn))))
       (is (= 5 (count (d/q '[:find ?b :where [?b :block/tags :logseq.class/Quote-block]] @conn))))
       (is (= 7 (count (d/q '[:find ?b :where [?b :block/tags :logseq.class/Pdf-annotation]] @conn))))
 
@@ -331,11 +335,6 @@
              (mapv :db/id (:block/refs (db-test/find-block-by-content @conn #"ref to"))))
           "block with a block-ref has correct :block/refs")
 
-      (let [b (db-test/find-block-by-content @conn #"MEETING TITLE")]
-        (is (= {}
-               (and b (db-test/readable-properties b)))
-            ":template properties are ignored to not invalidate its property types"))
-
       (is (= 20221126
              (-> (db-test/readable-properties (db-test/find-block-by-content @conn "only deadline"))
                  :logseq.property/deadline
@@ -418,6 +417,26 @@
              (db-test/readable-properties (db-test/find-block-by-content @conn "card 1")))
           "None of the card properties are imported since they are deprecated")
 
+      ;; Cards (flashcard browser)
+      (is (= {:block/tags [:logseq.class/Cards]
+              :logseq.property/query "(tags #Card)"}
+             (db-test/readable-properties (find-block-by-property-value @conn :logseq.property/query "(tags #Card)")))
+          "cards macro block has correct Cards class and query property")
+
+      ;; Math blocks
+      (is (= {:block/tags [:logseq.class/Math-block]
+              :logseq.property.node/display-type :math}
+             (db-test/readable-properties (db-test/find-block-by-content @conn "E=mc^2")))
+          "Math block has correct Math-block class and display-type")
+      (is (= "E=mc^2" (:block/title (db-test/find-block-by-content @conn "E=mc^2")))
+          "Math block title has delimiters stripped")
+
+      ;; Templates
+      (let [b (db-test/find-block-by-content @conn #"MEETING TITLE")]
+        (is (= {:block/tags [:logseq.class/Template]}
+               (and b (db-test/readable-properties b)))
+            "Template block is tagged as Template class"))
+
       ;; Assets
       (is (= {:block/tags [:logseq.class/Asset]
               :logseq.property.asset/type "png"

deps/graph-parser/test/resources/exporter-test-graph/journals/2026_03_01.md

@@ -30,4 +30,6 @@
   echo "bye"
   exit
   ```
-  after code snippet
+  after code snippet
+- $$E=mc^2$$
+- {{cards (tags #Card)}}