# Help getting admonitions + pymdowns.details to work in docs

**URL:** <https://discourse.julialang.org/t/help-getting-admonitions-pymdowns-details-to-work-in-docs/10416>\
**Category:** General Usage\
**Tags:** documentation\
**Created:** [April 18, 2018, 4:14pm UTC](https://discourse.julialang.org/t/help-getting-admonitions-pymdowns-details-to-work-in-docs/10416 "2018-04-18T16:14:38Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![irislieuw](https://avatars.discourse-cdn.com/v4/letter/i/4bbf92/32.png) [@irislieuw](https://discourse.julialang.org/u/irislieuw)\
**Post date:** [April 18, 2018, 4:14pm UTC](https://discourse.julialang.org/t/help-getting-admonitions-pymdowns-details-to-work-in-docs/10416/1 "2018-04-18T16:14:38Z")

</div>

Hi all,

I’d like to use the [pymdownx.details](https://facelessuser.github.io/pymdown-extensions/extensions/details/) extension to create collapsible Admonition blocks in my julia docs. I’m currently using Julia 0.6 and Documenter.jl to generate the markdown files and am building docs with mkdocs.

This is the sort of docs string I’m writing:

```julia
"""
...

??? note
    Expand!

...
"""

```

However, the markdown gets generated like `??? note Expand!`, all on a single line, and mkdocs doesn’t generate the Details properly.

Has anyone gotten Admonition + Details blocs to render properly in their Julia docs?

Thanks

---

<div class="post-metadata">

**Author:** ![Datseris](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/datseris/32/13406_2.png) [@Datseris](https://discourse.julialang.org/u/Datseris)\
**Post date:** [April 18, 2018, 6:09pm UTC](https://discourse.julialang.org/t/help-getting-admonitions-pymdowns-details-to-work-in-docs/10416/2 "2018-04-18T18:09:05Z")

</div>

I 've also tried to use `details` for my docpages made through Documenter.jl+MkDocs+Material but so far it hasn’t worked out.

---

<div class="post-metadata">

**Author:** ![mortenpi](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mortenpi/32/158_2.png) [@mortenpi](https://discourse.julialang.org/u/mortenpi)\
**Post date:** [April 18, 2018, 10:57pm UTC](https://discourse.julialang.org/t/help-getting-admonitions-pymdowns-details-to-work-in-docs/10416/3 "2018-04-18T22:57:52Z")

</div>

The reason it doesn’t work right now is that Documenter works by parsing the source Markdown files into an AST (using the Markdown parser in Base), updates the AST and then prints it out as Markdown again. However, since the Markdown parser in `Base` does not support the `???` syntax, it just gets interpreted as a normal string and the newline information gets lost.

Ref: [https://github.com/JuliaDocs/Documenter.jl/issues/710](https://github.com/JuliaDocs/Documenter.jl/issues/710)