Converting captioned figures to DOCX and back produces raw HTML, or doubled captions

[rrthomas]

Using pandoc 3.6.4.

With the following Markdown input as foo.md:

![An image.](media/image.jpg)

I convert to DOCX:

pandoc --to=docx foo.md --output=foo.docx

This works fine. Converting foo.md to HTML and PDF also produce good results.

I then convert the DOCX back to Markdown:

pandoc --to=markdown --output=bar.md --extract-media=. foo.docx

This produces the following Markdown:

<figure>
<img src="./media/rId20.jpg" style="width:5.83333in;height:3.91413in"
alt="An image." />
<figcaption aria-hidden="true"><p>An image.</p></figcaption>
</figure>

This looks OK in principle, but while converting it to HTML produces a good result, converting it to PDF omits the image.

I also tried:

pandoc --to=markdown-raw_html --output=bar.md --extract-media=. foo.docx

This produces:

:::: figure
![An image.](./media/rId20.jpg){width="5.833333333333333in"
height="3.9141338582677165in"}

::: caption
An image.
:::
::::

Here, the PDF output is fine, but the HTML has two copies of the figure caption.

Ideally, it would be possible to produce the same Markdown from the DOCX as the original, but I'd be quite happy with an equivalent that worked as well. I'm hoping to be able to do round-trip conversion, so that I and others can do (disciplined!) edits to the DOCX and then re-convert to Markdown.

[rrthomas]

I also tried using +implicit_figures when converting from DOCX to Markdown, but that seemed to have no effect.

[jgm]

Thanks. It would be nice to get a round-trip md -> docx -> md.

The docx gets read like this:

[ Figure
    ( "" , [] , [] )
    (Caption
       Nothing [ Para [ Str "An" , Space , Str "image." ] ])
    [ Plain
        [ Image
            ( ""
            , []
            , [ ( "width" , "2.0833333333333335in" )
              , ( "height" , "2.0833333333333335in" )
              ]
            )
            [ Str "An" , Space , Str "image." ]
            ( "media/rId20.jpg" , "" )
        ]
    ]
]

It would be best if the markdown writer would render this using an implicit figure, rather than resortung to raw HTML. So I think that's the change that is called for here.

Alternatively, or in addition, we could tell the markdown reader to parse this structure as a figure:

:::: figure
![An image.](./media/rId20.jpg){width="5.833333333333333in"
height="3.9141338582677165in"}

::: caption
An image.
:::
::::

[rrthomas]

Many thanks for the rapid fix, which I agree is the best one.