How to Add New Articles

Quick Start

1. Create a new .md file in this directory
2. Use the frontmatter template below
3. Write your article in Markdown
4. Save the file - it will automatically appear on the articles page!

Frontmatter Template

---
title: "Your Article Title"
excerpt: "A brief description (150-160 characters for SEO)"
category: "Basics" | "Medications" | "Triggers" | "Emergency" | "Veterinary" | "Lifestyle"
publishedAt: "2025-01-15T00:00:00Z"  # ISO date format
author: "PupPal Team"  # Optional, defaults to "PupPal Team"
tags: ["tag1", "tag2", "tag3"]  # Optional
featured: true  # Optional, shows in featured section
metaDescription: "SEO description (150-160 chars)"  # Optional, uses excerpt if not provided
metaKeywords: ["keyword1", "keyword2"]  # Optional, for SEO
---

# Your Article Title

Your article content goes here in Markdown format...

Categories

• Basics: General epilepsy information, types of seizures, diagnosis
• Medications: Medication guides, dosing, side effects
• Triggers: Identifying and managing triggers
• Emergency: Emergency care, when to seek help
• Veterinary: Working with vets, communication
• Lifestyle: Quality of life, daily care, living with epilepsy

SEO Best Practices

1. Title: Include primary keyword naturally
2. Excerpt: 150-160 characters, compelling and keyword-rich
3. Meta Description: Unique, includes keywords, call to action
4. Content:
   • Use H1, H2, H3 headings
   • Include keywords naturally
   • Aim for 1,500-2,500 words
   • Add internal links to other articles
   • Link to PupPal features/app where relevant

File Naming

• Use lowercase
• Use hyphens for spaces
• Example: understanding-canine-epilepsy.md
• The filename becomes the URL slug

Example Article Structure

---
title: "Your Article Title"
excerpt: "Brief description..."
category: "Basics"
publishedAt: "2025-01-15T00:00:00Z"
featured: true
---

# Main Heading

Introduction paragraph...

## Section Heading

Content here...

### Subsection

More content...

## Conclusion

Wrap up with a CTA to sign up for PupPal.

Tips

• Read time is calculated automatically (200 words/minute)
• Slug is generated from filename
• Related articles are automatically suggested based on category and tags
• Featured articles appear at the top of the articles page
• Use internal links to other articles: [link text](/articles/article-slug)
• Use app links for CTAs: [Sign up](/register)

Need Help?

Check existing articles for examples of formatting and structure.