How to write a blog

Many desktop publishing packages and web page editors now use Lorem Ipsum as their default model text, and a search for 'lorem ipsum' will uncover many web sites still in their infancy.

Berkay Askin
Berkay Askin
3 min read
Cover Image for How to write a blog

The first h2 header

Paragraphs are separated by a blank line.

2nd paragraph. Italic, bold, and monospace. Itemized lists look like:

  • this one
  • that one
  • the other one

Note that --- not considering the asterisk --- the actual text content starts at 4-columns in.

Block quotes are written like so.

They can span multiple paragraphs, if you like.

Use 3 dashes for an em-dash. Use 2 dashes for ranges (ex., "it's all in chapters 12--14"). Three dots ... will be converted to an ellipsis. Unicode is supported. ☺

An h2 header

Here's a numbered list:

  1. first item
  2. second item
  3. third item

Note again how the actual text starts at 4 columns in (4 characters from the left side). Here's a code sample:

As you probably guessed, indented 4 spaces. By the way, instead of indenting the block, you can use delimited blocks, if you like:

define foobar() { print "Welcome to flavor country!"; }

(which makes copying & pasting easier). You can optionally mark the delimited block for Pandoc to syntax highlight it:

import time # Quick, count to ten! for i in range(10): # (but not *too* quick) time.sleep(0.5) print(i)
```js filename="example.js" console.log('Hello') ```

An h3 header

Now a nested list:

  1. First, get these ingredients:

    • carrots
    • celery
    • lentils
  2. Boil some water.

Another h3 header

  • Dump everything in the pot and follow this algorithm:

    find wooden spoon uncover pot stir cover pot balance wooden spoon precariously on pot handle wait 10 minutes goto first step (or shut off burner when done)

    Do not bump wooden spoon or it will fall.

Notice again how text always lines up on 4-space indents (including that last line which continues item 3 above).

Here's a link to a website, to a local doc, and to a section heading in the current doc. Here's a footnote [^1].

[^1]: Some footnote text.

Table: Shoes sizes, materials, and colors.

(The above is the caption for the table.) Pandoc also supports multi-line tables:

git statusList all new or modified files
git diffShow file differences that haven't been staged

A horizontal rule follows.

Here's a definition list:

apples : Good for making applesauce.

oranges : Citrus!

tomatoes : There's no "e" in tomatoe.

Here's a "line block" (note how whitespace is honored):

| Line one | Line too | Line tree

and images can be specified like so:

Image from Unsplash

Image from Unsplash 2

Photo by Jeremy Bishop on Unsplash

Inline math equation: $\omega = d\phi / dt$. Display math should get its own line like so:

$$I = \int \rho R^2 dV$$

And note that you can backslash-escape any punctuation characters which you wish to be displayed literally, ex.: `foo`, *bar*, etc.



A note1


one or two tildes.




  • to do
  • done


  1. Big note.