Pemformatan Markdown dalam Perintah
Pelajari cara menentukan format kaya dengan header, teks tebal, dan blok kode.
Pemformatan Markdown dalam Perintah adalah pelajaran AI Prompt Engineering gratis di CoddyKit. Ini adalah pelajaran 3 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar AI Prompt Engineering, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus AI Prompt Engineering mencakup 4 pelajaran total.
Markdown dalam Keluaran AI
Markdown adalah sintaks pemformatan teks ringan yang dipahami secara bawaan oleh model AI. Saat Anda meminta keluaran berformat Markdown, model menghasilkan teks yang ditampilkan sebagai format kaya di lingkungan yang kompatibel.
Dengan mengetahui cara meminta setiap elemen Markdown secara tepat, Anda dapat mengendalikan struktur setiap dokumen yang dibuat AI dengan presisi.
Meminta Judul
Judul Markdown menggunakan simbol pagar: # untuk H1, ## untuk H2, ### untuk H3.
Mintalah secara eksplisit: 'Susun dengan judul bagian H2', 'Gunakan ## untuk bagian utama dan ### untuk subbagian', atau 'Sertakan satu judul H1 # di bagian atas.'
Judul menciptakan struktur yang dapat dinavigasi di Notion, GitHub, Obsidian, dan sebagian besar alat dokumentasi.
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)Penekanan Tebal dan Miring
Penekanan tebal dan miring dalam Markdown:
**bold text**→ teks tebal*italic text*→ teks miring***bold and italic***→ tebal dan miring
Permintaan: 'Tebalkan semua istilah penting saat pertama kali digunakan', 'Gunakan huruf miring untuk nama produk', atau 'Tebalkan tindakan pada setiap langkah.'
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)Blok Kode
Blok kode dalam Markdown menggunakan tiga tanda backtick, dengan petunjuk bahasa opsional untuk penyorotan sintaks:
```python
print('hello')
```Permintaan: 'Sertakan semua kode dalam blok kode python', 'Bungkus setiap perintah dalam blok kode bash', atau 'Tampilkan contoh JSON dalam blok kode json.'
Petunjuk bahasa mengaktifkan penyorotan sintaks di GitHub, VS Code, dan situs dokumentasi.
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)Kode Sebaris
Kode sebaris menggunakan tanda backtick tunggal: `variable_name`. Kode tersebut ditampilkan sebagai teks monospace di dalam kalimat—tepat untuk:
- Nama variabel:
user_id - Nama fungsi:
calculate_tax() - Nama perintah:
git commit - Jalur file:
/etc/nginx/nginx.conf - Endpoint HTTP:
/api/v1/users
Permintaan: 'Gunakan pemformatan kode sebaris untuk semua nama variabel dan fungsi.'
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)Kutipan Blok
Kutipan blok menggunakan > di awal baris. Dalam Markdown:
> Ini adalah kutipan blok.
Kegunaannya meliputi kotak sorotan, catatan penting, dialog contoh, materi sumber yang dikutip, dan peringatan.
Permintaan: 'Tempatkan peringatan yang paling penting dalam kutipan blok' atau 'Gunakan kutipan blok untuk skenario contoh tersebut.'
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)Daftar Bertingkat dalam Markdown
Daftar Markdown bertingkat menggunakan indentasi (2 atau 4 spasi) untuk membuat hierarki:
- Item utama
- Subitem
- Subitem
- SubsubitemPermintaan: 'Buat daftar bertingkat dua tingkat dengan X item utama dan masing-masing memiliki Y subitem' atau 'Gunakan poin bertingkat untuk menunjukkan hubungan antara kategori dan contoh.'
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)Tautan dan Gambar
Tautan Markdown: [teks tautan](URL)
Gambar Markdown: 
Model AI dapat menghasilkan tautan pengganti dengan teks yang bermakna: 'Sertakan tautan Markdown ke dokumentasi yang relevan—gunakan URL pengganti seperti [dokumentasi resmi](https://example.com).'
Untuk dokumentasi dengan pengganti diagram: 'Sertakan pengganti gambar dengan teks alternatif yang bermakna.'
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: \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)Garis Horizontal dan Pemisah
Garis horizontal menggunakan tiga tanda hubung (---), tanda bintang (***), atau garis bawah (___).
Gunakan elemen tersebut untuk memisahkan bagian utama dokumen secara visual. Permintaan: 'Tambahkan garis horizontal --- di antara setiap bagian utama' atau 'Pisahkan ketiga bagian tersebut dengan pemisah Markdown.'
Garis horizontal ditampilkan di sebagian besar lingkungan Markdown dan membantu pembaca menavigasi dokumen yang panjang.
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)Saat Markdown Tidak Ditampilkan
Markdown hanya membantu jika lingkungan keluaran menampilkannya. Markdown TIDAK ditampilkan dalam:
- Klien email teks biasa (tanda bintang mentah akan muncul)
- Pesan SMS
- Sebagian besar bidang catatan CRM
- Keluaran suara (teks-ke-ucapan)
- Sistem lama yang mengharapkan teks biasa
Untuk konteks tersebut, mintalah teks biasa secara eksplisit. Hal ini akan dibahas dalam pelajaran berikutnya.
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)Menggabungkan Elemen Markdown
Dokumen yang dihasilkan AI dengan kualitas produksi menggabungkan beberapa elemen Markdown. Dokumen teknis yang terstruktur dengan baik mungkin menggunakan:
- Judul H1
#+ bagian H2## - Istilah utama dalam
**tebal**saat pertama kali digunakan - Blok kode dengan petunjuk bahasa untuk semua kode
- Kode sebaris untuk semua nama variabel/fungsi
- Daftar berpoin untuk persyaratan; daftar bernomor untuk langkah-langkah
- Kutipan blok untuk peringatan dan catatan penting
- Pemisah
---di antara bagian utama
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)Uji Pemahaman
Seorang pengembang sedang membuat asisten AI yang menghasilkan konten untuk ditampilkan di terminal menggunakan print()—tanpa antarmuka web dan tanpa perender Markdown. Pengembang tersebut meminta penjelasan fitur kepada AI dan mendapatkan keluaran yang dipenuhi tanda bintang serta simbol pagar. Apa yang harus ditambahkan ke pesan sistem untuk memperbaikinya?
Markdown dalam Prompt—Ringkasan
Pemformatan Markdown memberikan struktur profesional pada dokumen yang dihasilkan AI. Elemen utama yang perlu diminta:
- Header: # H1, ## H2, ### H3—untuk struktur dokumen yang mudah dinavigasi
- Penekanan: **tebal** untuk istilah utama, *miring* untuk nama khusus
- Blok kode: tiga backtick dengan petunjuk bahasa untuk penyorotan sintaks
- Kode sebaris: backtick tunggal untuk nama variabel, perintah, dan jalur
- Kutipan blok: awalan > untuk peringatan, sorotan, dan konten kutipan
- Daftar bertingkat: poin terindentasi untuk informasi hierarkis
Gunakan Markdown hanya jika Anda mengetahui bahwa lingkungan keluaran akan menampilkannya.
Belajar AI Prompt Engineering dengan tutor AI — gratis
Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.
- Kursus
- 53
- Pelajaran
- 199
Pertanyaan yang Sering Diajukan
Apakah pelajaran “Pemformatan Markdown dalam Perintah” gratis?
Ya — teks lengkap “Pemformatan Markdown dalam Perintah” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus AI Prompt Engineering, upgrade ke CoddyKit PRO. Kursus AI Prompt Engineering mencakup 4 pelajaran total.
Apa yang akan aku pelajari di “Pemformatan Markdown dalam Perintah”?
Pelajari cara menentukan format kaya dengan header, teks tebal, dan blok kode. Kamu berlatih AI Prompt Engineering dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.
Apakah aku perlu pengalaman untuk memulai AI Prompt Engineering?
Tidak diperlukan pengalaman sebelumnya. AI Prompt Engineering di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 3 dari 4.
Berapa lama pelajaran “Pemformatan Markdown dalam Perintah” memakan waktu?
Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.
Bisakah aku menulis dan menjalankan kode dalam pelajaran AI Prompt Engineering ini?
Ya. Setiap pelajaran AI Prompt Engineering menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.
Semua pelajaran dalam kursus ini
- Meminta Daftar dan Poin-Poin
- Meminta Tabel dan Data Terstruktur
- Pemformatan Markdown dalam Perintah
- Keluaran Teks Biasa dan Berformat