Skip to content

Markdown Javadoc links to URLs not properly interpreted #4531

@garretwilson

Description

@garretwilson

I'm using Eclipse EE 2025-09 with Java 25. I'm trying to use the new Javadoc Markdown format from JEP 467.

You'll notice here in GitHub I just added a Markdown URL link like this:

[JEP 467](https://openjdk.org/jeps/467)

Unfortunately this form of link is broken in Eclipse, and doesn't show up correctly on the "Javadoc" tab.

Consider this code:

/// Do nothing.
/// @see [Example Site](https://example.com/)
public void doNothing() {
}

In the "Javadoc" page, this shows up as:

Example(https://example.com/)

"Example" is underlined, but the link does not work. (I suspect the link is not correct because it is being interpreted as a Markdown reference link, not a Markdown URL link.) Moreover "(https://example.com/)" should not appear.

I realize that JEP 467 focuses on linking to other Java elements in the project rather than on URL links. Nevertheless this specification says:

You can use all other forms of Markdown links, including links to URLs, but links to other program elements are likely to be the most common.

Thus URL links should be supported as well. (And I think in good documentation they will actually be quite common, linking to authoritative specifications of implementing code, for example.)

Metadata

Metadata

Labels

No labels
No labels

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions