Examples

This page shows examples of different text formatting options available within the MKDocs framework.

Hyperlink

This text gets displayed and takes you to Google when clicked.

Image

Admonitions

Quote

This is a quote.

Example

This is an example.

Note

This is a note.

Abstract

This is an abstract.

Info

This is info.

Tip

This is a tip.

Success

This is successful.

Question

This is a question?

Warning

This is a warning!

Failure

This is a failure.

Danger

This is dangerous.

Bug

This is a bug.

Code Annotation Examples

Codeblocks

Some code goes here.

Plain codeblock

A plain codeblock:

Some code here
def myfunction()
// some comment

Code for a specific language

Some more code with the py at the start:

import tensorflow as tf
def whatever()

With a title

bubble_sort.py

def bubble_sort(items):
    for i in range(len(items)):
        for j in range(len(items) - 1 - i):
            if items[j] > items[j + 1]:
                items[j], items[j + 1] = items[j + 1], items[j]

With line numbers

def bubble_sort(items):
    for i in range(len(items)):
        for j in range(len(items) - 1 - i):
            if items[j] > items[j + 1]:
                items[j], items[j + 1] = items[j + 1], items[j]

With highlighted lines

def bubble_sort(items):
    for i in range(len(items)):
        for j in range(len(items) - 1 - i):
            if items[j] > items[j + 1]:
                items[j], items[j + 1] = items[j + 1], items[j]

With title, line numbers, and highlighting

def bubble_sort(items):
    for i in range(len(items)):
        for j in range(len(items) - 1 - i):
            if items[j] > items[j + 1]:
                items[j], items[j + 1] = items[j + 1], items[j]