Submit an article

Article format guide

Every article is a plain text file (a "markdown" file, ending in .md) with two parts: a block of details at the top, and your article text below it. You can write it in any plain text editor — Notes, TextEdit, Notepad, VS Code, or similar. Don't use Word or Google Docs, since they save extra formatting that breaks the file.

1. The details block

At the very top of the file, between two lines of three dashes (---), fill in these details about your article:

---
title: "Time Management for Students"
description: "Simple ways to plan your day and avoid last-minute stress."
category: "Time Management"
author: "Your Name"
readingTime: "5 min"
gradeRange: "Grades 3-8"
publishedDate: "2026-01-01"
accent: "sky"
---

• title — the article's headline
• description — one or two sentences, shown on the article card
• category — e.g. Time Management, Sleep, Study Skills, Organization, Goal Setting, Stress Management
• author — your name, or however you'd like to be credited
• readingTime — a rough estimate, like "4 min"
• gradeRange — who it's written for, e.g. "Grades 3-8"
• publishedDate — the date, as YYYY-MM-DD (we may adjust this when we publish)
• accent — a color for the article's tag: one of sky, blossom, sage, or stone — pick whichever you like

2. Adding a quiz (optional)

If you'd like to add a short quiz at the end of your article, add a quiz: section inside the same details block, right after accent. Spacing matters in this section, so it's easiest to copy the example below and edit it rather than typing it from scratch.

quiz:
  title: "Time Management Quiz"
  questions:
    - question: "What's a good first step for a new assignment?"
      options:
        - "Ignore it until it's due"
        - "Write it down with its due date"
        - "Ask a friend to do it"
        - "Wait for a reminder"
      correctAnswer: 1
      explanation: "Writing it down means you won't forget it later."

• title — a name for the quiz
• question — the question text
• options — a list of 2-4 possible answers
• correctAnswer — which option is correct, counting from 0 for the first one (so 1 means the second option)
• explanation — a sentence explaining why that answer is right, shown after someone answers

You can repeat the question / options / correctAnswer / explanation block as many times as you'd like — most of our quizzes have around 5 questions. If you don't want a quiz, just leave out the entire quiz: section.

3. Writing the article itself

After the closing ---, write your article in plain English:

This is a normal paragraph. Leave a blank line
between paragraphs, like this one.

## Use a heading for a new section

You can make text **bold** or *italic*.

- This is a list
- Second item
- Third item

A few tips: keep sentences short and clear, aim for something a 3rd-8th grader can follow, and if it's a sensitive topic (like sleep or stress), stick to general information rather than specific advice — we're not able to publish anything that reads as medical guidance.

Submit your article

Once your .md file is ready, attach it below. We'll email you a confirmation right away, and follow up once we've reviewed it.