Table not render when use Redcarpet in Jekyll GitHub Pages?

Question

As of maruku engine (the default), writing table like

surround text, etc.

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

surround text...

would render correctly.

But when I switch to redcarpet (add markdown: redcarpet into _config.yml), the table no longer rendered, both localhost and on GitHub Pages.

Did I do something wrong?

no, that topic is not relate to jekyll, but it does gives me some hint. — neizod, Apr 21 '13 at 00:49

score 64 · Accepted Answer · answered Apr 21 '13 at 00:46

64

Adding only markdown: redcarpet into _config.yml is not enough, It's also need the extensions part, e.g.

markdown: redcarpet
redcarpet:
  extensions: ["no_intra_emphasis", "fenced_code_blocks", "autolink", "tables", "with_toc_data"]

answered Apr 21 '13 at 00:46

neizod

1,582
15
24

1

from the Jekyll documentation: http://jekyllrb.com/docs/configuration/#redcarpet And theese are the **Redcarpet extensions**, from the Readme : http://git.io/Xk0CQQ – agustibr Dec 02 '13 at 13:50

score 6 · Answer 2 · answered Jan 23 '15 at 16:44

For this question, it seems the important extension here is "tables".

However if you want more Github flavored markdown, there are a few more listed at http://sholsinger.com/2014/03/jekyll-github-flavored-markdown.

Combining with neizod's answer I ended up using.

markdown: redcarpet
redcarpet:
  extensions: ["no_intra_emphasis", "fenced_code_blocks", "autolink", "tables", "strikethrough", "superscript", "with_toc_data"]

score 2 · Answer 3 · edited Dec 08 '20 at 10:44

2

The redcarpet markdown engine is no longer supported by GitHub Pages and may cease working at any time.

A very straightforward solution is to delete the markdown setting in site's _config.yml file and instead have an extra line between the headline/text and the table.

You can get more information from github help and this solution was taken from this issue.

edited Dec 08 '20 at 10:44

Mohit Lamba

1,194
13
30

answered Oct 15 '17 at 08:32

loupipalien

29
2

score 0 · Answer 4 · edited May 23 '17 at 12:25

0

How to render table with Redcarpet and Markdown

Also, I can confirm Kramdown will do this.

edited May 23 '17 at 12:25

Community

1
1

answered Apr 19 '13 at 09:30

Zombo

1
62
391
407

score 0 · Answer 5 · answered Mar 15 '21 at 22:59

For anyone still running into this years later here's an example of how to fix it.

If your markdown is like this:

# My Favorite Books 
| Title | Description |
| ----- | ----------- |
| Attack Surface | A sci-fi book by Cory Doctorow showing how currently available tech can be used to oppress |

It will render fine on github.org but fail to render on github pages.

The solution is to ass a blank line above you table like so:

# My Favorite Books 

| Title | Description |
| ----- | ----------- |
| Attack Surface | A sci-fi book by Cory Doctorow showing how currently available tech can be used to oppress |

Thanks to LTChen's answer for putting me on the right track.

Table not render when use Redcarpet in Jekyll GitHub Pages?

5 Answers5

Linked