Skip to main content

Markdown Cheat Sheet

This Markdown Cheat Sheet provides a comprehensive guide to the basics of markdown, including tips and tricks for formatting text, creating links, and much more.

To learn more about markdown visit www.markdownguide.org

Headings

To create headings, use the # symbol followed by a space and the heading text. The number of # symbols indicates the heading level, with one # being the largest and six # symbols being the smallest.

# This is an <h1> tag

## This is an <h2> tag

### This is an <h3> tag

#### This is an <h4> tag

##### This is an <h5> tag

###### This is an <h6> tag

This is an \<h1> tag

This is an \<h2> tag

This is an \<h3> tag

This is an \<h4> tag

This is an \<h5> tag
This is an \<h6> tag

Comment

[//]: # (This is a non-visible comment)

Emphasis

To add emphasis to text, you can use either * or _ to enclose the text that you want to emphasize. To create italic text, use a single * or symbol on either side of the text. To create bold text, use two * or `` symbols on either side of the text.

*This text will be italic*
_This will also be italic_

**This text will be bold**
__This will also be bold__

~~This text will be crossed out (strikethrough)~~

_You **can** combine them_

***All this text is bold and italic***

This text will be italic This will also be italic

This text will be bold This will also be bold

This text will be crossed out (strikethrough)

You can combine them

All this text is bold and italic

Lists

To create a bulleted list, use the - or * symbol followed by a space and the list item text.

Unordered

* Item 1
* Item 2
* Item 2a
* Item 2b
  • Item 1
  • Item 2
    • Item 2a
    • Item 2b
- Item 1
- Item 2
- Item 2a
- Item 2b
  • Item 1
  • Item 2
    • Item 2a
    • Item 2b

Ordered

1. Item 1
1. Item 2
1. Item 3
1. Item 3a
1. Item 3b
  1. Item 1
  2. Item 2
  3. Item 3
    1. Item 3a
    2. Item 3b

Images

To include an image in a document, use the ![image alt text](image URL) syntax.

Format:  ![Alt Text](url)
Example: ![Datenschmutz Logo](@site/static/img/dmz-logo-main-350x-border.png)

Datenschmutz Logo

To create a link, simply paste or use the [link text](link URL) syntax.

https://docsdatenschmutz.dev - automatic!

https://docs.datenschmutz.dev - automatic!

Format:  [Text](url)
Example: [Docs](https://docs.datenschmutz.dev)

Docs

Blockquotes

To create a blockquote, use the > symbol followed by a space and the quote text.

> Life is like riding a bicycle.
> To keep your balance, you must keep moving.

Albert Einstein

Life is like riding a bicycle. To keep your balance, you must keep moving.

Albert Einstein

Blockquotes can be nested.

> Dorothy followed her through many of the beautiful rooms in her castle.
>
>> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

Dorothy followed her through many of the beautiful rooms in her castle.

The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

Horizontal Rules

Horizontal rules can be created using three or more asterisks (***), dashes (---), or underscores (___) on a line by themselves.

*** 
----
______



Code blocks (Inline code)

To create a code block, enclose the code in backticks (`). To create a code block that spans multiple lines, enclose the code in three backticks (`) on either side.

I think you should use an `<addr>` element here instead.

I think you should use an <addr> element here instead.

No highlighting

```
if (isAwesome){
return true
}
```
if (isAwesome) {
return true
}

Highlighting

```javascript 
if (isAwesome){
return true
}
```
if (isAwesome) {
return true
}

Tabels

To create a table, use the pipe symbol (|) to separate the columns and the dash symbol (-) to create the table header.

| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell | Content Cell |
| Content Cell | Content Cell |
First HeaderSecond Header
Content CellContent Cell
Content CellContent Cell
| Left-aligned | Center-aligned | Right-aligned |
| :--- | :---: | ---: |
| git status | git status | git status |
| git diff | git diff | git diff |
Left-alignedCenter-alignedRight-aligned
git statusgit statusgit status
git diffgit diffgit diff

Your Markdown does't have to be pretty.

There must be at least 3 dashes separating each header cell. The outer pipes (|) are optional, and you don't need to make the table columns line up prettily.

Less | Pretty | Markdown 
--- | --- | ---
1 | 2 | 3
*Still* | `renders` | **as expected**
4 | 5 | 6
LessPrettyMarkdown
123
Stillrendersas expected
456

Blackslash escape

Markdown allows you to use backslash escapes to generate literal characters which would otherwise have special meaning in Markdown’s formating syntax.

NameMarkdownResult
backslash\\\
backtick\``
asterisk\**
underscore\__
curly braces\{\}{}
square brackets\[\][ ]
parentheses\(\)()
hash mark\##
plus sign\++
minus sign (hyphen)\--
dot\..
exclamation mark\!!

Task Lists

- [x] this is a complete item 
- [ ] this is an incomplete it
  • this is a complete item
  • this is an incomplete it

Inline HTML

Markdown also supports raw HTML.

<dl>
<dt>First Term</dt>
<dd>This is the definition of the first term.</dd>
<dt>Second Term</dt>
<dd>This is one definition of the second term. </dd>
<dd>This is another definition of the second term.</dd>
</dl>
First Term
This is the definition of the first term.
Second Term
This is one definition of the second term.
This is another definition of the second term.
<p>Markdown and HTML does *not* work **well**. Use <i>HTML</i> <b>tags</b> instead.</p>

Markdown in HTML does *not* work **well**. Use HTML tags instead.

Emoji

:+1: :sparkles: :camel: :tada: :rocket:

👍 ✨ 🐫 🎉 🚀