Hiding long sections partially

[ojacques]

Hello mkdocs-material community!

I write documentation and tutorials which may have long sections, between two options. For example:

You could do it this way:

- long set of instructions

Or this other way:

- Another long set of instructions

I would like the ability to partially hide long sections of texts.
I say "partially", as I still want to see an abstract of the text in this partially hidden section, so that my readers can judge whether they need to see and read what's next.

What is unique here is that the section is not entirely hidden, but reveals few lines, with a nice gradient.

An example on how this is done on this AWS documentation site:

As you can see, some sections are partially hidden, until the reader presses "Show more", which unfolds the section.

One can then click "Show less" to fold the section back.

I could not find a way to do this. It may be fiddling with PyMDown details extension or blocks, but I could not figured it out.

Any idea? Thanks.

[squidfunk]

You can open a feature request if you like – I may have an idea how this can be done in a good and compatible way ☺️