Welcome to My Blog
A comprehensive guide to getting started with Jekyll and the Chirpy theme
Welcome to My Blog! π
This is my first post using Jekyll with the Chirpy theme. Iβm excited to share my thoughts and experiences here.
What is Jekyll?
Jekyll is a static site generator that transforms your plain text into static websites and blogs. Itβs perfect for:
- Fast loading - No database queries or server-side processing
- Secure - No dynamic content means fewer security vulnerabilities
- Version control friendly - Everything is stored as files
- Free hosting - Works great with GitHub Pages
Getting Started with Chirpy
The Chirpy theme provides a beautiful, responsive design with many features:
Key Features
- π Dark/Light mode toggle
- π± Mobile responsive design
- π·οΈ Tag and category support
- π¬ Comment system integration
- π Search functionality
- π Table of contents generation
Basic Post Structure
Every Jekyll post starts with front matter (the YAML section at the top of this file). Hereβs what each field does:
1
2
3
4
5
6
7
8
9
10
11
---
title: Your Post Title
date: 2024-11-02 15:30:00 +0800
categories: [Category1, Category2]
tags: [tag1, tag2, tag3]
author: Your Name
description: Brief description of your post
image:
path: /assets/img/your-image.jpg
alt: Image description for accessibility
---
Writing Content
Text Formatting
You can use standard Markdown formatting:
Bold text with **double asterisks**
Italic text with *single asterisks*
Strikethrough with ~~double tildes~~
Code Blocks
Inline code: console.log('Hello World')
Block code with syntax highlighting:
1
2
3
4
5
6
function greetUser(name) {
console.log(`Hello, ${name}!`);
return `Welcome to my blog, ${name}`;
}
greetUser('Reader');
Lists
Unordered Lists
- First item
- Second item
- Nested item
- Another nested item
- Third item
Ordered Lists
- First step
- Second step
- Third step
Links and Images
Blockquotes
This is a blockquote. Itβs great for highlighting important information or quotes from other sources.
You can have multiple paragraphs in a blockquote.
Tables
| Feature | Jekyll | WordPress |
|---|---|---|
| Speed | β‘ Fast | π Slower |
| Security | π High | β οΈ Medium |
| Hosting | π Free | π° Paid |
| Learning | π Steep | π Easy |
Mathematical Expressions
Chirpy supports MathJax for mathematical expressions:
Inline math: $E = mc^2$
Block math: \(\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n\)
Mermaid Diagrams
graph TD
A[Start] --> B{Is it working?}
B -->|Yes| C[Great!]
B -->|No| D[Debug]
D --> E[Fix Issues]
E --> B
Tips for Great Blog Posts
- Write compelling titles - Make readers want to click
- Use headings - Break up content for easy scanning
- Include images - Visual content increases engagement
- Add code examples - Show, donβt just tell
- Proofread - Check for typos and clarity
- Be consistent - Regular posting builds audience
Whatβs Next?
Iβm planning to write about:
- Web development tutorials
- Programming best practices
- Technology reviews
- Personal projects and experiences
Thanks for reading my first post! Feel free to leave comments or questions below.