Düz Metin ve Biçimlendirilmiş Çıktı
Ne zaman temiz düz metin, ne zaman zengin Markdown çıktısı isteyeceğinizi öğrenin.
Düz Metin ve Biçimlendirilmiş Çıktı, CoddyKit'te ücretsiz bir AI Prompt Engineering dersidir. Bu, 4 dersinin 4. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, AI Prompt Engineering öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. AI Prompt Engineering kursu toplamda 4 dersten oluşur.
Düz Metin Kullanımı
Markdown biçimlendirmesi güçlüdür; ancak her zaman doğru tercih değildir. Gerçek dünyadaki birçok uygulama, Markdown simgelerinin görüntülenmiş biçimlendirme yerine gerçek karakterler olarak görüneceği temiz ve biçimlendirilmemiş metne ihtiyaç duyar.
Düz metin istemenin ne zaman gerekli olduğunu bilmek, zengin biçimlendirme istemeyi bilmek kadar önemlidir.
Düz Metnin Gerekli Olduğu Durumlar
Ortamınız Markdown'ı görüntülemiyorsa düz metin çıktısı kullanın:
- E-posta metni: Çoğu e-posta istemcisi ham yıldız işaretlerini gösterir
- SMS ve anlık bildirimler: Biçimlendirme desteği yoktur
- Sesli çıktı: Metinden sese dönüştürme, '** bold **' ifadesini olduğu gibi okur
- CRM ve destek masası alanları: Birçoğu Markdown'ı görüntülemez
- API verilerinin işlenmesi: Metin depolanacak veya daha sonra işlenecekse
- Eski sistemlerin giriş alanları: Yalnızca düz metin
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=200,
messages=[{
'role': 'user',
'content': (
'Write a 120-character push notification for a flash sale ending in 2 hours. '
'Plain text only — no emojis, no markdown, no asterisks, no special characters. '
'Must include: urgency, discount percentage (30%), and category (electronics). '
'Output the notification text only — nothing else.'
)
}]
)
print(response.content[0].text)Açıkça Düz Metin İsteme
Yapay zekâ modelleri, birçok bağlamda varsayılan olarak Markdown ağırlıklı çıktılar üretir. Gerçek anlamda düz metin elde etmek için bunu açıkça belirtmeniz ve çoğu zaman kaçınılmasını istediğiniz belirli simgeleri adlandırmanız gerekir:
- 'Yalnızca düz metin — Markdown biçimlendirmesi kullanmayın'
- 'Yıldız işareti, diyez işareti ve madde imi kullanmayın'
- 'Başlık, kalın metin ve liste kullanmayın — yalnızca akıcı düzyazı paragrafları yazın'
- 'Tüm biçimlendirmeyi kaldırın — Notepad'de yazıyormuş gibi çıktı verin'
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
# Without plain text instruction — likely gets markdown
default_prompt = 'Explain what a webhook is in 100 words.'
# With explicit plain text instruction
plain_prompt = (
'Explain what a webhook is in 100 words. '
'Output format: plain text only. No markdown. No asterisks. No headers. '
'No bullet points. Just continuous prose paragraphs.'
)
for label, prompt in [('DEFAULT (likely markdown)', default_prompt), ('EXPLICIT PLAIN TEXT', plain_prompt)]:
response = client.chat.completions.create(
model='gpt-4o', max_tokens=150,
messages=[{'role': 'user', 'content': prompt}]
)
print(f'--- {label} ---')
print(response.choices[0].message.content)
print()E-posta Metni için Düz Metin
E-posta metni yazımı, düz metnin en yaygın kullanım alanlarından biridir. Bazı e-posta istemcileri HTML biçimlendirmesini desteklese de yapay zekâ tarafından oluşturulan e-posta metni, bir insan editörün herhangi bir temizlik yapmadan doğrudan e-posta istemcisine veya CRM'e yapıştırabileceği temiz bir düzyazı olarak gelmelidir.
Şunu belirtin: 'E-posta gövdesini düz metin olarak yazın. Markdown kullanmayın. Kalın metin için yıldız işareti kullanmayın. Listeler için kısa çizgi kullanmayın. Listeler yerine numaralı cümleler veya satır sonları kullanın.'
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 3-paragraph re-engagement email for inactive newsletter subscribers. '
'Context: SaaS analytics tool, subscriber inactive for 60 days.\n'
'Format requirements:\n'
'- Plain text only — no asterisks, no pound signs, no bullet symbols\n'
'- Paragraph 1: acknowledge absence, create curiosity\n'
'- Paragraph 2: one new feature they missed\n'
'- Paragraph 3: CTA with a direct link placeholder [LINK]\n'
'- No subject line — body only'
)
}]
)
print(response.content[0].text)Akıcı Düzyazı Paragrafları
Markdown simgelerinden kaçınmanın ötesinde, 'akıcı düzyazı' fikirleri parçalı madde işaretleri yerine birbirine bağlanan cümleler olarak yapılandırmak anlamına gelir.
İyi düzyazı:
- Fikirleri birbirine bağlamak için geçiş ifadeleri kullanır (ancak, ayrıca, bunun sonucunda)
- Ritim oluşturmak için cümle uzunluklarını değiştirir
- İlişkili fikirleri tutarlı paragraflar hâlinde gruplandırır
- Her cümleye bir isimle başlamaktan kaçınır
İstem: 'Akıcı düzyazı paragraflarıyla yazın — liste ve başlık kullanmayın; geçiş ifadeleri içeren, akıcı cümleler yazın.'
import openai
client = openai.OpenAI(api_key='sk-your-key-here')
prose_prompt = (
'Explain the advantages of using Docker for development environments. '
'Write in 3 clean prose paragraphs. '
'Requirements:\n'
'- No bullet points or numbered lists\n'
'- No markdown headers\n'
'- Use transition words between sentences and paragraphs\n'
'- Vary sentence length — mix short and long\n'
'- 150 words total maximum'
)
response = client.chat.completions.create(
model='gpt-4o',
messages=[{'role': 'user', 'content': prose_prompt}]
)
print(response.choices[0].message.content)Sesli Çıktı için Düz Metin
Metinden sese dönüştürme sistemleri her şeyi kelimesi kelimesine okur. Yapay zekâ çıktınız sesli okunacaksa:
- Tüm Markdown simgelerinden kaçının
- Kısaltmalardan kaçının (TTS bunları açmayabilir)
- Uygun olduğunda sayıları tamamen yazıyla ifade edin
- Doğal duraklama noktaları için virgül kullanın
- Parantezlerden kaçının — TTS bunları çoğu zaman doğal olmayan biçimde okur
- Özel karakterleri açıkça yazın ('@' → 'et')
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=200,
messages=[{
'role': 'user',
'content': (
'Write a 45-second spoken weather briefing for London today. '
'Conditions: 12 degrees Celsius, light rain, wind 15 km/h from the southwest.\n'
'Format for voice output:\n'
'- No markdown symbols of any kind\n'
'- No parentheses\n'
'- No abbreviations (write "kilometres per hour" not "km/h")\n'
'- Natural spoken rhythm — use commas for pause points\n'
'- Write numbers as words when under ten'
)
}]
)
print(response.content[0].text)Mevcut Çıktıdan Markdown'ı Kaldırma
Bazen bir yapay zekâ çağrısından Markdown çıktısı alır ve bunu farklı bir bağlam için temizlemeniz gerekir. Kaldırma işlemi için özel olarak ikinci bir yapay zekâ çağrısı kullanabilirsiniz:
'Aşağıdaki metindeki tüm Markdown biçimlendirmesini kaldırın. **kalın** metni düz metinle değiştirin, # başlıklarını kaldırın, madde işaretlerini numaralı cümlelere dönüştürün, tüm yıldız ve diyez işaretlerini kaldırın. Yalnızca temiz düz metin çıktısı verin.'
import openai
import re
client = openai.OpenAI(api_key='sk-your-key-here')
markdown_text = (
'## Key Benefits\n'
'- **Faster deployment** with Docker containers\n'
'- **Consistent environments** across dev and prod\n'
'- Reduced *configuration drift* between machines\n'
'### Getting Started\n'
'Run docker-compose up to start all services.'
)
# Option 1: Ask AI to strip
response = client.chat.completions.create(
model='gpt-4o',
max_tokens=150,
messages=[{
'role': 'user',
'content': (
'Remove all markdown formatting from the text below. '
'Keep all the information but strip: **, ##, ###, -, *, backticks. '
'Convert bullet lists to flowing sentences. Output plain text only.\n\n'
+ markdown_text
)
}]
)
print('AI-stripped:', response.choices[0].message.content.strip())
# Option 2: Simple regex strip (for code-based pipelines)
import re
clean = re.sub(r'[#*]', '', markdown_text).strip()
print('Regex-stripped:', clean)Sistem İletilerinde Düz Metin
Sürekli olarak düz metin ortamlarına çıktı veren yapay zekâ yardımcıları için biçimlendirme kuralını her kullanıcı iletisinde tekrarlamak yerine sistem iletisinde bir kez belirleyin.
Bu, görüntüleme ortamını önceden bildiğiniz üretim uygulamaları için en temiz yaklaşımdır.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
# System message enforces plain text for all responses
plain_text_system = (
'You are a helpful assistant embedded in a mobile push notification system. '
'All your responses are displayed as plain text in mobile notifications. '
'ALWAYS follow these formatting rules:\n'
'- Never use markdown (no **, no #, no -, no backtick, no *, no _)\n'
'- Never use bullet points or numbered lists\n'
'- Write in 1-2 complete sentences only\n'
'- Maximum 120 characters per response\n'
'- No emojis'
)
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=64,
system=plain_text_system,
messages=[
{'role': 'user', 'content': 'Notify user their order has shipped and will arrive in 2 days.'}
]
)
print(response.content[0].text)Biçimlendirme Karar Çerçevesi
Herhangi bir çıktı biçimi istemeden önce şu hızlı karar çerçevesini kullanın:
- Çıktı nereye gidecek? Web arayüzü, e-posta, terminal, ses veya veritabanı
- Bu ortam Markdown'ı görüntülüyor mu? Evet → Markdown kullanın. Hayır → düz metin kullanın.
- Bir insan bunu okuyacak mı? Evet → kolay taranabilecek şekilde yapılandırın. Hayır → ayrıştırmaya göre optimize edin.
- Kod bunu işleyecek mi? Evet → JSON veya CSV kullanın; düzyazı kullanmayın.
- Metin sesli okunacak mı? Evet → kısaltma içermeyen, sesli okumaya uygun düz metin kullanın.
def choose_format(environment, human_reads, code_processes, voice_output):
'''Simple formatting decision tree.'''
if voice_output:
return 'PLAIN TEXT — voice safe, spell out numbers and units'
if code_processes:
return 'JSON or CSV — machine-parseable, no prose'
renders_markdown = environment in ['web', 'notion', 'github', 'vscode', 'obsidian']
if renders_markdown and human_reads:
return 'MARKDOWN — headers, bold, code blocks, lists'
return 'PLAIN TEXT — clean prose paragraphs, no markdown symbols'
scenarios = [
('web', True, False, False),
('email', True, False, False),
('api_pipeline',False, True, False),
('voice_app', False, False, True),
('terminal', True, False, False),
]
for env, human, code, voice in scenarios:
result = choose_format(env, human, code, voice)
print(f'{env:<15} -> {result}')Yapılandırılmış Düz Metin
Düz metnin yapısız olması gerekmez. Markdown kullanmadan şu yöntemlerle yapı oluşturabilirsiniz:
- ALL CAPS SECTION LABELS (her yerde aynı şekilde görüntülenir)
- Bölümler arasında satır sonları
- Numaralı cümleler: '1. İlk nokta. 2. İkinci nokta.'
- Ayırma için uzun çizgiler: 'Temel çıkarım — harekete geçmeden önce her zaman doğrulayın.'
- Boşluklarla tutarlı girinti (terminal çıktısı için)
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 daily briefing for a developer — 3 sections: TASKS, BLOCKERS, NOTES. '
'Format: plain text only. '
'Use ALL CAPS section labels followed by a colon. '
'Use a line break between sections. '
'Number each item within a section. '
'No markdown symbols of any kind. '
'Use realistic placeholder content.'
)
}]
)
print(response.choices[0].message.content)Çıktı Biçimini Algılama
Üretim uygulamalarında çıktı ortamını program aracılığıyla algılayabilir ve uygun biçimlendirme yönergesini otomatik olarak ekleyebilirsiniz; böylece bunu her istemde el ile belirtmeniz gerekmez.
Bu, aynı içeriği web, mobil ve API tüketicilerine sunan çok kanallı yapay zekâ sistemlerinde yaygın bir örüntüdür.
import anthropic
client = anthropic.Anthropic(api_key='sk-ant-your-key-here')
def get_format_instruction(channel):
formats = {
'web': 'Use markdown formatting: headers, bold, bullet points, code blocks.',
'email': 'Plain text only. No markdown symbols. Use line breaks between sections.',
'sms': 'Plain text. Single paragraph. Max 160 characters.',
'voice': 'Plain text. No symbols. Natural spoken sentences only. Spell out numbers.',
'api': 'JSON output only. No prose.',
}
return formats.get(channel, 'Plain text only.')
def ask_with_channel(question, channel):
fmt = get_format_instruction(channel)
response = client.messages.create(
model='claude-opus-4-5',
max_tokens=100,
system=f'Format instruction: {fmt}',
messages=[{'role': 'user', 'content': question}]
)
return response.content[0].text
q = 'What are 3 benefits of regular code reviews?'
for ch in ['web', 'sms', 'voice']:
print(f'[{ch.upper()}]:')
print(ask_with_channel(q, ch)[:150])
print()Bilgi Kontrolü
Bir geliştirici, yanıtları düz metin depolayan eski bir CRM'e aktaran bir müşteri hizmetleri sohbet robotu geliştiriyor. Yapay zekâ, CRM'de ham karakterler olarak görüntülenen kalın metin için ** ve madde işaretleri için - içeren yanıtlar üretmeye devam ediyor. En güvenilir çözüm nedir?
Düz Metin ve Biçimlendirilmiş Çıktı — Özet
Doğru biçimi seçmek çıktı ortamınıza bağlıdır. Temel kurallar şunlardır:
- Ortam görüntülüyorsa Markdown kullanın: web arayüzleri, Notion, GitHub ve belgeler
- E-posta metni, SMS, ses, CRM'ler ve API işlem hatları için düz metin kullanın
- Kod çıktıyı işleyecekse JSON/CSV kullanın
- Kaçınılacak öğeleri açıkça listeleyerek düz metin isteyin: yıldız işareti, diyez işareti ve madde imi kullanmayın
- Tutarlı uygulama davranışı için biçimlendirme kurallarını sistem iletisinde bir kez belirleyin
- Düz metin, CAPS LABELS, satır sonları ve numaralı cümleler aracılığıyla yine de yapılandırılabilir
Yapay zeka eğitmeniyle AI Prompt Engineering öğren — ücretsiz
Tarayıcında gerçek kod yaz ve çalıştır, 7/24 yapay zeka eğitmeninden anında yardım al; web'de ya da uygulamada kaldığın yerden devam et.
- Kurslar
- 53
- Dersler
- 199
Sıkça Sorulan Sorular
“Düz Metin ve Biçimlendirilmiş Çıktı” dersi ücretsiz mi?
Evet — “Düz Metin ve Biçimlendirilmiş Çıktı” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve AI Prompt Engineering kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. AI Prompt Engineering kursu toplamda 4 dersten oluşur.
“Düz Metin ve Biçimlendirilmiş Çıktı” dersinde ne öğreneceğim?
Ne zaman temiz düz metin, ne zaman zengin Markdown çıktısı isteyeceğinizi öğrenin. AI Prompt Engineering ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.
AI Prompt Engineering öğrenmeye başlamak için deneyim gerekli mi?
Önceden deneyim gerekmez. CoddyKit'te AI Prompt Engineering, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 4. dersidir.
“Düz Metin ve Biçimlendirilmiş Çıktı” dersi ne kadar sürer?
Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.
Bu AI Prompt Engineering dersinde kod yazıp çalıştırabilir miyim?
Evet. Her AI Prompt Engineering dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.
Bu kursun tüm dersleri
- Listeler ve Madde İşaretleri İsteme
- Tablo ve Yapılandırılmış Veri İsteme
- İstemlerde Markdown Biçimlendirmesi
- Düz Metin ve Biçimlendirilmiş Çıktı