What Markdown can do

Markdown was designed for the web, and also easy be read as plaintext. Basically, we need a parser to transfer markdown into HTML. There are many parsers for markdown, like kramdown, Python Markdown, etc. So, they might work differently.

It can embed HTML tags

Direct link:

wikipedia

Make a list

• Milk
• Bread
• Yogurt
• Nappy

We can Quote:

We do not grow absolutely, chronologically. We grow sometimes in one dimension, and not in another, unevenly. We grow partially. We are relative. We are mature in one realm, childish in another. —Anais Nin

Support Images:

responsive format:

Display programm code

You have to do is wrap your code in markdown code tags:

```c++
code code code
```

int main(int argc, char const \*argv[])
{
    string myString;

    cout << "input a string: ";
    getline(cin, myString);
    int length = myString.length();

    char charArray = new char * [length];

    charArray = myString;
    for(int i = 0; i < length; ++i){
        cout << charArray[i] << " ";
    }

    return 0;
}

Display line number

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
 
int main(int argc, char const \*argv[])
{
    string myString;

    cout << "input a string: ";
    getline(cin, myString);
    int length = myString.length();

    char charArray = new char * [length];

    charArray = myString;
    for(int i = 0; i < length; ++i){
        cout << charArray[i] << " ";
    }

    return 0;
}
 

Display liquid template code too

Using { % raw % } and { % endraw % } to wrap liquid code and then, the liquid code can display:

{% highlight c++ linenos %}
code code code
{% endhighlight %}

Support Mathjax

You just need to surround your math expression with $$, like $$ E = mc^2 $$. Example: \(E = mc^2\).

You can also use \begin{equation}...\end{equation} instead of $$ for display mode math. MathJax will automatically number equations:

\begin{equation} \label{eq:cauchy-schwarz} \left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right) \end{equation}

Adding DISQUS comments

Turn disqus_comments: true on at the Front Matter.

Adding table of contents

To add a table of contents to a post, add

toc:
  beginning: true

or

toc:
  sidebar: left

to the front matter of the post. The table of contents will be automatically generated from the headings in the post.

customized blockquotes

Like below:

> ##### WARNING
>
> This is a warning, and thus should
> be used when you want to warn the user
{: .block-warning }

WARNING

This is a warning, and thus should be used when you want to warn the user

> ##### DANGER
>
> This is a danger zone, and thus should
> be used carefully
{: .block-danger }

DANGER

This is a danger zone, and thus should be used carefully

Redirecting to another page

Add below in the front matter.

redirect: /assets/pdf/example_pdf.pdf

Display tables Bootstrap Tables

Using markdown to display tables is easy. Just use the following syntax:

| Left aligned | Center aligned | Right aligned |
| :----------- | :------------: | ------------: |
| Left 1       | center 1       | right 1       |
| Left 2       | center 2       | right 2       |
| Left 3       | center 3       | right 3       |

That will generate:

Video

It supports local video files.

It does also support embedding videos from different sources.

Audio

It supports local and external audio files.