Guide: Passages & Question Groups

For reading-comprehension exams where multiple questions share one passage, dialogue, or data set — e.g. national exams, TOEIC/IELTS Reading, or close-reading exercises.

1. What is a passage?

A passage (question group) is a shared content block — a reading text, dialogue, or form — shown next to its related questions. Each question inside the group still has its own options, points, and explanation, just like a normal question.

When to use it:

• Reading comprehension: one text for 3–5 questions.
• Sectioned exams: SECTION 1, SECTION 2… each with its own question set.
• Data/chart reading: an image of a chart or form with analysis questions.

2. Create a passage with the UI

1. In the editor, click the "Add passage" button (violet, next to "Add question").
2. Fill in the dialog:
   • Title: e.g. "SECTION 1 — WORKING FROM HOME".
   • Content: Markdown supported (headings, bold, lists, tables, code blocks).
   • Instructions (optional): e.g. "Read the passage and answer questions 1–5."
   • Image (optional): upload a chart or diagram.
3. Click "Add passage" to save. The passage card appears in the Preview panel.

Tip: A quiz can contain multiple passages — each one acts as its own section with its own questions.

3. Attach questions to a passage

Two ways:

• Option 1: Click "Add question to passage" at the bottom of the passage card — the new question joins that passage.
• Option 2: For existing questions, use the "Move to passage" dropdown right below the question card in the Preview panel and pick the target passage.

To detach a question, choose "No passage" in the same dropdown.

4. Managing passages

Each passage card lets you:

• "Edit passage": reopen the content dialog.
• "Move passage to top" / "Move passage to bottom": move the passage together with all its linked questions.
• "Delete passage": the app asks you to confirm —
  • Delete passage only — questions become independent (nothing is lost).
  • Delete passage and N questions: removes the whole group.

5. Writing passages directly in Markdown

Prefer typing? Write it straight in the Editor tab:

:::passage
# SECTION 1 — WORKING FROM HOME

Your reading text, Markdown **supported**.

:::

# Q1: First question linked to the passage above
[A] Option A
*[B] Correct answer
[C] Option C
[D] Option D

---

# Q2: Second question linked to the passage above
[A] Option A
[B] Option B
* Answer: B

:::endpassage

Rules to remember:

• :::passage opens, ::: closes the content part, the questions after it automatically belong to the group, and :::endpassage closes the whole group.
• A # Title line right after :::passage becomes the passage name; images are added with ![Passage Image](url).
• Do not use fill-in blanks [[...]] inside passage content.

Note: Unsure about the syntax? Building it with the UI (section 2) is always the fastest, safest path.

6. AI and Word import create passages too

• Import from Word: source documents with reading sections are detected and turned into passages with their questions.
• AI Quiz Creator (topic / file / image): depending on the content, the AI may generate reading passages — review them in the Preview panel before saving.

7. What students see

• Desktop: the passage stays fixed in the left panel with questions on the right — scroll the text and answer without losing your place.
• Mobile: a "View passage" button opens it full-screen; close it to keep answering.
• In exam mode, passage + question groups are shuffled as whole units so reading context is never broken.

See also: Manual Quiz Editor for detailed question syntax, or AI-Powered Quiz Creation to build quizzes fast.