Stimpunks Foundation

Mutual Aid and Human-Centered Learning for Neurodivergent and Disabled People

Stimpunks Markdown Page Style Guide

🗺️

Home/Field Guide / Editorial / Stimpunks.org House Style Guide / Stimpunks Markdown Page Style Guide

▶ Table of Contents

  1. Heading Structure
  2. Page Structure
  3. Intro Paragraph
  4. Lists
  5. Diagrams
  6. Internal Links
  7. Related Pages Section
  8. Pattern Page Template
  9. Recipe Page Template
  10. Environment Page Template
  11. Diagram Sections
  12. Tone and Voice
  13. Accessibility
  14. Page Length
  15. Final Rule

This guide ensures that Stimpunks pages remain consistent, readable, and accessible as the site grows.

The goal is simple:

Clear structure. Clear navigation. Easy scanning.

Heading Structure

Use only one H1 per page.

# Page Title
Intro paragraph.
## Section
Content.
### Subsection
Content.

Hierarchy:

H1 — Page title
H2 — Main sections
H3 — Subsections (optional)
H4 — Rare deeper subdivisions

Avoid skipping levels (for example H2 → H4).

Page Structure

Most pages should follow this structure.

# Page Title
Intro paragraph explaining the concept.
## The Core Idea
Explain the main concept clearly.
## Key Concepts or Patterns
List or describe the major ideas.
## Examples or Applications
Show how the idea works in practice.
## Related Pages
Link to relevant pages across the site.

Intro Paragraph

The introduction should:

  • explain the concept quickly
  • give context
  • orient the reader

Example:

# Monotropism
Monotropism describes how attention concentrates deeply on a small number of interests.  
It explains why sustained focus and interest-driven learning are common in autistic cognition.

Keep intros 2–4 sentences.

Lists

Use bullet lists for clarity.

- Monotropism
- Deep Attention
- Processing Time
- Attention Anchors

Use numbered lists only when order matters.

Diagrams

Use simple text diagrams when possible.

Example:

Attention
↓
Energy
↓
Regulation
↓
Environment

This keeps pages readable and accessible.

Use title links, not bare URLs.

Correct:

[Pattern 01 — Monotropism](/patterns/library/monotropism/)

Avoid:

https://stimpunks.org/patterns/library/monotropism/

This improves readability.

Most pages should end with a Related Pages section.

Example:

## Related Pages
- [Pattern Library](/patterns/library/)
- [Pattern Recipes](/patterns/recipes/)
- [Designing Attention Sanctuaries](/patterns/recipes/attention-sanctuaries/)
- [Cavendish Space](/cavendish/)

This strengthens the knowledge graph of the site.

Pattern Page Template

Use this structure for pattern pages.

# Pattern XX — Pattern Name
Intro paragraph describing the pattern.
## The Pattern
Explain the concept.
## Why It Matters
Describe the implications.
## Where It Appears
Examples of environments or situations.
## Related Patterns
Links to related patterns.
## Design Implications
How designers can respond.

Recipe Page Template

Recipe pages translate patterns into practical design.

# Designing Example Environment
Intro paragraph.
## The Goal
What the environment should achieve.
## Relevant Patterns
- Pattern A
- Pattern B
- Pattern C
## Design Moves
Concrete steps designers can take.
## Example Environments
Where this design might appear.
## Related Recipes
Links to other design recipes.

Environment Page Template

Environment pages describe real contexts.

# Neurodivergent Workplaces
Intro paragraph.
## The Challenge
What typical environments get wrong.
## Key Design Patterns
Patterns relevant to this environment.
## Design Strategies
Practical approaches.
## Example Spaces
Real-world implementations.
## Related Pages
Links to patterns and recipes.

Diagram Sections

Use diagrams sparingly but strategically.

Example:

## The Design Ladder
Experiences
↓
Patterns
↓
Recipes
↓
Environments
↓
Civilization

Diagrams help readers grasp the system architecture quickly.

Tone and Voice

Write in a tone that is:

  • clear
  • respectful
  • practical
  • hopeful

Avoid:

  • academic jargon when possible
  • overly technical language
  • long dense paragraphs

Prefer short paragraphs and strong structure.

Accessibility

To support accessibility:

  • keep paragraphs short
  • use headings frequently
  • avoid dense blocks of text
  • use clear language

Structure helps both humans and screen readers.

Page Length

Ideal page length:

800–1500 words

Longer pages should include clear sections and diagrams.

Final Rule

Every page should help the reader answer one question:

How does this help us design better environments for neurodivergent life?