Markdown Basics for GenAI Tools

Why Markdown Matters

Markdown is a simple way to format text using plain characters. It helps GenAI tools understand structure, sections, examples, source text, and reusable output patterns.

1. Headings: Organize Your Ideas

Use headings to divide content into clear sections.

# Main Title
## Major Section
### Subsection
#### Detail Section

Example

# Cell Respiration Lesson

## Learning Goal
Students will explain how cells release energy from glucose.

## Vocabulary
- Glucose
- Oxygen
- Carbon dioxide
- ATP

## Exit Ticket
Explain why cells need oxygen during respiration.

2. Paragraphs: Keep Them Short

Markdown paragraphs are regular text separated by blank lines.

This is one paragraph.

This is another paragraph.

Instead of this

Students will work in groups to read the article answer questions discuss their answers and then write a summary of what they learned about renewable energy sources and their impact on communities.

Use this

Students will work in groups to read the article.

They will answer discussion questions with their group.

Then, each student will write a short summary about renewable energy and its impact on communities.

3. Bold and Italics: Add Emphasis

**Important idea**

*Emphasized phrase*

Example

**Claim:** School start times should be later.

*Reason:* Students need enough sleep to learn effectively.

4. Bulleted Lists: Use for Simple Items

- Pencil
- Notebook
- Highlighter
- Chromebook

Example Prompt

Create a student-friendly checklist for this lesson.

Include:
- Materials
- Vocabulary
- Partner task
- Independent practice
- Exit ticket

5. Numbered Lists: Use for Steps

1. Read the passage.
2. Highlight key evidence.
3. Discuss with a partner.
4. Write a one-paragraph response.

GenAI Prompt Example

Create a lesson plan using these steps:

1. Begin with a hook.
2. Introduce three vocabulary terms.
3. Model one example.
4. Give students guided practice.
5. End with an exit ticket.

6. Blockquotes: Highlight Source Text or Notes

> This is a quoted passage or highlighted note.

Example

Read this sentence from the article:

> The river became polluted after chemicals entered the water supply.

Explain the cause-and-effect relationship in student-friendly language.

Blockquotes are useful when you want the AI to treat text as a passage, quote, note, or student sample.

7. Horizontal Lines: Separate Sections

---

Example

## Teacher Notes

Use this section for planning.

---

## Student Version

Use this section for student-facing directions.

8. Inline Code: Mark Commands or Exact Text

Use `Ctrl + C` to copy.

The file is named `lesson-plan.md`.

Example

In Mermaid, start a flowchart with `flowchart TD`.

9. Fenced Code Blocks: Preserve Exact Formatting

Code blocks are one of the most important Markdown features for GenAI tools.

```text
Put exact text here.
```

Use code blocks to preserve line breaks, indentation, prompts, source text, examples, and code.

Markdown Code Block Example

```markdown
# Lesson Title

## Objective
Students will identify the main idea of a nonfiction passage.

## Activity
- Read the passage.
- Highlight key details.
- Write a summary.
```

Other Labeled Code Blocks

```html
<h1>Hello, world!</h1>
```

```css
body {
  font-family: Arial, sans-serif;
}
```

```javascript
console.log("Hello, world!");
```

```python
print("Hello, world!")
```

10. Safe Prompt Pattern for GenAI

Separate your instructions from your source material.

You are helping me create a student-friendly reading activity.

## Task
Create a 6th-grade reading activity from the source text.

## Requirements
- Use simple language.
- Include 5 vocabulary words.
- Include 3 comprehension questions.
- Include 1 short writing prompt.

## Source Text
```text
Paste the article, passage, notes, or transcript here.
```

11. Tables: Organize Information Clearly

Markdown tables use pipes | and hyphens -.

| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1 | Detail | Detail |
| Row 2 | Detail | Detail |

Example

| Term | Student-Friendly Definition | Example |
|---|---|---|
| Claim | What you believe or argue | School lunches should be healthier. |
| Evidence | Facts that support your claim | A survey showed students want more fruit. |
| Reasoning | Explanation that connects evidence to claim | More fruit can help students make healthier choices. |

12. Tables for GenAI Prompts

Tables are excellent for giving AI tools structured requirements.

Create a rubric using this structure:

| Criteria | 4 - Advanced | 3 - Proficient | 2 - Developing | 1 - Beginning |
|---|---|---|---|---|
| Claim | Clear, specific, and arguable | Clear and arguable | Somewhat clear | Missing or unclear |
| Evidence | Strong, relevant evidence | Relevant evidence | Limited evidence | Little or no evidence |
| Reasoning | Explains evidence thoroughly | Explains evidence clearly | Explanation is basic | Explanation is missing |

Best Uses for Tables

• Rubrics
• Comparison charts
• Vocabulary lists
• Lesson plan outlines
• Assessment blueprints
• Choice boards

13. Checklists

Use - [ ] for unchecked boxes and - [x] for checked boxes.

- [ ] Read the article.
- [ ] Highlight three important details.
- [ ] Write one question.
- [ ] Share with a partner.

Example Prompt

Create a student checklist for revising an argumentative paragraph.

Use this format:

- [ ] My claim is clear.
- [ ] I included evidence.
- [ ] I explained how the evidence supports my claim.
- [ ] I checked spelling and punctuation.

14. Links and Images

Links

[Link Text](https://example.com)

Example

Read more at [NASA Climate Kids](https://climatekids.nasa.gov/).

Images

![Alt text describing the image](image-file.png)

Example

![Diagram of the water cycle](water-cycle.png)

15. Escaping Markdown Characters

Sometimes you want to show Markdown symbols without activating them. Use a backslash before the symbol.

\# This will not become a heading.

\* This will not become a bullet.

16. Common Markdown Mistakes

17. Prompt Template: Ask for Clean Markdown Output

Create the output in clean Markdown.

## Requirements
- Use `#`, `##`, and `###` headings.
- Use short paragraphs.
- Use bullets for lists.
- Use tables only when they make information easier to scan.
- Put copy-ready examples inside fenced code blocks.
- Do not use decorative symbols.
- Do not use emojis unless requested.
- Make the result easy to copy into a blog, LMS, Google Doc, or GitHub page.

## Topic
[Insert your topic here]

## Audience
[Insert your audience here]

## Purpose
[Insert what the output should help the reader do]

18. Prompt Template: Convert Notes into Markdown

Convert these rough notes into clean Markdown.

## Requirements
- Add a clear title.
- Organize ideas under headings.
- Use bullets for lists.
- Create a table if it helps compare ideas.
- Keep wording clear and concise.
- Preserve important details.

## Rough Notes
```text
Paste notes here.
```

19. Prompt Template: Create a Markdown Table

Turn this information into a clean Markdown table.

## Requirements
- Use short column headings.
- Keep each cell brief.
- Make the table easy to scan.
- Do not include long paragraphs inside cells.

## Information
```text
Paste information here.
```

20. Prompt Template: Create a Rubric in Markdown

Create a student-friendly rubric in Markdown.

## Audience
[Grade level or student group]

## Assignment
[Describe the task]

## Requirements
- Use a Markdown table.
- Include 4 performance levels.
- Use student-friendly language.
- Keep each cell short.
- Add a brief self-reflection checklist after the rubric.

## Criteria
```text
Paste criteria here.
```

21. Prompt Template: Create a Lesson Plan in Markdown

Create a lesson plan in clean Markdown.

## Topic
[Insert topic]

## Grade Level
[Insert grade level]

## Time
[Insert lesson length]

## Requirements
- Use clear headings.
- Include a learning objective.
- Include vocabulary.
- Include teacher steps.
- Include student tasks.
- Include checks for understanding.
- Include an exit ticket.
- Use tables only where helpful.

22. Before-and-After Example

Rough Prompt

make me a lesson about main idea with questions and stuff for 5th grade

Improved Markdown Prompt

Create a 5th-grade lesson on identifying the main idea in nonfiction text.

## Requirements
- Use clean Markdown.
- Include a learning objective.
- Include 3 vocabulary terms.
- Include teacher modeling steps.
- Include guided practice.
- Include independent practice.
- Include 5 comprehension questions.
- End with an exit ticket.

## Format
```markdown
# Lesson Title

## Learning Objective

## Vocabulary

## Teacher Modeling

## Guided Practice

## Independent Practice

## Questions

## Exit Ticket
```

The improved version gives the AI a clear grade level, topic, output format, checklist, and Markdown structure to follow.

GenAI Markdown Rules of Thumb

1. Use headings to show structure.
2. Use bullets for scannable lists.
3. Use numbered lists for ordered steps.
4. Use code blocks for exact text, prompts, code, or templates.
5. Use tables for comparisons, rubrics, and structured information.
6. Keep table cells short.
7. Separate instructions from source material.
8. Label code blocks when possible.
9. Avoid decorative formatting.
10. Make the output easy to copy and reuse.

Practice Activity

Use Markdown to create a prompt for a GenAI tool. Your prompt should include a title, task, audience, requirements, source text, and requested output format.

# GenAI Task Prompt

## Task
Create [type of output] about [topic].

## Audience
This is for [grade level or audience].

## Requirements
- Requirement one
- Requirement two
- Requirement three

## Source Text
```text
Paste source text here.
```

## Output Format
Use clean Markdown with:
- Headings
- Bullets
- A table if helpful
- A short summary

Final Tip

Markdown works best when it is simple. Clear headings, short lists, clean tables, and well-labeled code blocks help both people and GenAI tools understand exactly what you want.