Comment by [deleted] on 17/11/2011 at 20:21 UTC*

24 upvotes, 3 direct replies (showing 3)

View submission: [reddit change] New markdown interpreter!

Special thanks to *AnteChronos*[1] for providing us with a benchmark and formatting guide[2] to the markdown system three years ago. Some markdown mentioned here is taken from his guide.

1: http://www.reddit.com/user/AnteChronos

2: http://www.reddit.com/comments/6ewgt/reddit_markdown_primer_or_how_do_you_do_all_that

--------------------------------------------------------------------------------

• *Differences from the old system**

--------------------------------------------------------------------------------

Our new system supports auto-linking to subreddits, for an example:

We have this new subreddit called /r/askreddit

produces:

We have this new subreddit called /r/askreddit

--------------------------------------------------------------------------------

The new system is a bit more whitespace senstive in some places. For an example:

Do not use

```

** This text is bold **

```

instead use:

```

**This text is bold**

```

Which produces:

**This text is bold**

--------------------------------------------------------------------------------

Nesting lists of two different types is no longer supported. Ie.

1. Item one
2. 
   * Item one
   * Item two
3. Item two

Will no longer produce an unordered list inside an ordered list.

--------------------------------------------------------------------------------

While I am on the subject, nesting lists of the same type is still supported. However, the formatting is a little more strict.

Instead of:

1. Ordered list item 1
2. 1. Bullet 1 in list item 2
   2. Bullet 2 in list item 2
3. List item 3

use

1. Ordered list item 1
2. 
    1. Bullet 1 in list item 2
    2. Bullet 2 in list item 2
3. List item 3

which produces:

1. Ordered list item 1

2. 1. Bullet 1 in list item 2 2. Bullet 2 in list item 2

3. List item 3

--------------------------------------------------------------------------------

Multiple paragraphs inside a list is no longer supported. Or rather, the old trick to make them work no longer works:

	
This item has multiple paragraphs.


(four spaces here)This is the second paragraph

	
Item 2

The above is no longer supported.

--------------------------------------------------------------------------------

Tables inside of block-quotes is still supported, however, the formatting is a little more strict.

Do not use:

 The code below:
 >some|header|labels
 :---|:--:|---:
 Left-justified|center-justified|right-justified
 a|b|c
 d|e|f

Instead use:

 The code below:
 >
 some|header|labels
 :---|:--:|---:
 Left-justified|center-justified|right-justified
 a|b|c
 d|e|f

Which produces:

┌────────────────┬──────────────────┬─────────────────┐
│      some      │      header      │     labels      │
╞════════════════╪══════════════════╪═════════════════╡
│ Left-justified │ center-justified │ right-justified │
├────────────────┼──────────────────┼─────────────────┤
│ a              │        b         │               c │
├────────────────┼──────────────────┼─────────────────┤
│ d              │        e         │               f │
└────────────────┴──────────────────┴─────────────────┘

--------------------------------------------------------------------------------

I should also mention that there is a small edge case glitch when trying to place tables inside of code blocks when the only thing inside the code block is a table. If you run into this, simply place some other small text inside the code block along with the table.

--------------------------------------------------------------------------------

A lot of broken tables are around. The problem is that the old system was accepting of incorrect tables. If you have four columns, use:

:---|:---|:---|:---

If you have five:

:---|:---|:---|:---|:---

etc, etc. If you have a post with this issue please simply correct the number of columns in your markdown.

Replies

Comment by Raerth at 17/11/2011 at 20:42 UTC

7 upvotes, 0 direct replies

Guess I'll have to change my one[1] too. :)

1: http://www.reddit.com/cw70q

Comment by roger_ at 18/11/2011 at 00:31 UTC*

3 upvotes, 1 direct replies

Nesting lists of two different types is no longer supported. Ie.

I guess that's why the /r/todayIlearned sidebar is now broken :(

• *EDIT**: (kinda) fixed it!

Comment by bboe at 29/11/2011 at 18:44 UTC*

1 upvotes, 1 direct replies

Test table as described:

┌────────────────┬──────────────────┬─────────────────┐
│      some      │      header      ���     labels      │
╞════════════════╪══════════════════╪═════════════════╡
│ Left-justified │ center-justified │ right-justified │
├────────────────┼──────────────────┼─────────────────┤
│ a              │        b         │               c │
├────────────────┼──────────────────┼─────────────────┤
│ d              │        e         │               f │
└────────────────┴──────────────────┴─────────────────┘

test table without headers

┌──┬──┬──┬──┬──┬──┐
│  │  │  │  │  │  │
���══╪══╪══╪══╪══╪══╡
└──┴──┴──┴──┴──┴──┘

The table without headers requires 2 additional '|' characters on the header line:

|||||
:-:|:-:|:-:|:-:
a|b|c|d
e|f|g|h