Markdown .md
What is markdown and why its used
Basics
Headings
# Level 1 title (in Docusaurus used as the page title/name)
## Level 2 title
### Level 3 title
#### Level 4 title
Bold and Italic Text
To write bold text, wrap the text with **two asterisks**
to write italic text, wrap the text with _underline_
Links
[Markdown Guide: Getting started](https://www.markdownguide.org/getting-started/)
Inline Code
To use <inline code>
Wrap in backticks `, example:
To use `<inline code>`
Code blocks
For bigger code examples you can wrap your code in code blocks 3x backticks at start and end.
```
Example Code Block
```
Syntax Highlighting
if you are using a programming language like C#, you get sytnax highlighting by:
```csharp
using System;
namespace HelloWorld
{
class Program
{
static void Main(string[] args)
{
Console.WriteLine("Hello World!");
}
}
}
```
C-Sharp syntax highlighting is not supported by default.
To implement addtional languages refer to:
Admonitations
wrapping text with a set of 3 colons, followed by a label denoting its type. Following Types are supported
note
, tip
, info
, caution
, danger
Example
:::danger
Some **content** with _Markdown_ `syntax`.
:::
Shows like this:
Some content with Markdown syntax
.
Tables
| Syntax | Description |
| ----------- | ----------- |
| Header | Title |
| Paragraph | Text |
Will be rendered to this:
Syntax | Description |
---|---|
Header | Title |
Paragraph | Text |
Cell widths can vary, as shown below. The rendered output will look the same.
| Syntax | Description |
| --- | ----------- |
| Header | Title |
| Paragraph | Text |
Its recommended to use an editor what heps with formatting.
Editors
Editor to play around
Recommended Editor
- VSCode (Can be installed via Software Center)