Quick Guide - Creating Posts in Jekyll

Creating a New Post in Jekyll

Basic Steps

Start the server with bundle exec jekyll s for a localhost.

1. Navigate to your _posts folder:

   cd _posts
   

2. Create a new file with the following naming pattern:

   YYYY-MM-DD-title.md
   

   For example: 2025-02-10-hellothere.md

Extended Front Matter Options

---
# Basic Options
title: Your Post Title
date: 2024-02-10
categories: [Main Category, Sub Category]
tags: [tag1, tag2]

# Additional Options
author: your_name
pin: true    # pins post to top
math: true   # enables math formatting
mermaid: true # enables mermaid diagrams
image:
  path: /path/to/image.jpg
  alt: Image description
---


#### Markdown Tips
```md
## Second Level
### Third Level
#### Fourth Level

To create code blocks, just then write bash, md for markdown, html, mermaid for mermaid etc. then close it with

Text Formatting

**Bold Text**
*Italic Text*
`inline code`

Code Blocks

def hello():
    print("Hello World!")

Links and Images

[Link Text](URL)
![Image Alt Text](/path/to/image.jpg)

Lists

1. First item
2. Second item
   - Sub-item
   - Another sub-item
3. Third item

Remember to check the post in your local server before pushing to GitHub!

Push to deploy to Github

Navigate to the github/workflows folder pages-deploy.yml

Its going to run a deployment script to push it to Github pages.

git status

git add .

git status

This should be green, so these files are “staged”.

git commit -m "feat(post):Hello There!"

Commiting and giving it a comment. Then push with

git push