Create Posts

Overview

Blog posts are a crucial part of your Jekyll website. This guide will help you create engaging and well-structured blog posts.

Directory Structure

• Posts are stored in the _posts/ directory
• Use the naming convention: YYYY-MM-DD-post-title.md

Blog Post File Structure

Filename Example

_posts/2025-01-28-ai-revolutionizing-education.md

Front Matter Configuration

---
layout: post
title: "AI Revolutionizing Education"
date: 2025-01-28
author: tortoiz-themes
categories: [technology, education]
tags: [AI, learning]
image: "/assets/images/blog/ai-education.webp"
description: "Exploring how artificial intelligence is transforming educational experiences."
reading_time: 5  # Optional: estimated reading time
featured: true   # Optional: highlight on homepage
---

Front Matter Parameters

• layout: Always use post for blog entries
• title: Descriptive, SEO-friendly title
• date: Publication date (YYYY-MM-DD)
• author: Link to author profile
• categories: Broad topic classifications
• tags: Specific keywords
• image: Featured image
• description: SEO meta description
• reading_time: Optional reading duration
• featured: Optional feature flag

Content Writing Tips

Markdown Formatting

# Main Heading

## Subheading

Regular paragraph text with **bold** and *italic* formatting.

### Lists
- Unordered list item
- Another list item

1. Ordered list item
2. Another ordered list item

### Code Blocks
```python
def example_function():
    return "Hello, World!"
```

### Links and Images
[Link to external resource](https://example.com)

![Image Description](/path/to/image.webp)

Best Practices

1. Use clear, engaging titles
2. Write comprehensive, valuable content
3. Include relevant images
4. Use headings for structure
5. Optimize for readability
6. Add meta description
7. Use categories and tags effectively

SEO Optimization

• Use keywords naturally
• Create descriptive titles
• Write compelling meta descriptions
• Use header tags (H1, H2, etc.)
• Include alt text for images

Workflow

1. Choose a topic
2. Create a new file in _posts/
3. Add front matter
4. Write content in markdown
5. Add images and formatting
6. Preview locally
7. Publish

Troubleshooting

• Verify file naming convention
• Check front matter syntax
• Ensure image paths are correct
• Test markdown formatting
• Validate categories and tags

Related Guides

• Creating Pages
• Author Pages
• Theme Configuration

Next Steps

• Draft your first blog post
• Use the provided template
• Customize to fit your content style