Highlight with blockquotes and admonitions

Blockquotes

Blockquotes can be created by using symbol > at the start of the line. For example the following markdown

> In order to understand recursion, one must first understand recursion.

In order to understand recursion, one must first understand recursion.

Of course, you can write multiple lines in the blockquote

> Measuring programming progress by lines of code is like measuring aircraft building progress by weight    
> **Bill Gates (co-founder of Microsoft)**

Starting every new line with > can be cumbersome, especially if you need to make line breaks

> ```
  If Internet Explorer is brave enough to ask to be your default browser, 
  you should be brave enough to ask that girl out.
  ```

Admonitions

Admonition is an extension to Markdown that looks shiny and attractive.

Admonitions are created with the following syntax:

!!! type "Title of Admonition"
    Something importatnt you want to highlight!

Admonition without text in the header

The following markdown snippet

!!! note 
    Admonition without text in the header 

Admonition without header

The following markdown snippet

!!! note ""
    Admonition without header 

Admonition with text and code

Include any code block directly inside the Admonition

!!! note
    In Python we use indentation instead of curly braces:
    ```python
    i = 1
    while i < 6:
        print(i)
        if i == 3:
            break
        i += 1
    ```
    If indentation is wrong, the python code will fail to execute

i = 1
while i < 6:
    print(i)
    if i == 3:
        break
    i += 1

Collapsible Admonition

Start Admonition with ???

??? type "Python generator example"
    A generator function that yields ints is secretly just a function that
    returns an iterator of ints, so that's how we annotate it
    ``` python
    def g(n: int) -> Iterator[int]:
        i = 0
        while i < n:
            yield i
            i += 1
    ```

def g(n: int) -> Iterator[int]:
    i = 0
    while i < n:
        yield i
        i += 1

Nested Admonition

You can create Admonitions inside other Admonitions

??? note "Open styled details"
    ??? danger "Nested details!"
        And more content again.

Admonitions with tabs

Using tabs inside Admonitions can be handy

!!! example "Recursion in markdown"
    === "Output"
        `#!py3 return True`

    === "Markdown"
        ` #!py3 return True `

Admonition types

There are numerous Admonition types that you can use to make important text stand out. Every Admonition starts with the type keyword following after !!! or ??? For example, Admonition of info type

!!! info 
    The wood frog can hold its pee for up to eight months.

Other Admonition types:

summary, abstract, tldr

tip, hint, important

success, check, done

question, help, faq

warning, caution, attention

failure, fail, missing

danger, error

bug

example

quote, cite