MultiQC logo

Contributing

Docs / Development

Guides for how to contribute to the MultiQC code base

Documentation

Admonitions

Admonitions, sometimes known as call-outs, can be used to highlight relevant information in the docs so that it stands out of the main flow of text.

The MultiQC website uses remark-directive to add a set of custom styled admonition directives to markdown syntax, shown below.

Notes

:::note
He had half a mind just to keep on `falling`.
:::
Note

He had half a mind just to keep on falling.

Info

:::info
His face froze for a second or two and then began to do that terribly slow crashing `trick` that Arctic ice floes do so spectacularly in the spring.
:::
Info

His face froze for a second or two and then began to do that terribly slow crashing trick that Arctic ice floes do so spectacularly in the spring.

Tip

:::tip
Her remark would have commanded greater attention had it been generally realized that human beings were only the third most intelligent life form present on the planet Earth.
:::
Tip

Her remark would have commanded greater attention had it been generally realized that human beings were only the third most intelligent life form present on the planet Earth.

Success

:::success
“I’m afraid you cannot leave,' said Zarniwoop, 'you are entwined in the Improbability Field. You cannot escape.'
:::
Success

“I’m afraid you cannot leave,’ said Zarniwoop, ‘you are entwined in the Improbability Field. You cannot escape.’

Warnings

:::warning
He smiled the smile that Zaphod had wanted to hit and this time `Zaphod` hit it.
:::
Warning

He smiled the smile that Zaphod had wanted to hit and this time Zaphod hit it.

Danger

:::danger
One of the troublesome circumstances was the Plural nature of this Galactic Sector, where the possible `continually` interfered with the probable.
:::
Danger

One of the troublesome circumstances was the Plural nature of this Galactic Sector, where the possible continually interfered with the probable.

Custom titles

:::note{title="Don't Panic"}
Arthur Dent was grappling with his consciousness the way one grapples with a lost bar of soap in the bath. He lay, panting heavily in the wet air, and tried feeling bits of himself to see where he might be hurt. Wherever he touched himself, he encountered a pain. After a short while he worked out that this was because it was his hand that was hurting. Arthur nodded intelligently. Today was one of those bad days.
:::
Don't Panic

Arthur Dent was grappling with his consciousness the way one grapples with a lost bar of soap in the bath. He lay, panting heavily in the wet air, and tried feeling bits of himself to see where he might be hurt. Wherever he touched himself, he encountered a pain. After a short while he worked out that this was because it was his hand that was hurting. Arthur nodded intelligently. Today was one of those bad days.