You can now add a Markdown-formatted description to your styleguide, which allows your team to more formally document the resources available there.
Here, you can mention topics like: design philosophy, how the styleguide should be applied across the product, best practices and so on.
Using Markdown, you can organize and stylize the content so it can easily be read and referenced by your team.
Commonly used Markdown features:
# in front of some text to provide emphasis. You can even use multiple
# to add hierarchy.
# Ice Cream
## Ice Cream
### Ice Cream
You can wrap your text with
** to make it bold.
_ around your text to italicize it.
~ around your text to add a strike through it.
Add a code block by wrapping the text with
> in front of a block of text will show it indented.
You can also add links, images, GIFs, videos and so on.
For more details, check out: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet