Snippet sections in HTML/XML files

[joapuiib]

Hello,
I want to include a section of a XML file using Snippet sections, but I don't know how to specify sections in a XML syntax.

• pom.xml

<!-- --8<-- [start:mockito] -->
<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-junit-jupiter</artifactId>
    <version>5.14.2</version>
    <scope>test</scope>
</dependency>
<!-- --8<-- [end:mockito] -->

That works, and the snippet is included in the markdown page, but it gives me the following error:

Non-parseable POM .../docs/files/pom.xml: in comment after two dashes (--) next character must be > not 8 (position: END_TAG seen ...</dependency>\n\n      <!-- --8... @31:15) 

[joapuiib]

While I was writing this question, I figured out the solution. I'll post it anyway in case it helps someone.

• From the docs:

The dashes can be as few as 1 (-8<-) or longer if desired (---8<---------); whatever your preference is. The important thing is that the notation must reside on a line(s) by itself, and the path, must be quoted in the case of the single line notation. If the file name is indented, the content will be indented to that level as well.

<!-- -8<- [start:mockito] -->
<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-junit-jupiter</artifactId>
    <version>5.14.2</version>
    <scope>test</scope>
</dependency>
<!-- -8<- [end:mockito] -->

[facelessuser]

@joapuiib Yep, this has been discussed before and is related to this issue which caused us to allow -8<-: #1916.

I'm thinking though that this XML case might need to get explicitly called out in the docs if not already done.

[joapuiib]

Oh, my bad.

I have missed that discussion.