{"repo":"oprypin/markdown-callouts","free":true,"listed":false,"github":"https://github.com/oprypin/markdown-callouts","clone":"git clone https://github.com/oprypin/markdown-callouts.git","description":"Markdown extension: a classier syntax for admonitions","language":"Python","stars":45,"topics":["markdown","mkdocs","markdown-extension","python-markdown","admonition"],"license":"MIT","category":"docs-static-sites","readme_excerpt":"markdown-callouts Extension for [Python-Markdown][]: a classier syntax for admonitions [python-markdown]: https://python-markdown.github.io/ [admonition]: https://python-markdown.github.io/extensions/admonition/ [properdocs]: https://github.com/ProperDocs/properdocs#readme [documentation site]: https://oprypin.github.io/markdown-callouts/ Installation If using [ProperDocs][], enable the extension in properdocs.yml : Continue to the [documentation site][]. Usage This adds a new block-level syntax to Markdown, to put a paragraph of text into a block that's specially highlighted and set apart from the rest of the text. Example: Result , using mkdocs-material : Collapsible blocks also have a syntax for them: This instead shows up as an initially-closed block. Graceful degradation This extension produces the same results as the [admonition][] extension, but with a syntax that is much less intrusive and has a very reasonable fallback look for \"vanilla\" renderers. E.g. compare what you would've seen above if we actually wrote that Markdown and fed it to GitHub's Markdown parser: \"Callouts\" syntax NOTE: Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor massa, nec semper lorem quam in massa. \"Admonition\" syntax !!! note Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor massa, nec semper lor","default_branch":null,"files":null,"tree":[],"storefront":"/r/oprypin","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/oprypin/markdown-callouts/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}