Basic Markdown Formatting
Doks uses Goldmark markdown which is primarily Github-flavoured.
The examples below follow our Style Guide.
Headings
Warning: We do not allow# Header 1
sizing, this should only be added by the title of the article, use## Header 2
sizing and below for in-article headers.
Headings in markdown can be added using the #
character at the beginning of a line of text, the more#
you use the smaller the heading will be.
All headers, once rendered, in an article can be permalinked to easily share a specific topic quickly.
## Example Header 2
### Example Header 3
This would render as:
Example Header 2
Example Header 3
Emphasis
Markdown allows you to add emphasis to text in line using *
at both ends of some text.
Emphasis includes Bolding and Italicizing but not Underlining.
*This is italicized*
**This is bolded**
***This is both italicized and bolded***
This is italicizedThis is boldedThis is both italicized and bolded
Linebreaks
While Markdown is usually very respectful of where a new line should be implemented it is sometimes necessary to add artifical breaks.
This can be done using the <br>
tag.
This is<br> a line break
This is
a line break
Creating Lists
You can create both ordered lists and unordered lists with markdown.
Ordered Lists
Ordered lists can be created either specific numbers.
1. This is
2. An Example
3. Of an Ordered List
- This is
- An Example
- Of an Ordered List
Unordered Lists
Unordered Lists can be created using *
at the beginning of a line.
* This is
* An Example
* Of an Unordered List
- This is
- An Example
- Of an Unordered List
Sub-Items in a List
You can also make sub-items in either ordered or unordered lists indenting by a tab.
* This is
* An Example
* Of sub items
* And how to format them
* In an Unordered List
- This is
- An Example
- Of sub items
- And how to format them
- Of sub items
- In an Unordered List