4 ms·
Although it is not mentioned in the JEP, I wonder if we can use fenced code blocks as @snippet tags [1]. Of course one can still use {@snippet}, but fenced code
by gudzpoz 3y ago
Although it is not mentioned in the JEP, I wonder if we can use fenced code blocks as @snippet tags [1]. Of course one can still use {@snippet}, but fenced code blocks seem to me to be the go-to for code quoting in Markdown.
```java id=example
class HelloWorld {
public static void main(String... args) {
System.out.println("Hello World!"); // @link substring="System.out" target="System#out"
}
}
```
(However, some JS highlighting libraries will strip pre-existing HTML in the code (e.g. PRISM.js [2], as is mentioned in the JEP), negating the @link tag above. Highlight.js [3] seems fine though.)
[1] https://openjdk.org/jeps/413 https://openjdk.org/jeps/413
[2] https://prismjs.com/faq.html#if-pre-existing-html-is-stripped-off-how-can-i-highlight https://prismjs.com/faq.html#if-pre-existing-html-is-strippe...
[3] https://jsfiddle.net/LFJKR/ https://jsfiddle.net/LFJKR/
- pron 3y agoNot yet, but we'd like to have that.