Markdown syntax

Markdown is a text formatting syntax inspired by plain text emails. In the words of its creator, John Gruber:

The idea is that a Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions.

Inlines

Strong

  • Mac: + b
  • Win & Linux: Ctrl + b

Use two *s or _s for strong: strong and strong

**strong**
__strong__

Emphasis

  • Mac: + i
  • Win & Linux: Ctrl + i

Use one * or _ for emphasis: emphasis and emphasis

*emphasis*
_emphasis_

Inline code

  • Mac: + e
  • Win & Linux: Ctrl + e

Use ` for inline code: inline code

`inline code`

Strikethrough

  • Mac: + + x
  • Win & Linux: Alt + Shift + x

Use two ~s for strikethrough: delete this text

~~delete this text~~

Links

  • Mac: + k
  • Win & Linux: Ctrl + k

Use [text](url) or [text](url "title") for links.

[link text](https://url.com/ "title")
[link text](https://url.com/)
<https://url.com>

Learn more about links in Typlog.

Images

Use ![text](url) or ![text](url "title") for images.

![alt text](https://path/to/img.jpg)

An image with a "title" will be shown as a <figcaption>:

![alt text](https://path/to/img.jpg "title")

An Image Gallery can be formed by using multiple images:

![alt](/img/src) ![alt](/img/src)
![alt](/img/src)

Learn more about images in Typlog.

Headings

Use #s for headings.

Shortcuts for Mac
  • H1: + + 1
  • H2: + + 2
  • H3: + + 3
  • H4: + + 4
  • H5: + + 5
  • H6: + + 6
Shortcuts for Windows & Linux
  • H1: Alt +Shift + 1
  • H2: Alt +Shift + 2
  • H3: Alt +Shift + 3
  • H4: Alt +Shift + 4
  • H5: Alt +Shift + 5
  • H6: Alt +Shift + 6
# h1
## h2
### h3
#### h4
##### h5
###### h6

Lists

There are two types of list, ordered and unordered.

Ordered Lists

  • Mac: + + o
  • Win & Linux: Alt + Shift + o

Ordered list without paragraphs:

  1. foo
  2. bar
  3. baz
1. foo
2. bar 
3. baz

Unordered Lists

  • Mac: + + u
  • Win & Linux: Alt + Shift + u

Unordered list with paragraphs:

  • foo

    With multiple paragraphs.

  • bar

* foo

  With multiple paragraphs.

* bar

Mixed and Nested Lists

You can mix and nest lists:

* Abacus
  * anser
* Bubbles
  1. bunk
  2. bupkis
    * bar
  3. burper
* Cunning

Blockquotes

  • Mac: + + q
  • Win & Linux: Alt + Shift + q

Use > for blockquotes:

Email-style angle brackets are used for blockquotes.

> Email-style angle brackets
> are used for blockquotes.

> > And, they can be nested.

> #### Headers in blockquotes
> 
> * You can quote a list.
> * Etc.

Horizontal Rules

  • Mac: + + Enter
  • Win & Linux: Alt + Shift + Enter

Use three or more dashes or asterisks at the start of a line for horizontal rules: ---

---
***

Manual Line Breaks

  • Mac, Win & Linux: Shift + Enter

Use the keyboard shortcut, or end a line with two or more spaces:

Roses are red,
Violets are blue.

Roses are red, [space][space]
Violets are blue. [space][space]

Block code

Use more than tree ` or ~ for code block:

```
def hello():
    print('hello')
```

You can learn about fenced code in advanced markdown syntax.

Footnotes

Use [^key] for footnotes:

Here is a footnote1. (It's better to use word-word style keys.)

Here is a footnote[^key]. (It's better to use `word-word` style keys.)

[^key]: Some explanation.

Typlog is powered by the Mistune Markdown parser.

  1. Some explanation.

Read more