📄 Panduan Format Quiz Markdown

Format untuk membuat soal quiz yang bisa digunakan langsung oleh admin atau di-generate oleh AI (ChatGPT, Claude, Gemini, dll).

Format Dasar

Setiap file quiz terdiri dari 5 komponen:

Frontmatter YAML

Metadata quiz diapit oleh ---

Heading Soal

Dimulai dengan ## N.

Opsi Jawaban

List dengan - A. dst

Jawaban Benar

Ditandai * di akhir opsi

Penjelasan

Blockquote > (opsional)

Frontmatter (Metadata)

Field	Wajib	Deskripsi	Contoh
`title`	Wajib	Judul quiz	Try Out TWK 1
`program`	Opsional	Jalur ujian (default: PKN STAN). Kategori dicari di dalam program ini.	PKN STAN
`category`	Wajib	Nama kategori (harus sudah ada di sistem, di bawah program tsb.)	TWK
`topic`	Opsional	Sub-topik untuk filter halus (mis. Pancasila, Logika)	Pancasila
`type`	Opsional	Tipe: practice, quiz, atau exam	practice
`time_limit`	Opsional	Batas waktu (menit)	60
`passing_score`	Opsional	Nilai lulus (%, default 70)	75
`is_premium`	Opsional	Jika `true`, quiz dikunci — hanya member premium yang bisa mengerjakan (free user melihat paywall). Default `false`.	false

Aturan Soal

✅

Setiap soal dimulai dengan ## N. (nomor diikuti titik)

✅

Minimal 2 opsi jawaban per soal

✅

Tepat 1 jawaban benar per soal (ditandai *)

✅

Opsi menggunakan huruf kapital: A. B. C. D. E.

📷

Gambar soal opsional: ![](url) pada baris setelah heading soal

🖼️

Gambar opsi opsional: sematkan ![](url) di dalam baris opsi — - A. Teks ![](url) *

💡

Penjelasan opsional: > teks setelah opsi jawaban

🖼️ Dukungan Gambar

Gambar bisa ditambahkan pada soal maupun opsi jawaban. Gunakan URL gambar publik yang dapat diakses.

📷 Gambar pada Soal

Contoh

## 3. Perhatikan gambar berikut!

![](https://example.com/gambar.png)

- A. Jawaban A
- B. Jawaban B *

🖼️ Gambar pada Opsi

Contoh

## 4. Manakah yang benar?

- A. ![](https://example.com/a.png)
- B. Teks dan gambar ![](https://example.com/b.png) *
- C. Hanya teks biasa
- D. ![](https://example.com/d.png)

Contoh Lengkap

quiz-twk-pancasila.md

---
title: Latihan TWK - Pancasila & UUD 1945
program: PKN STAN
category: TWK
topic: Pancasila
type: practice
time_limit: 30
passing_score: 70
is_premium: false
---

## 1. Pancasila sebagai dasar negara Indonesia tercantum dalam?

- A. Pembukaan UUD 1945 *
- B. Batang Tubuh UUD 1945
- C. Penjelasan UUD 1945
- D. Tap MPR

> Pancasila tercantum dalam Pembukaan UUD 1945 alinea keempat.

## 2. Siapakah yang pertama kali merumuskan Pancasila?

- A. Moh. Hatta
- B. Ir. Soekarno *
- C. Moh. Yamin
- D. Soepomo

> Ir. Soekarno menyampaikan rumusan Pancasila pada 1 Juni 1945.

## 3. UUD 1945 disahkan oleh PPKI pada tanggal?

- A. 1 Juni 1945
- B. 17 Agustus 1945
- C. 18 Agustus 1945 *
- D. 22 Juni 1945

> UUD 1945 disahkan sehari setelah proklamasi kemerdekaan.

🤖 Generate Soal dengan AI

Kamu bisa menggunakan AI seperti ChatGPT, Claude, atau Gemini untuk membuat soal quiz secara otomatis. Copy prompt di bawah ini:

Copy Prompt

Copy template prompt di bawah ini

Edit Instruksi

Ganti bagian [GANTI: ...] sesuai kebutuhan

Paste ke AI

Kirim ke ChatGPT/Claude/Gemini

Import

Copy hasil AI ke halaman Import Quiz

AI Prompt Template

Buatkan soal quiz untuk Bimbel PKN STAN menggunakan format markdown berikut.

FORMAT:
- Frontmatter YAML dengan title, program, category, topic, type, time_limit, passing_score, is_premium
- Setiap soal dimulai dengan ## diikuti nomor dan titik
- Opsi jawaban menggunakan - A. B. C. D.
- Tandai jawaban benar dengan * di akhir baris
- Tambahkan penjelasan dengan > setelah opsi

INSTRUKSI:
- Kategori: [GANTI: TWK/TIU/TKP]
- Jumlah soal: [GANTI: 10/20/30]
- Topik: [GANTI: topik spesifik]
- Tingkat kesulitan: [GANTI: mudah/sedang/sulit]
- Setiap soal harus memiliki 4 opsi (A-D)
- Berikan penjelasan singkat untuk setiap jawaban benar

Contoh output yang diinginkan:

---
title: Latihan TWK 1
program: PKN STAN
category: TWK
topic: Pancasila
type: practice
time_limit: 30
passing_score: 70
is_premium: false
---

## 1. Pertanyaan?

- A. Opsi salah
- B. Opsi benar *
- C. Opsi salah
- D. Opsi salah

> Penjelasan singkat mengapa B benar.

## 2. Pertanyaan berikutnya?

- A. Opsi salah
- B. Opsi salah
- C. Opsi benar *
- D. Opsi salah

> Penjelasan.

💡

Tips: Minta AI untuk generate 10-20 soal sekaligus. Review hasilnya sebelum import untuk memastikan akurasi jawaban. Kamu juga bisa minta AI untuk membuat soal berdasarkan materi atau bab tertentu.

Cara Import

Buka Admin Panel → Quiz

Klik tombol 📥 Import Quiz

Upload file .md atau paste konten markdown

Klik 🚀 Import Quiz

✓

Quiz beserta semua soal dan opsi otomatis tersimpan!

Tips & Catatan

🤖

Gunakan AI

Generate soal dalam jumlah banyak, lalu review sebelum import

📁

Program & Kategori

Kategori harus sudah ada di sistem, di bawah program yang dituju. Tanpa program, default ke PKN STAN.

📄

Satu File = Satu Quiz

Untuk banyak quiz, import satu per satu

🛡️

Validasi Otomatis

Sistem menolak format salah atau kategori tidak ditemukan

🔒

Quiz Premium

Set is_premium: true untuk mengunci quiz — hanya member premium yang bisa mengerjakan