I just installed Jekyll and when I run jekyll on a directory contains some .html.md file. But it didn't convert it into .html file. Jekyll just copied th files into _site directory as is.

I added _config.yml and added

markdown:        maruku

but it still doesn't convert Markdown into HTML.

What should I do more to make it work?

  • 1
    Does the file have a header specifying metadata, such as a layout or title? Commented Jan 26, 2012 at 5:53

1 Answer 1


A standard mistake that I've seen with new jekyll users (and did myself) was omitting the YAML front matter in the files to be converted. Each one should start with:

layout: default
title: Page/Post Title

This assumes you have a file in your "_layouts" directory called "default.html".

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .