Blog post not displaying

Help
10

Perhaps you can share the location, filename, and contents (or initial contents with the YAML front matter) so we can help you identify the problem? Most people put their website up on GitHub and then build from there, which is why you are being asked to share your repo. We can usually pull it down, take a look, and solve the problem for you.

If this continues and you need further help, it might be useful for you to – even temporarily – copy your Jekyll folder up to GitHub as a public repo, share the link, and we can take a look. If you need help with that, let us know. I agree with @rdyar; please do not share your VPS details with us as that would open up a lot of security concerns for you and anyone else involved :slight_smile:

The reasons for a post not showing up are often super basic, and you don’t even notice it at first. Here are all the checks I am used to doing:

  1. Make sure the file is in the ./posts folder. Also, sometimes people place the content in the ./_site folder accidentally, so do make sure it is in the root _posts folder, which I think you are doing
  2. As mentioned earlier, make sure the filename is in the form of yyyy-mm-dd
  3. Make sure the filename contains additional text after the date, without spaces, like this:
    2020-05-31-hello-world-sample-post. Technically, I am not sure if you can use spaces, but if you have any, remove them and replace them with dashes
  4. Make sure the filename has an extension of .md or .markdown, not .html or something similar. It should look like this:
    2020-05-31-hello-world-sample-post.markdown
    -or-
    2020-05-31-hello-world-sample-post.md
  5. At minimum, Make sure the front mater has a layout and a title, like this:
---
layout: default
title: This is my Hello World sample blog post
---
Welcome to my very first post! I am excited to share...
  1. If your YAML front matter contains any other content, try temporarily removing it. Maybe there is a problem. For example, just use the example I share above, where you just have the layout and the title
  2. While I doubt this is the problem, try deleting the front matter and hand-typing it from scratch just to be sure there aren’t some strange characters in there

I have encountered your issue before. It is almost always not naming the filename correctly and with the proper extension, or I accidentally put the file in the wrong location.

I hope this helps!

3 Likes