Markdown in Scaladoc is now supported by IntelliJ IDEA! | The IntelliJ Scala Plugin Blog
Blog post from JetBrains
The recent update in IntelliJ IDEA now supports Markdown in Scaladoc for Scala programming, offering a more simplified and widely-used syntax compared to the older Wikidoc format. While Wikidoc provided advanced features for organizing large documentation volumes, Markdown's simplicity and readability make it a more accessible choice for code comments, already familiar to developers through its use in README and other documentation files. In Scala 3, Markdown becomes the default syntax for Scaladoc, allowing for easy formatting of headers, lists, block quotes, text styles, links, code anchors, and tables, with backward compatibility to Wikidoc available via a specific directive. The IntelliJ Scala Plugin aids in this transition by automatically supporting Markdown syntax and offering multiple ways to render Scaladoc directly in the editor, enhancing the documentation process for developers.