So I recently made the switch from Maruku to Kramdown on Github Pages, and I ran into a problem:
Here's the markdown that's causing the problem:
Five days ago I wrote [Standardizing Harmony Classes]
(/standardizing-harmony-classes "Aadit M Shah | Standardizing Harmony Classes").
You see that pipe in "Aadit M Shah | Standardizing Harmony Classes"
? Kramdown erroneously treats it as a table cell separator resulting in the horrendous table above, which is actually supposed to be a paragraph.
This makes no sense because the pipe separator is inside a link text literal, and markdown should not be applied to link text literals. Clearly this is a bug in Kramdown.
So how do you disable tables in Kramdown Jekyll? There are lots of places where I have pipes and I don't wish to change them. Is there any other solution to this problem?
Escaping the pipes as Gaurav suggested doesn't work as the backslashes appear in the output, which is wrong.
Eventually I got so fed up with Kramdown that I shifted to Redcarpet instead. Now everything works like a charm.