[I] xdoc to Markdown conversion silently drops elements [maven-doxia-converter]

Mon, 24 Aug 2026 03:31:57 -0700


slachiewicz opened a new issue, #159:
URL: https://github.com/apache/maven-doxia-converter/issues/159

   Converting xdoc containing a raw `<object>` element to Markdown drops the 
element entirely, with no error and no trace in the output beyond a log line — 
the same event-dropping behavior already known for `<map>`/`<area>` image maps.
   
   ### Reproduction
   
   xdoc input:
   
   ```xml
   <?xml version="1.0"?>
   <document>
     <properties><title>T</title><author>A B</author></properties>
     <body>
       <section name="S">
         <p><object type="image/svg+xml" data="x.svg"/></p>
         <p>Text after the object.</p>
       </section>
     </body>
   </document>
   ```
   
   Converting with `doxia-converter` (built from master, `2.1.0` doxia 
dependency):
   
   ```
   $ java -jar doxia-converter-shaded.jar -in input.xml -from xdoc -out 
output.md -to markdown -outEncoding UTF-8
   [main] WARN org.apache.maven.doxia.module.markdown.MarkdownSink - Unknown 
source, line 6, column 54: Unknown Sink event 'object', ignoring!
   [main] WARN org.apache.maven.doxia.module.markdown.MarkdownSink - Unknown 
source, line 6, column 54: Unknown Sink event 'object', ignoring!
   ```
   
   Output:
   
   ```markdown
   ---
   title: T
   author:
     - A B
   ---
   
   # S
   
   Text after the object.
   ```
   
   The `<object>` element (and everything it referenced, e.g. an embedded SVG 
diagram) is gone from the converted page with no visible marker that content 
was lost. `<properties>` metadata converts correctly here (fenced YAML front 
matter), so that part of this fixture is fine.
   
   ### Context
   
   This came up while investigating apache/maven-doxia#1086 (Markdown's 
raw-HTML parser leaves a self-closing non-void tag like `<object .../>` 
unclosed, which is what broke https://maven.apache.org/scm.html — 
apache/maven-site#1645, fixed site-side by apache/maven-site#1652). That 
symptom doesn't reproduce through this converter's xdoc→markdown path, because 
`<object>` never survives the conversion to reach that bug — it's dropped here 
instead. Any xdoc page relying on `<object>` (SVG embeds, applets, etc.) needs 
the same manual re-paste treatment as the known image-map drop.
   
   *This issue was created with AI assistance.*
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to