Guide for your Markdown

Being the most beautiful and simple text-styling standard, Markdown's capabilities is rarely acknowledged among the people.

In today's blog, we are going to look through all the fantastic features in Markdown and their corresponding syntax. And the last one is the absolute beast: $$ | \,\mathfrak{beast}\, | $$

(Markdown's logo)

1. A text element

You can make H1 level title by just adding a hashtag, like # Title H1. The same with all the H2, ..., H6:

# Title H1
## Title H2
### Title H3
#### Title H4
##### Title H5
###### Title H6

Title H3

Hey I am some text.

Title H4

I am some more detailed text.

Title H5

This is very detailed text.

Title H6

This level of detail explores the limits of the human civilisation. Bet you're never using it. Except you are a doctorate student.

And if you start a line without anything, then it is automatically a paragraph. Remember to break lines twice for a new line.

2. A decorated text element

What follows are some very useful and beautiful elements in decoration. Their purpose, though, is to show text, anyways.

2.1. Emphasis

You can always apply them:

• **text** or __text__ for strong texts;

• *text* or _text_ for italic texts;

• ~~text~~ for ~~crossed-out text~~;

So you can of course combine ~~all of them~~.

Additionally, here are some features that Markdown doesn't support natively but you can insert as HTML:

• <u>text</u> for underlined texts;

• <sup>text</sup> for ^superscript;

• <sub>text</sub> for _subscript;

A strong advice from a mathematician: don't type math as plain text and worse if you additionally use ^superscript or _subscript (like 3x₁² + 2x₂³ = 0) !!! I will shout out crazily. Use embedded LaTeX code I'll introduce later.

2.2. Blockquotes

You can start a line with > Hello to add this blockquote:

Hello

Alternatively, you can just add 4 blank spaces World:

 World

2.3. Codes

Coders here! Follow this:

```language
code
```

And you can use three or more ``` backticks. That's how I can insert 3 backticks literally, without deformatting the whole thing. The language field can be The most advanced language on Earth, which is obviously cpp, and you can also make it python, javascript, html, etc. Some renderers can color the keywords, and some others don't. But it is a recommended practise not to leave language empty. For example:

 #include <iostream>
 using namespace std;
 int main() {
     cout << "You live in Matrix. And Matrix lives in C++." << endl;
     return 0;
 }

2.4. Lists

In HTML we call them

- unordered
- list

• unordered
• list

1. ordered
2. list

1. ordered
2. list

- [ ] task
- [x] list

• task
• list

2.5. Tables

Tables are very intuitive syntactically, but kind of ugly written down, especially if your table is big:

| Title | Description    |
| ----- | -------------- |
| John  | Broke student. |
| Lysha | Superwoman.    |

And it looks like:

3. Links & media

Of course we would love some link to other pages or simply add a photo, video, etc. In Markdown your wish is easily granted:

3.1. Links

[title](https://best.donut.com/)

And you get this: Best programming language redirector

3.2. Images

![Markdown's Logo.](https://upload.wikimedia.org/wikipedia/commons/4/48/Markdown-mark.svg)

The text inside the [] is the alternative text in case the image cannot display. It is like:

3.3. Videos

Unfortunately, Markdown doesn't natively support video linking. You can combine the links and images to make a image clickable, so you can redirect a preview image to an actual video site:

[![Preview Image](http://preview.image/link.jpg)](http://video.link/myvideo.mp4)

And you can of course simply insert the video using HTML code:

<video src="https://my.website/video.mp4"></video>

4. Absolute beast

The best wish to be asked for Christmas would be "writing LaTeX in Markdown", but it cannot longer be a wish – it is already granted!

Use $LaTeX code$ for inline LaTeX. And $$ LaTeX code $$ for block LaTeX: This is an inline hypothesis \(\forall n \in \mathbb{N}, \exists a,b \,\text{primes} : n=a+b\) (known as Goldbach hypothesis). An inline formula: \(x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}\).

And this is a (two-)block claim: $$ \forall q=\frac{p}{r} \in \mathbb{Q}, $$

(proven, you can try on your own, it is not too complicate, my proof is in this text)

Why "two-block"? Because in Markdown, a LaTeX code cannot have multiple lines, so you have to make multiple blocks.

5. What's more

5.1. Horizontal lines

You have multiple options here for the syntax: - Hyphens (I like this the most): --- - Asterisks: *** - Underscores: ___

They all produce a beautiful:

5.2. Footnotes

This is too research-heavy here. But indeed Markdown is giving you this option:

This has a footnote[^1].

[^1]: Footnote means note at the foot.

This has a footnote¹.

5.3. Thanks and good-bye

In fact, this document serves purposely as a test file for my blog's Markdown renderer 😂. Every time (ps: everytime is not correct, it should be separate) I optimize my renderer I need to see how the effects are improving via opening this text... Anyways, I hope this is helping you, and see ya next post!