DOCX reader with docx+styles generate warning on commends

[steven-r]

Explain the problem.
When using the DOCX-reader with comments included, the extension +styles creates warnings with every comment:

~/src/mybook$ pandoc text/custom-reference.docx --from=docx+styles --to=native --track-changes=all --output=test.debug --verbose 
[WARNING] Docx parser warning: Docx comment 9 will not retain formatting
~/src/mybook$

Converting without the styles-extension, no warning is given:

$ pandoc text/custom-reference.docx --from=docx --to=native --track-changes=all --output=test.debug --verbose 
~/src/mybook$ 

Pandoc version?
3.6.2

Looking at the source::

pandoc/src/Text/Pandoc/Readers/Docx.hs

Lines 358 to 366 in 220dde4

	blocksToInlinesWarn cmtId blks = do
	let paraOrPlain :: Block -> Bool
	paraOrPlain (Para _) = True
	paraOrPlain (Plain _) = True
	paraOrPlain _ = False
	unless (all paraOrPlain blks) $
	lift $ P.report $ DocxParserWarning $
	"Docx comment " <> cmtId <> " will not retain formatting"
	return $ blocksToInlines' (toList blks)

only Para and Plain are considered as save block elements.

If using +styles, all block elements are pretended with a Div element, even comment texts.

Therefore the fix should be very straightforward:

  blocksToInlinesWarn cmtId blks = do
  let paraOrPlain :: Block -> Bool
      paraOrPlain (Para _)  = True
      paraOrPlain (Plain _) = True
      paraOrPlain (Div _ _) = True
      paraOrPlain _         = False
  unless (all paraOrPlain blks) $
    lift $ P.report $ DocxParserWarning $
      "Docx comment " <> cmtId <> " will not retain formatting"
  return $ blocksToInlines' (toList blks)

Example document
custom-reference.docx