Hello MarkDown
2022-07-22 / WuChengKai

This theme’s markdown style test.

Basic styles

With this markup you can obtain simple emhpasis (usually rendered in italic text), strong emphasis (usually rendered in bold text), source code text (usually rendered in monospaced text), or strikethrough text (usually rendered with a line through text).

You may use also this or this notation to emphatize text, and you can use all them together (and you can mix * and _ )

If you look at the source code you may note that
even
if
you
break
the
lines,
the text is kept together
in a single paragraph

Paragraphs are delimited by blank lines, leading and trailing spaces are removed

You may force a line break with two spaces
or with a \
at the end of the line

Lists

To define a list of items, just put a *, a -, or a + at the start of the line of each item of the list followed by at least a space, to end the list, leave a blank line

  • red
  • green
  • blue
  • white
  • grey
  • black
  • yellow
  • pink
  • orange

You can also define numbered list, putting a number followed by a . or a ) and a space at the start of the line (you may use any number, the first one is taken to start counting, then it will increment by one):

  2. you may leave blank items
  1. or start
  2. again

You can insert any block inside a list, you have to respect the indentation of the text of the list item

  • A paragraph of text
    (spanning multiple lines),
    1
    fenced code,
    indented code (4 spaces + 2 spaces for the list 
indentation, one blank line above, one below),

    quotes,

    • another

      • list
        • (and so on…),

    • or headers

Headers

There are two ways to define headers:

The biggest possible header

You can also use this markup

(I prefer the first one as it’s more readable when looking directly at the source code)

A sub heading

This is the alternative format

Then you can go smaller

And smaller

And even smaller
No, you can’t go smaller than this

The good thing is that many tools that convert Markdown in HTML or PDF are able to generate the index of your document, or links to the headers automatically (like Github does on the source of Markdown files)

Source code

If you have to insert code in your document you have three choices:

  1. inline code like this: *Hello* **world!**"

  2. fenced code blocks (you may use ``` or ~~~
    as delimiters): 

    1
    *Hello* **world!**

  3. indented code blocks

    Hello

    world!

You need to leave a blank linke after a paragraph and 2 blank lines after a list to start an indented code block (if you want the code to be out of the list), and you may insert the name of the language immediatly after the opening code fence (so some renderers may be able to highlight the syntax of the language)

Blockquotes

In this way you define a quoted block of text.
You can skip the initial > in intermediate lines
if you are in the same paragraph

(you may nest levels)

> but you can't indent with more than 3 spaces
本文链接：https://wuchengkai.cn/hello-markdown/