Syntax highlighting for indented code blocks

[christopher-dG]

The usual convention for docstrings is to do something like this:

"""
    myfunction(myarg::MyType) -> MyReturnType

My function.
"""

But when you do this instead of a triple-backticked code block, you lose out on syntax highlighting. Would it be possible to convert indented code blocks into backticked Julia ones?

[mortenpi]

The parser in the Markdown stdlib does not distinguish between triple-backticked and indented code blocks (i.e. the resulting AST is the same). So the only way to achieve this would be to always apply Julia highlighting to all code blocks that do not specify the language. However, I am a bit hesitant, as that goes against how Markdown code blocks are meant to be interpreted in my opinion.

I guess, another way would be to special-case this particular use case -- the first code block in a docstring gets highlighted as Julia (unless another language is explicitly specified).

Edit: OTOH, maybe we should default to Julia? Related recent discussion: JuliaLang/julia#31009 (comment)

[christopher-dG]

Thanks for this info. I'm also a little hesitant of defaulting to Julia, maybe an alternative could be an opt-in makedocs option which sets the default?
I do also like the special case idea.

[mortenpi]

We could have an opt-out special casing maybe?