we have a blog post written in markdown, which we would like to implement on our Jekyll page which is hosted on GithubPages.
Here an excerpt of the post:
Here is how it should look like (displayed on Github in a
pictures on stackoverflow as I am not allowed to post more pictures here: https://stackoverflow.com/questions/45782448/jekyll-markdown-not-displaying-like-the-original-and-general-style-problems
Here is how our final post.md looks on the hosted Jekyll page:
pictures at stackoverflow
We looked for hours how get this done and our results and realizations so far are:
- There doesn’t seem to be a reasonable way to implement posts written in markdown into Jekyll
- The result is quite unpleasant (lists messed up, codeblocks not super nice, weird spacings and vertical distances)
- I had to implement some
syntax.css to have the code blocks styled
- Jekyll forces us to use kramdown
- There is no easy to convert markdown to kramdown (kramdown seems to have different syntax in some places)
Also I don’t really get, why e.g. lists are rendered without any style, although they are correctly registered as ul li elements in the DOM. The
list-style: none;for the
<ul> elements comes from some inline
<style type="text/css"> rendered into the websites head. Don’t really know where it comes from, the main theme maybe?
[picture at stackoverflow]
Without this style tag at least the list look better…
I tried things like using kramdown=“1” attribute, playing around with the indents and dozens of other ‘tricks’ and structures.
- Is there any easy way to have real markdown rendered like on Github?
- How to know where this weird style tag comes from? How to exclude it?