How to Use Markdown with AI

Markdown turns a messy thought into useful AI context: purpose, boundaries, sources, requests, examples and review notes in one readable file.

Start the guide Build a starter file

For ordinary people, community groups, local builders and civic projects that need better prompts without giving up control.

Illustration of a markdown document feeding an AI context map with private and public record lanes

Private life stays private

Keep sensitive identity, care, health, home, family and personal context in files you control. Share only what has a reason and permission.

Public power leaves receipts

Public money, promises, claims, decisions, donations, lobbying, conflicts, corrections and procurement should leave a trail people can follow.

Why markdown works

Markdown is plain text with enough structure for people and AI agents to read the same document. It keeps context portable, inspectable and easy to revise.

Headings create structure

`#`, `##` and `###` show the AI what belongs together.

Frontmatter sets the scene

Small metadata blocks can name status, privacy, dates and review needs.

Requests stay clear

A file can separate context from the actual task you want AI to perform.

Sources build trust

Links, dates and notes help an agent check facts instead of guessing.

Review notes improve quality

Human checks, open questions and corrections keep the work honest.

Build it. See it. Use it.

Answer a few careful questions, then download a starter `.md` file you can keep, edit and feed into an AI chat or coding agent.

Open the builder

straddie-noticeboard-brief.md

---
title: "North Stradbroke Island Noticeboard Brief"
visibility: public_draft
status: needs_human_review
---

# Purpose
Help island locals understand what is happening.

## Context
- What changed
- Who it affects
- What needs checking

## Request For AI
Draft a plain-English Straddie notice.

## Source Links
- event organiser update
- official ferry or venue notice

## Review Notes
- Check dates
- Ask before publishing contact details

Use markdown across civic lanes

One format can hold many kinds of memory: private profiles, public noticeboards, game worlds, public ledgers and P4A braided-economy records.

How to Use Markdown with AI

Private life stays private

Public power leaves receipts

Why markdown works

Headings create structure

Frontmatter sets the scene

Requests stay clear

Sources build trust

Review notes improve quality

Build it. See it. Use it.

Use markdown across civic lanes

Private profile

Public noticeboard

Game worlds

Public ledgers

Braided economy / P4A