<img src="https://github.com/RickStrahl/MarkdownMonster/raw/master/Art/MarkdownMonster_Icon_128.png" align="right" style="height: 64px"/>
# Welcome to Markdown Monster
Here are a few tips to get you started:
* To create a **New Document** press **Ctrl-N** or **click @icon-plus-circle** on the toolbar
* To toggle the **HTML Preview** press **F12** or click @icon-globe in the Window bar
* To toggle the **Folder Browser Sidebar** press **Ctrl-Shift-B** or click **@icon-bars**
* The **@icon-bars SideBar** also holds **Favorites** and **Markdown Document Outline**
* To change **UI Themes**, click on the dropdown lists on the bottom right status bar:
* For **light editor themes** look at `visualstudio`, `github` or `xcode`
* For **dark editor themes** look at `vscodedark`, `twilight`, `monokai`, `terminal`
### Problems? Please let us know
If you run into any problems or issues, **please** let us know so we can address and fix them right away. You can report issues on GitHub:
* [Markdown Monster Bug Reports and Feature Requests](https://github.com/RickStrahl/MarkdownMonster/issues)
# Markdown Features
This topic is meant to give you a very basic overview of how Markdown works, showing some of the most frequently used operations.
### Bold and Italic
This text **is bold**.
This text *is italic*.
This text ~~is struck out~~.
### Header Text
# Header 1
## Header 2
### Header 3
#### Header 4
##### Header 5
###### Header 6
### Line Continuation
By default Markdown **adds paragraphs at double line breaks**. Single line breaks by themselves are simply wrapped together into a single line. If you want to have **soft returns** that break a single line, add **two spaces at the end of the line** <small>(shift-enter)</small> or use a backslash `\`.
---
This line has a paragraph break at the end (empty line after).
Theses two lines should display as a single
line because there's no double space at the end.
The following line has a soft break at the end (two spaces or a `\` at end)
This line should be following on the very next line.
You can also use `shift-enter` to inject the two spaces plus linefeed at the end of a line.
To show all white space and returns in a document you can use **View -> Show Invisible Characters**.
---
### Links
You can easily link using `[text](link)` sytnax:
[Markdown Monster Web Site](http://MarkdownMonster.west-wind.com/)
If you need additional image tags like targets or title attributes you can also embed HTML directly using raw HTML markup:
```html
Go to the
<a href="https://markdownmonster.west-wind.com" style="font-style: italic">
Markdown Monster Web Site
</a>
```
renders:
Go to the
<a href="https://markdownmonster.west-wind.com" style="font-style: italic">
Markdown Monster Web Site
</a>
---
### Images
Images are similar to links:
```markdown
```
which renders:
You can embed images from the Clipboard by pasting (**ctrl-v**), by using the @icon-image Image Dialog, or by dragging and dropping images into the document from the the Folder Browser, Windows Explorer or a
### Block Quotes
Block quotes are callouts that are great for adding notes or warnings into documentation.
Simple block quotes simply use a `>` to start a quote block:
```markdown
> **Note:** Block quotes can be used to highlight important ideas.
```
This renders to:
> **Note:** Block quotes can be used to highlight important ideas.
You can make quote blocks look nicer with headers and icons (using FontAwesome here):
```markdown
> ### @ icon-info-circle Headers break on their own
> Note that headers don't need line continuation characters
> as they are block elements and automatically break. Only text lines
> require the double spaces for single line breaks.
```
Note that lines automatically wrap in the quote block, if no newline with `>' is provided. Shown with the breaks here to make it easier to read. The following uses a single line for the second block which renders identically:
> ### @icon-info-circle Headers break on their own
> Note that headers don't need line continuation characters as they are block elements and automatically break. Only text lines require the double spaces for single line breaks.
### Fontawesome Icons
Markdown Monster includes custom syntax for FontAwesome icons in its templates. You can embed a `@ icon-` followed by a font-awesome icon name to automatically embed that icon without full HTML syntax.
```markdown
@ icon-gear Configuration
```
which renders:
---
@icon-gear Configuration
---
Note that this renders the following html:
```html
<i class="fa fa-gear"></i>
```
### Emojiis
You can also embed Emojiis into your markdown using the Emoji dialog or common
```markdown
:smile: :rage: :sweat: :point_down:
:-) :-( :-/
````
This renders:
---
:smile: :rage: :sweat: :point_down:
:-) :-( :-/
---
### HTML Markup
You can also embed plain HTML markup into the page if you like. For example, if you want full control over fontawesome icons you can use this:
This text can be **embedded** into Markdown:
```markdown
<i class="fa fa-refresh fa-spin fa-2x"></i> **Refresh Page**
```
<i class="fa fa-refresh fa-spin fa-2x"></i> **Refresh Page**
Note that blocks of raw HTML markup should be separated from text by empty lines above and below the HTML blocks.
### Comment Blocks - Keep Markdown from Rendering
Markdown has support for Html comments and you can use `<!--` for the beginning and `-->` for the end of a block of markdown that you don't want to render.
```markdown
### Commenting
This text and header renders fine.
<!--
This paragraph is commented out and **does not render**.
-->
This footer is comming across just fine.
```
This renders:
---
### Commenting
This text and header renders fine.
<!--
This paragraph is commented out and **does not render**.
-->
This footer is comming across just fine.
---
### Unordered Lists
```markdown
* Item 1
* Item 2
* Item 3
```
This renders:
---
* Item 1
* Item 2
* Item 3
---
This text is part of the third item. Use a soft return (`shift-enter` or two spaces or `\`) at end of the the list item to break the line and continue at the bullet indentation.
A double line break, breaks out of the list.
### Ordered Lists
Ordered lists use number like `1.` or `2.` for the bullet items.
```markdown
1. **Item 1**
Item 1 is really something
2. **Item 2**
Item two is really something else
```
renders to:
1. **Item 1**
Item 1 is really something
2. **Item 2**
Item two is really something else
If you want to lines to break (like after the bold headers) use soft returns.
> **Note**: Numbered lists **order themselves based on order** rather than the number you explicitly use. If you frequently reorder lists it's useful to number all items `1.`.
You can also nest lists and mix ordered and unordered lists:
```markdown
1. First, get these ingredients:
* carrots
* celery
* lentils
2. Boil some water.
3. Dump everything in the pot and follow
this algorithm:
```
This renders:
---
1. First, get these ingredients:
* carrots
* celery
* lentils
2. Boil some water.
3. Dump everything in the pot and follow
this algorithm:
---
### Inline Code
If you want to embed code in the middle of a paragraph of text to highlight a coding syntax or class/member name you can use inline code syntax:
```markdown
Inline code or member references like `SomeMethod()` can be codified...
```
---
Inline code or member references like `SomeMethod()` can be codified... You can use the `'{}'` menu or **Ctrl-\`** to embed inline code.
---
### Indented Code Blocks
Markdown supports code blocks syntax in a couple of ways:
Using and indented text block for code:
````markdown
Some rendered text...
// This is code by way of four leading spaces
// or a leading tab
int x = 0;
string text = null;
for(int i; i < 10; i++;) {
text += text + "Line " + i;
}
More text here
````
renders:
---
Some rendered text...
// This is code by way of four leading spaces
// or a leading tab
int x = 0;
string text = null;
for(int i; i < 10; i++;) {
text += text + "Line " + i;
}
More text here
---
### Fenced Code Blocks with Syntax Highlighting
You can also use triple back ticks plus an optional coding language to support for syntax highlighting.
The following is C# code.
````markdown
```csharp
// this code will be syntax highlighted
for(var i=0; i++; i < 10)
{
Console.WriteLine(i);
}
```
````
which renders syntax colored code:
```csharp
// this code will be syntax highlighted
for(var i=0; i++; i < 10)
{
Console.WriteLine(i);
}
```
Many languages are supported: html, xml, javascript, typescript, css, csharp, fsharp foxpro, vbnet, sql, python, ruby, php, powershell, dos, markdown, yaml and many more. Use the Code drop down list to get a list of available languages.
You can also leave out the language to attempt auto-detection or use `text` for plain text:
````markdown
```text
robocopy c:\temp\test d:\temp\test
```
````
renders plain, but formatted text:
```text
robocopy c:\temp\test d:\temp\test
```
> **Note**: Prefer using `text` for non-highlighted syntax over no syntax as no syntax tries to auto-discover the syntax which often is not correct. Always be specific with syntax specified.
### Footnotes
Footnotes can be embedded like this:
Here is some text that includes a Footnote [^1] in the middle of its text. And here's another footnote [^2]. The actual footnotes render on the very bottom of the page.
[^1]: Source: [Markdown Monster Web Site](http://markdownmonster.west-wind.com)
[^2]: Source: [Markdown Monster Web Site](http://markdownmonster.west-wind.com)
### Pipe Tables
[Pipe Tables](https://github.com/lunet-io/markdig/blob/master/src/Markdig.Tests/Specs/PipeTableSpecs.md) can be used to create simple single line tables:
```markdown
|size | material | color |
|---- | ------------ | ------------|
|9 | leather | brown **fox** |
|10 | hemp canvas | natural |
|11 | glass | transparent |
```
---
|size | material | color |
|---- | ------------ | ------------|
|9 | leather | brown **fox** |
|10 | hemp canvas | natural |
|11 | glass | transparent |
> **Note:** Cell lines don't have to line up to render properly. Max columns in any row determines table columns for the entire table. Pipe tables also don't need leading and trailing pipes to render as tables, but make sure you check compatibility with your final rendering site.
### Grid Tables
[Grid Tables](https://github.com/lunet-io/markdig/blob/master/src/Markdig.Tests/Specs/GridTableSpecs.md) are a bit more flexible than Pipe Tables in that they can have multiple lines of text per cell and handle multi-line embedded Markdown text.
```markdown
+---------+---------+
| Header | Header |
| Column1 | Column2 |
+=========+=========+
| 1. ab | > This is a quote
| 2. cde | > For the second column
| 3. f |
+---------+---------+
| Second row spanning
| on two columns
+---------+---------+
| Back | |
| to | |
| one | |
| column | |
```
---
+---------+---------+
| Header | Header |
| Column1 | Column2 |
+=========+=========+
| 1. ab | > This is a quote
| 2. cde | > For the second column
| 3. f |
+---------+---------+
| Second row spanning
| on two columns
+---------+---------+
| Back | |
| to | |
| one | |
| column | |
> ### @icon-info-circle Use the @icon-table Table Editor
> For easier table data entry and pretty rendered tables you can use the table editor which provides grid based table data entry. You can use the table editor with **Pipe**, **Grid** and **HTML** tables.
>
Sign in with Wallet
Connect another wallet