Almost every field on ReadMe supports GitHub Flavored Markdown.
You can learn about Markdown here: https://help.github.com/articles/markdown-basics/
You can learn about GitHub Flavored Markdown here: https://help.github.com/articles/github-flavored-markdown/
You can use emoji by wrapping the emoji's name in colons. For example,
:+1:. You can start typing
: in any Markdown field to see a filterable list. There's even some special ReadMe emoji, like
Font Awesome icons can also be used by typing
:fa-iconname: (such as
:fa-thumbs-up: for ) find all the icon names in this Font Awesome Cheatsheet.
We use Font Awesome version 4.3, newer icons are not supported
ReadMe uses a special format for linking to pages within ReadMe. You can type "[" to bring up the list of pages, and then type to filter that list.
ReadMe uses a special format for the elements you can drag and drop in the content editor, such as code samples, callouts, tables, images, and embedded URLs.
You can still use GitHub-flavored Markdown syntax for some of these elements (for example, triple backticks to denote block code samples). However, it's best practice to be consistent rather than mixing authoring methods.
Table of contents
ReadMe automatically creates a table of contents of each page, based on the headers you insert in the page. This page contents TOC shows up to the right of the text.
We changed all header types (#,##) to their own h1/h2/h3 settings. This might have changed a CSS setting that you already had. Here's what the defaults look like now:
Updated 8 days ago