markdown.md

layout	title	parent	permalink
default	Markdown Magic	Frontend Stuff	/frontend-stuff/markdown

Markdown Magic

All the little things in markdown that we often forget...

Collapsable sections in markdown

This gist is helpful for github.com and gist.github.com specifically: markdown-details-collapsible.md

But the above doesn't work on my jekyll based github pages docs, so I found this: Jekyll Text Expand or Collapsible Markdown

Working Example

And that didn't work either 🙃 which was frustrating, so then I found this repo: github/jekyll-commonmark-ghpages

and the answer was this being added to my _config.yml for my jekyll site:

markdown: CommonMarkGhPages
commonmark:
  options: ["UNSAFE", "SMART", "FOOTNOTES"]
  extensions: ["strikethrough", "autolink", "table", "tagfilter"]

Then at last this worked in my markdown file:

Python3.12

Check out this bash syntax highlighted block:

  brew install [email protected]

Markdown for the above example:

  <details>
    <summary>Python3.12</summary>

    Below, you can change the first ``` to ```bash for syntax highlighting :)
    Checkout this regular code block:

    ```
    brew install [email protected]
    ```

  </details>

Sources to this page specifically if you want to look at the raw:

• docs/front_end/markdown.md on github.com
• RAW docs/front_end/markdown.md
• _config.yml.
• Finally, the link to this jekyll page.