A lightweight markup language
Post created on: 10/3/2021
Markdown was created in 2004 by John Gruber and Aaron Swartz as a lightweight markup language with the goal of enabling people to write using an easy-to-write and read plain text format with the option to convert it to structurally valid XHTML/HTML. There have several implementations since it was initially created with the need for additional features e.g. tables and footnotes.
Headings
Headings are indicated by #
these range from #
(h1) to ######
(h6)
# This top level h1 heading
## h2 heading
### h3
#### h4
##### h5
###### h6
Text Formatting
bold text - wrap text in double asterisks this text will be bold or double underscores and so will this
italic text - wrap text in underscores _text_
or single asterisk *more text*
so this is in italics and so is this text
Block quote
Use >
to create a blockquote which can be also be nested:
This will be a blockquote
> This is a block quote
>
>> This will be a nested quote
This is a block quote
This will be a nested quote
Lists
To create an unordered lists use -
- item 1
- item 2
- item 3
For ordered lists use 1., 2.
etc
1. item 1
2. item 2
3. item 3
Code Blocks
You can create code blocks by wrapping the text in 3 backticks ```
with the option to add language for syntax highlighting e.g. ```css
h1 {
font-size: 32px;
}
h2 {
font-size: 26px;
}
Links
To add links wrap text in square brackets []
and the url in ()
e.g.
[this is a link](https://duckduckgo.com 'DuckDuckGo') // use quotes to add an optional title to your link
Images
![alt text goes here](image url here "add title text here")
To add a link to an image use the syntax above but wrap in an additional set of []
brackets and ()
with the link e.g.
[![alt text goes here](image url here "add title text here")](add link here)
I particularly like using markdown for my blog posts because it is easy to use and makes formatting text and code blocks straightforward. I use prism to provide syntax highlighting for my code blocks for info on how to do this with nuxt check out the docs
If you're interested in learning more check out Markdown Guide and the cheat sheet