Markdown

A lot of the documentation we do for, and within, the WCRS repositories is done with markdown. This page, and those it links to, are intended to provide some assistance for working with markdown documents, locally on your computer, as well as on github, or other places.

From the wikipedia article:

Markdown is a lightweight markup language with plain text formatting syntax. … Markdown is often used to format readme files, for writing messages in online discussion forums, and to create rich text using a plain text editor.

Editing pages in the github repository wikis (like this one) defaults to using Markdown syntax for formatting. Other options are available from the Edit mode dropdown. Using the buttons on the editing toolbar just inserts the text of the markdown commands (tags) that would be used when creating markdown content manually.

Issues, pull requests, comments, and more on github support markdown formatting. Markdown has a basic set of features. As used on github, several extensions provide extra capabilities. Those extra features are available some places but not others. Or more often, the what works one place may not display quite the same in others. Tables seem to work most places, but the wiki is fussier about what it formats as a table than what work in a README.md file for the repository.

Since markdown starts as plain text, no knowledge of markdown syntax is needed to create content. Markdown just provides a way to enhance the formatting, to provide lists, code blocks, headers, italic, bold, clickable links and more. None of which is actually required.

Related Pages

• Editing
• Viewing
• Learning