@jckhlry

Home

@jckhlry

Home

@jckhlry

Home

Go Back

<-

->

Markdown Document Style Prompts

Markdown Document Style Prompts

/

/

USING MARKDOWN DOCUMENT STYLE PROMPTS

THE CORE IDEA

Markdown-style prompts turn your instructions into a structured, readable document instead of a block of text or dense code.

Think of it like this:

  • Natural language = messy conversation

  • JSON = rigid machine instructions

  • Markdown = clean creative brief

Markdown sits in the middle — structured enough for clarity, flexible enough for creativity

WHY MARKDOWN WORKS SO WELL FOR PROMPTING

1. IT MATCHES HOW CREATIVES THINK

Designers don’t think in brackets and syntax.
They think in:

  • Sections

  • Hierarchy

  • Visual breakdowns

Markdown mirrors:

  • Creative briefs

  • Art direction docs

  • Moodboards (in written form)

That means:

→ Faster understanding
→ Better control
→ Less friction when iterating

2. INSTANT READABILITY

Compare this:

JSON

{  "subject": {    "type": "woman",    "location": "bathroom",    "pose": "holding product"  },  "lighting": {    "type": "natural",    "quality": "soft"  }}
{  "subject": {    "type": "woman",    "location": "bathroom",    "pose": "holding product"  },  "lighting": {    "type": "natural",    "quality": "soft"  }}
{  "subject": {    "type": "woman",    "location": "bathroom",    "pose": "holding product"  },  "lighting": {    "type": "natural",    "quality": "soft"  }}

vs

Markdown

## Subject- Woman in a bathroom- Holding product at chest level## Lighting- Soft natural light- Slightly uneven, realistic
## Subject- Woman in a bathroom- Holding product at chest level## Lighting- Soft natural light- Slightly uneven, realistic
## Subject- Woman in a bathroom- Holding product at chest level## Lighting- Soft natural light- Slightly uneven, realistic

The difference is obvious:

  • JSON = decode first, then understand

  • Markdown = understand instantly

3. CLEAR HIERARCHY = BETTER OUTPUT

AI models respond strongly to structured hierarchy.

Markdown gives you:

  • Headings → define importance

  • Bullet points → isolate details

  • Sections → prevent confusion

Instead of blending everything together, you’re telling the AI:

“This is the subject. This is the lighting. This is the composition.”

That separation reduces:

  • Style bleeding

  • Conflicting instructions

  • Random hallucinated details

4. EASIER ITERATION (THIS IS HUGE)

With JSON:

  • You edit keys and values

  • Risk breaking structure

  • Hard to scan changes

With Markdown:

  • You tweak one section at a time

  • You can duplicate and test variations fast

Example:

## Lighting (Version A)- Harsh on-camera flash## Lighting (Version B)- Soft window light
## Lighting (Version A)- Harsh on-camera flash## Lighting (Version B)- Soft window light
## Lighting (Version A)- Harsh on-camera flash## Lighting (Version B)- Soft window light

This makes experimentation:

→ Faster
→ Safer
→ More controlled

5. BETTER FOR MULTI-MODEL WORKFLOWS

Different models interpret structure differently:

  • Midjourney → prefers natural / descriptive

  • Seedream → strong with structured clarity

  • GPT image → can handle both

Markdown acts as a universal translator

You can:

  • Read it easily

  • Modify it quickly

  • Convert it into JSON if needed

WHERE JSON FALLS SHORT (FOR CREATIVES)

JSON is powerful — but it has trade-offs:

1. LOW HUMAN READABILITY

  • Too technical for fast creative thinking

  • Hard to scan visually

2. TOO RIGID

  • Requires strict syntax

  • One mistake breaks the whole structure

3. NOT IDEAL FOR EXPLORATION

  • Slows down ideation

  • Feels like programming, not directing

4. OVERKILL FOR MOST TASKS

  • You don’t need machine-level precision for:

    • Moodboards

    • Concept art

    • UGC-style shots

    • Visual exploration

WHEN YOU SHOULD STILL USE JSON

Markdown isn’t always the winner.

Use JSON when you need:

  • Strict consistency across generations

  • Programmatic pipelines

  • Automation / API workflows

  • Style locking at scale

Think:

Markdown = creative direction
JSON = production system

THE IDEAL MARKDOWN PROMPT STRUCTURE

Here’s a proven format you can reuse:

# Prompt — [Title]## OverviewShort description of the scene and intent---## Subject- Who / what is in the image- Key traits and details---## Composition- Framing (close-up, wide, etc.)- Camera angle- Positioning---## Lighting- Type (natural, studio, flash)- Quality (soft, harsh)- Direction---## Environment- Location details- Background elements---## Texture & Quality- Grain / sharpness- Imperfections- Realism level---## Style / Aesthetic- Visual tone- References (optional)---## Constraints- Things to avoid- Important rules
# Prompt — [Title]## OverviewShort description of the scene and intent---## Subject- Who / what is in the image- Key traits and details---## Composition- Framing (close-up, wide, etc.)- Camera angle- Positioning---## Lighting- Type (natural, studio, flash)- Quality (soft, harsh)- Direction---## Environment- Location details- Background elements---## Texture & Quality- Grain / sharpness- Imperfections- Realism level---## Style / Aesthetic- Visual tone- References (optional)---## Constraints- Things to avoid- Important rules
# Prompt — [Title]## OverviewShort description of the scene and intent---## Subject- Who / what is in the image- Key traits and details---## Composition- Framing (close-up, wide, etc.)- Camera angle- Positioning---## Lighting- Type (natural, studio, flash)- Quality (soft, harsh)- Direction---## Environment- Location details- Background elements---## Texture & Quality- Grain / sharpness- Imperfections- Realism level---## Style / Aesthetic- Visual tone- References (optional)---## Constraints- Things to avoid- Important rules

EXAMPLE — UGC PRODUCT SHOT

# Prompt — UGC Bathroom Product Shot## OverviewA candid, user-generated style image that feels natural and unpolished, like it was taken casually on a phone.---## Subject- Woman standing in a bathroom- Holding product at chest level- Minimal makeup, natural look- Slightly imperfect hair---## Composition- Medium shot (waist to head)- Slightly off-center framing- Handheld feel---## Lighting- Soft natural light from window- Slight uneven exposure- Minor blown highlights allowed---## Environment- Real bathroom setting- Sink, mirror visible- Light clutter (skincare, towels)---## Texture & Quality- Slight grain / noise- Mild softness- iPhone-style processing---## Style / Aesthetic- Authentic- Casual- Non-commercial feel---## Constraints- No studio lighting- No overly polished look
# Prompt — UGC Bathroom Product Shot## OverviewA candid, user-generated style image that feels natural and unpolished, like it was taken casually on a phone.---## Subject- Woman standing in a bathroom- Holding product at chest level- Minimal makeup, natural look- Slightly imperfect hair---## Composition- Medium shot (waist to head)- Slightly off-center framing- Handheld feel---## Lighting- Soft natural light from window- Slight uneven exposure- Minor blown highlights allowed---## Environment- Real bathroom setting- Sink, mirror visible- Light clutter (skincare, towels)---## Texture & Quality- Slight grain / noise- Mild softness- iPhone-style processing---## Style / Aesthetic- Authentic- Casual- Non-commercial feel---## Constraints- No studio lighting- No overly polished look
# Prompt — UGC Bathroom Product Shot## OverviewA candid, user-generated style image that feels natural and unpolished, like it was taken casually on a phone.---## Subject- Woman standing in a bathroom- Holding product at chest level- Minimal makeup, natural look- Slightly imperfect hair---## Composition- Medium shot (waist to head)- Slightly off-center framing- Handheld feel---## Lighting- Soft natural light from window- Slight uneven exposure- Minor blown highlights allowed---## Environment- Real bathroom setting- Sink, mirror visible- Light clutter (skincare, towels)---## Texture & Quality- Slight grain / noise- Mild softness- iPhone-style processing---## Style / Aesthetic- Authentic- Casual- Non-commercial feel---## Constraints- No studio lighting- No overly polished look

KEY TAKEAWAYS

  • Markdown turns prompts into creative direction documents

  • It’s faster to read, edit, and iterate than JSON

  • It improves clarity → which improves output quality

  • It aligns with how designers already think and work

  • Use Markdown for exploration and control

  • Use JSON for systems and scale

FINAL INSIGHT

If your prompts feel messy, inconsistent, or hard to reuse:

It’s not just what you’re saying —
it’s how you’re structuring it.

Markdown fixes that.

It turns prompting from:

“typing instructions”

into

“art directing with intention”