Admonitions in docstring are not rendered correctly

[BenjaminBorn]

Admonitions in a docstring like !!! note don't seem to be rendered in the Jupyter Notebook (see screen shot)

In the REPL and Juno, this example is rendered correctly.

My system:

Julia Version 0.6.0
Commit 903644385b (2017-06-19 13:05 UTC)
Platform Info:
OS: macOS (x86_64-apple-darwin16.6.0)
CPU: Intel(R) Core(TM) i7-6700K CPU @ 4.00GHz
WORD_SIZE: 64
BLAS: libopenblas (USE64BITINT DYNAMIC_ARCH NO_AFFINITY Haswell)
LAPACK: libopenblas64_
LIBM: libopenlibm
LLVM: libLLVM-3.9.1 (ORCJIT, skylake)

[stevengj]

It looks like Jupyter's Markdown renderer doesn't support !!! admonitions. If you enter the same thing in a markdown cell in the notebook it also doesn't work for me.

I think the root problem here is that !!! doesn't seem to be standard Markdown; it seems Julia-specific.

[BenjaminBorn]

Ok, thanks for the quick reply. Is there any way we could adapt the standard Markdown of the notebook to Julia idiosyncrasies?

[stevengj]

Base.Markdown could be upgraded to support better conversion to other MIME types, I guess.

[stevengj]

See also jupyter/notebook#1292 … it doesn't seem like admonition support is coming to Jupyter any time soon 😢.