Markdown conversion to HTML of links and images don't convert near <p> block

I don’t get why I get this behavior near paragraph tags. Look at the string variable below. The result I get is:

<p><strong>Note</strong>: When sent as a Bearer token</p> ![External Groups Whitelist field](images/external-groups-whitelist.png)

If I change the paragraph tag to span tag I get:

<p><span><strong>Note</strong>: When sent as a Bearer token</span> <img src="images/external-groups-whitelist.png" alt="External Groups Whitelist field" /></p>

Which is the desired behavior. Why is that? Is there an extension I’m missing? Thanks!

		String content = 
				"<p><strong>Note</strong>: When sent as a Bearer token</p> ![External Groups Whitelist field](images/external-groups-whitelist.png)";
		
		MutableDataHolder OPTIONS = new MutableDataSet();
		OPTIONS.setFrom(ParserEmulationProfile.MARKDOWN);
		OPTIONS.set(Parser.HEADING_NO_ATX_SPACE, true); // !
		OPTIONS.set(Parser.EXTENSIONS, Arrays.asList(TablesExtension.create()));
		Parser parser = Parser.builder(OPTIONS).build();
		
		HtmlRenderer renderer = HtmlRenderer.builder(OPTIONS).build();

		try {
			Node document = parser.parse(content);
			String result = renderer.render(document);
			System.out.println(result);
		} catch (Exception e) {
			throw new RuntimeException("Process md exception");
		}

[vsch]

@Dan4ito, thank you for the compliment.

BTW, if you are not sure of why your markdown renders the way it does, you can always dump the AST and that will make it easier to follow:

        Node document = PARSER.parse(markdown);

        System.out.println(new AstCollectingVisitor().collectAndGetAstText(document));
        System.out.println("\n--------------------------------------------------------------------------------\n");

AstCollectingVisitor is found in flexmark-test-util module and will output the AST in human readable form, with offsets into original text and important node attributes shown.

It is used to generate the AST for test cases so you can rely on its contents.

[vsch]

@Dan4ito, the side-effect is that rendered HTML will have HTML block elements in p tags and nested p tags. Depending on your requirements it may be an issue.

Effectively, all HTML will be wrapped in p tags since it will all be treated as inline HTML.

<p><p><strong>Note</strong>: When sent as a Bearer token</p> <img src="images/external-groups-whitelist.png" alt="External Groups Whitelist field" /></p>

If you want to change what HTML is treated as block tags instead of turning all of them off. See Parser.HTML_BLOCK_TAGS, it is a List<String> of all HTML tags to treat as block tags.