AI-promptteknik · Lektion

Markdown-formatering i prompts

Rubriker, fetstil och kodblock – så anger ni avancerad formatering.

Lektion 3 av 413 steg

Markdown-formatering i prompts är en gratis lektion i AI-promptteknik på CoddyKit. Detta är lektion 3 av 4. Du kan läsa vilka 3 lektioner som helst i den här lärvägen kostnadsfritt i sin helhet – därefter låser CoddyKit PRO upp alla lektioner, plus praktisk övning med en inbyggd kodredigerare och en AI-lärare dygnet runt. Den ingår i lärvägen för AI-promptteknik, och Era framsteg synkroniseras mellan webben och CoddyKit-appen. Kursen i AI-promptteknik innehåller totalt 4 lektioner.

Markdown i AI-utdata

Markdown är en lättviktig syntax för textformatering som AI-modeller har inbyggt stöd för. När ni ber om Markdown-formaterad utdata producerar modellen text som återges med rik formatering i kompatibla miljöer.

Genom att veta exakt hur varje Markdown-element ska begäras får ni exakt kontroll över strukturen i varje AI-genererat dokument.

Begära rubriker

Markdown-rubriker använder hashtecken: # för H1, ## för H2 och ### för H3.

Begär dem uttryckligen: 'Strukturera med H2-avsnittsrubriker', 'Använd ## för huvudavsnitt och ### för underavsnitt' eller 'Inkludera en enda # H1-rubrik högst upp.'

Rubriker skapar en navigerbar struktur i Notion, GitHub, Obsidian och de flesta dokumentationsverktyg.

import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=400,
    messages=[{
        'role': 'user',
        'content': (
            'Write a technical guide outline for "Getting Started with FastAPI". '
            'Structure: one # H1 title at the top, then 4 ## H2 section headers, '
            'each with 2 ### H3 subsection headers beneath it. '
            'Add one sentence of placeholder content under each H3.'
        )
    }]
)
print(response.content[0].text)

Fet och kursiv betoning

Fet och kursiv betoning i Markdown:

  • **bold text** → fet text
  • *italic text* → kursiv text
  • ***bold and italic*** → fet och kursiv

Begär: 'Fetmarkera alla nyckeltermer första gången de används', 'Använd kursiv stil för produktnamn' eller 'Fetmarkera åtgärdspunkten i varje steg.'

import openai

client = openai.OpenAI(api_key='sk-your-key-here')

response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{
        'role': 'user',
        'content': (
            'Explain the concept of idempotency in REST APIs. '
            'Rules:\n'
            '- Bold every technical term on its first occurrence only\n'
            '- Italicize all HTTP method names (GET, POST, PUT, DELETE, PATCH)\n'
            '- 150 words max, flowing prose — no bullets or headers'
        )
    }]
)
print(response.choices[0].message.content)

Kodblock

Kodblock i Markdown använder tre backticks med en valfri språkanvisning för syntaxmarkering:

```python
print('hello')
```

Begär: 'Inkludera all kod i python-kodblock', 'Omslut varje kommando i ett bash-kodblock' eller 'Visa JSON-exemplet i ett json-kodblock.'

Språkanvisningen aktiverar syntaxmarkering i GitHub, VS Code och dokumentationswebbplatser.

import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=400,
    messages=[{
        'role': 'user',
        'content': (
            'Show me how to connect to PostgreSQL from Python using psycopg3.\n'
            'Structure:\n'
            '1. Install command in a bash code block.\n'
            '2. Connection example in a python code block with type hints.\n'
            '3. A sample SELECT query in a python code block.\n'
            'Keep each code block under 10 lines. Brief one-sentence intro before each block.'
        )
    }]
)
print(response.content[0].text)

Inlinekod

Inlinekod använder enkla backtick-tecken: `variable_name`. Den visas som text med fast teckenbredd i en mening – perfekt för:

  • Variabelnamn: user_id
  • Funktionsnamn: calculate_tax()
  • Kommandonamn: git commit
  • Sökvägar: /etc/nginx/nginx.conf
  • HTTP-slutpunkter: /api/v1/users

Begäran: 'Använd inlinekodformatering för alla variabel- och funktionsnamn.'

import openai

client = openai.OpenAI(api_key='sk-your-key-here')

response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{
        'role': 'user',
        'content': (
            'Explain the difference between Python list .append() and .extend(). '
            'Rules:\n'
            '- Use inline code for all method names, parameter names, and variable examples\n'
            '- Use a python code block for each demonstration example\n'
            '- Prose sections: max 2 sentences\n'
            '- Do NOT use headers or bullets — flowing prose with code blocks only'
        )
    }]
)
print(response.choices[0].message.content)

Citatblock

Citatblock använder > i början av en rad. I Markdown:

> This is a blockquote.

Användningsområden: informationsrutor, viktiga anteckningar, exempeldialoger, citerat källmaterial och varningar.

Begäran: 'Placera den viktigaste varningen i ett citatblock' eller 'Använd ett citatblock för exempelscenariot.'

import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=300,
    messages=[{
        'role': 'user',
        'content': (
            'Write a security guide section about SQL injection prevention. '
            'Structure:\n'
            '- 2-sentence explanation of the risk\n'
            '- One blockquote containing a real example of vulnerable code (as a note/warning)\n'
            '- 3 bullet points on how to prevent it\n'
            '- One blockquote containing the safe alternative code pattern'
        )
    }]
)
print(response.content[0].text)

Nästlade listor i Markdown

Nästlade Markdown-listor använder indrag (2 eller 4 blanksteg) för att skapa en hierarki:

- Main item
  - Sub-item
  - Sub-item
    - Sub-sub-item

Begäran: 'Skapa en nästlad lista i två nivåer med X huvudpunkter och Y underpunkter för varje' eller 'Använd nästlade punktlistor för att visa relationen mellan kategorier och exempel.'

import openai

client = openai.OpenAI(api_key='sk-your-key-here')

response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{
        'role': 'user',
        'content': (
            'Create a 2-level nested markdown list of AWS services for a web startup. '
            'Level 1: 4 service categories (Compute, Storage, Database, Networking). '
            'Level 2: 3 specific services under each category with a 5-word description. '
            'Format: markdown nested bullets with proper indentation.'
        )
    }]
)
print(response.choices[0].message.content)

Länkar och bilder

Markdown-länkar: [link text](URL)
Markdown-bilder: ![alt text](image-URL)

AI-modeller kan generera platshållarlänkar med meningsfull länktext: 'Inkludera Markdown-länkar till relevant dokumentation – använd platshållar-URL:er som [officiell dokumentation](https://example.com).'

För dokumentation med platshållare för diagram: 'Inkludera en bildplatshållare med meningsfull alternativtext.'

import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

response = client.messages.create(
    model='claude-opus-4-5',
    max_tokens=300,
    messages=[{
        'role': 'user',
        'content': (
            'Write a README section for a Python open-source project called "sqlens". '
            'Include:\n'
            '- An image placeholder for a demo screenshot: ![Demo screenshot](docs/demo.png)\n'
            '- At least 2 markdown links: one to the PyPI page, one to the documentation\n'
            '- A badge placeholder using an image link\n'
            '- 3 bullet points of key features\n'
            'Use realistic placeholder URLs (pypi.org/project/sqlens etc).'
        )
    }]
)
print(response.content[0].text)

Horisontella linjer och avdelare

Horisontella linjer använder tre bindestreck (---), asterisker (***) eller understreck (___).

Använd dem för att visuellt skilja större dokumentavsnitt åt. Begäran: 'Lägg till en --- horisontell linje mellan varje större avsnitt' eller 'Separera de tre avsnitten med Markdown-avdelare.'

Horisontella linjer återges i de flesta Markdown-miljöer och hjälper läsare att hitta rätt i långa dokument.

import openai

client = openai.OpenAI(api_key='sk-your-key-here')

response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{
        'role': 'user',
        'content': (
            'Write a mini technical specification document for a user authentication API. '
            'Include exactly 3 sections: Overview, Endpoints, Security Requirements. '
            'Separate each section with a --- horizontal rule. '
            'Each section: ## H2 header + 3-5 bullet points of content. '
            'Under Endpoints: use inline code for all route paths and HTTP methods.'
        )
    }]
)
print(response.choices[0].message.content)

När Markdown inte renderas

Markdown är bara till hjälp när utmatningsmiljön återger det. Markdown återges INTE i:

  • Renodlade textbaserade e-postklienter (råa asterisker visas)
  • SMS-meddelanden
  • De flesta CRM-anteckningsfält
  • Röstutdata (text-till-tal)
  • Äldre system som förväntar sig ren text

I dessa sammanhang ska ni i stället uttryckligen begära ren text. Detta behandlas i nästa lektion.

import anthropic

client = anthropic.Anthropic(api_key='sk-ant-your-key-here')

# Check if environment renders markdown before requesting it
rendering_environments = {
    'GitHub':     True,
    'Notion':     True,
    'Obsidian':   True,
    'VS Code':    True,
    'Gmail body': False,  # some markdown, not all
    'Outlook':    False,
    'SMS':        False,
    'Plain text file': False,
}

print('Markdown rendering support:')
for env, renders in rendering_environments.items():
    status = 'RENDERS' if renders else 'DOES NOT RENDER'
    print(f'  {env:<20} {status}')

# Decision: use markdown only when you know it renders
use_markdown = True  # set based on your environment

format_instruction = (
    'Use markdown headers, bold, and code blocks.' if use_markdown
    else 'Plain text only — no markdown symbols.'
)
print('\nFormat instruction:', format_instruction)

Kombinera Markdown-element

Produktionsklara AI-genererade dokument kombinerar flera Markdown-element. Ett välstrukturerat tekniskt dokument kan innehålla:

  • # H1-rubrik + ## H2-avsnitt
  • **bold** viktiga termer första gången de används
  • Kodblock med språkindikering för all kod
  • Inlinekod för alla variabel- och funktionsnamn
  • Punktlistor för krav; numrerade listor för steg
  • Citatblock för varningar och viktiga anteckningar
  • --- avdelare mellan större avsnitt
import openai

client = openai.OpenAI(api_key='sk-your-key-here')

response = client.chat.completions.create(
    model='gpt-4o',
    messages=[{
        'role': 'user',
        'content': (
            'Write a mini developer guide for the requests Python library. '
            'Use all of the following markdown elements:\n'
            '- # H1 title at the top\n'
            '- ## H2 sections: Installation, Basic Usage, Error Handling\n'
            '- Bold all key terms on first use\n'
            '- Code blocks with python/bash language hints\n'
            '- Inline code for all function names\n'
            '- One blockquote warning about timeout best practice\n'
            '- --- between each section\n'
            'Max 300 words total.'
        )
    }]
)
print(response.choices[0].message.content)

Kunskapskontroll

En utvecklare bygger en AI-assistent vars innehåll ska visas i en terminal med hjälp av print() – utan webbgränssnitt och utan Markdown-renderare. Utvecklaren ber AI:n om en funktionsförklaring och får ett svar fullt av asterisker och nummertecken. Vad bör läggas till i systemmeddelandet för att åtgärda detta?

Markdown i prompter – sammanfattning

Markdown-formatering ger AI-genererade dokument en professionell struktur. Viktiga element att begära:

  • Rubriker: # H1, ## H2, ### H3 – för en navigerbar dokumentstruktur
  • Betoning: **fetstil** för viktiga termer, *kursiv* för särskilda namn
  • Kodblock: tre backtick-tecken med språkindikering för syntaxmarkering
  • Inlinekod: enstaka backtick för variabelnamn, kommandon och sökvägar
  • Citatblock: >-prefix för varningar, informationsrutor och citerat innehåll
  • Nästlade listor: punktlistor med indrag för hierarkisk information

Använd endast Markdown när ni vet att utmatningsmiljön återger det.

Gratis att börja

Lär dig AI-promptteknik med en AI-lärare – gratis

Skriv och kör riktig kod i webbläsaren, få omedelbar hjälp av en AI-lärare dygnet runt och fortsätt där du slutade – på webben eller i appen.

Kurser
53
Lektioner
199

Vanliga frågor

Är lektionen ”Markdown-formatering i prompts” gratis?

Ja – du kan läsa vilka 3 lektioner som helst i lärvägen AI-promptteknik, inklusive ”Markdown-formatering i prompts”, kostnadsfritt i sin helhet här på webben. Därefter låser CoddyKit PRO upp alla lektioner, plus interaktiv övning med en inbyggd kodredigerare och en AI-lärare dygnet runt. Kursen i AI-promptteknik innehåller totalt 4 lektioner.

Vad lär jag mig i ”Markdown-formatering i prompts”?

Rubriker, fetstil och kodblock – så anger ni avancerad formatering. Ni övar på AI-promptteknik med praktisk kod som körs direkt i webbläsaren, medan en AI-handledare som är tillgänglig dygnet runt svarar på Era frågor under lektionen.

Behöver jag någon erfarenhet för att börja lära mig AI-promptteknik?

Du behöver inga förkunskaper. Utbildningen i AI-promptteknik på CoddyKit är upplagd för allt från nybörjare till avancerade elever, så att du kan börja här eller från början och gå fram i din egen takt. Detta är lektion 3 av 4.

Hur lång tid tar lektionen ”Markdown-formatering i prompts”?

De flesta CoddyKit-lektioner tar cirka 5–10 minuter. Varje lektion är kort och interaktiv, så att du gör stadiga framsteg och kan fortsätta precis där du slutade – på webben eller i appen.

Kan jag skriva och köra kod i den här AI-promptteknik-lektionen?

Ja. Varje AI-promptteknik-lektion innehåller en inbyggd kodredigerare, så att du kan skriva och köra riktig kod direkt i webbläsaren och få omedelbar AI-feedback – utan lokal installation.

Alla lektioner i den här kursen

  1. Be om listor och punktlistor
  2. Be om tabeller och strukturerade data
  3. Markdown-formatering i prompts
  4. Ren text jämfört med formaterade resultat
← Tillbaka till AI-promptteknik