Merge pull request #13056 from quarto-dev/backport/crossref-markodwn-table-caption

backport for floatref fix on Captioned Markdown Table in Div syntax

Author: cderv

news/changelog-1.7.md

@@ -2,6 +2,8 @@
 
 ## In this release
 
+- ([#13051](https://github.com/quarto-dev/quarto-cli/issues/13051)): Fixed support for captioned Markdown table inside Div syntax for crossref. This is special handling, but this could be output by function like `knitr::kable()` with old option support.
+
 ## In previous releases
 
 - ([#6607](https://github.com/quarto-dev/quarto-cli/issues/6607)): Add missing beamer template update for beamer theme options: `colorthemeoptions`, `fontthemeoptions`, `innerthemeoptions` and `outerthemeoptions`.

src/resources/filters/quarto-pre/parsefiguredivs.lua

@@ -267,6 +267,8 @@ function parse_floatreftargets()
           if table.caption.long and next(table.caption.long) then
             found_caption = true
             caption = table.caption.long[1] -- what if there's more than one entry here?
+            -- table caption should be removed from the table as we'll handle it
+            table.caption = pandoc.Caption{}
             return table
           end
         end

tests/docs/smoke-all/2025/07/10/13051.qmd

@@ -0,0 +1,74 @@
+---
+title: Crossref Div with Markdown captioned table do not duplicate caption
+format: html
+keep-tex: true
+keep-typ: true
+_quarto:
+  tests:
+    html:
+      ensureHtmlElements:
+        - 
+          - 'div#tbl-1.quarto-float figure.quarto-float.quarto-float-tbl table'
+          - 'div#tbl-2.quarto-float figure.quarto-float.quarto-float-tbl table'
+          - 'a[href="#tbl-1"].quarto-xref'
+          - 'a[href="#tbl-2"].quarto-xref'
+        -  
+           -  'div#tbl-1.quarto-float table caption'
+           -  'div#tbl-2.quarto-float table caption'
+    revealjs:
+      ensureHtmlElements:
+        - 
+          - 'div#tbl-1.quarto-float figure.quarto-float.quarto-float-tbl table'
+          - 'div#tbl-2.quarto-float figure.quarto-float.quarto-float-tbl table'
+          - 'a[href="#/tbl-1"].quarto-xref'
+          - 'a[href="#/tbl-2"].quarto-xref'
+        -  
+           -  'div#tbl-1.quarto-float table caption'
+           -  'div#tbl-2.quarto-float table caption'
+    docx:
+      ensureDocxXpath:
+        - 
+          - "//w:tbl//w:p//w:r//w:t[contains(text(), \"Table\u00a01\")]"
+          - "//w:tbl//w:p//w:r//w:t[contains(text(), \"Table\u00a02\")]"
+          - "//w:hyperlink[@w:anchor='tbl-1']"
+          - "//w:hyperlink[@w:anchor='tbl-2']"
+        - 
+          - "//w:tbl//w:tbl//w:tblCaption[contains(@w:val, 'caption for the table 1')]"
+          - "//w:tbl//w:tbl//w:tblCaption[contains(@w:val, 'caption for the table 2')]"
+---
+
+Pandoc's support Caption on Markdown table through a specific syntax: https://pandoc.org/MANUAL.html#extension-table_captions
+
+This test ensure we do catch the caption and do not duplicate
+
+## Using `:` syntax
+
+::: {#tbl-1}
+
+| Default | Left | Right | Center |
+|---------|:-----|------:|:------:|
+| 12      | 12   |    12 |   12   |
+| 123     | 123  |   123 |  123   |
+| 1       | 1    |     1 |   1    |
+
+: This is the caption for the table 1
+
+:::
+
+See @tbl-1
+
+## Using `Table:` syntax
+
+::: {#tbl-2}
+
+| Default | Left | Right | Center |
+|---------|:-----|------:|:------:|
+| 12      | 12   |    12 |   12   |
+| 123     | 123  |   123 |  123   |
+| 1       | 1    |     1 |   1    |
+
+Table: This is the caption for the table 2
+
+:::
+
+See @tbl-2