Quizzes
A quiz is a quick self-check: a short question right in the text, so readers can see whether they followed what they just read. The reader picks an answer and presses Check, and sees right away whether it is correct and why. Nothing is graded or saved.
Everything in a quiz is ordinary Markdown text: the question, the answers, the hints and the explanation. It is translated together with the rest of the text.
To add a quiz, wrap it in a ::: {#quiz} block:
::: {#quiz}
Question
- [ ] Wrong answer
- [x] Correct answer
Explanation
:::Everything before the answers is the question. Everything after them is the explanation, which the reader sees once they have checked their answer. The explanation is optional.
Answer options
Write the answers as a list. Start each item with [ ], or with [x] for a correct answer.
Several correct answers
Mark two or more answers with [x], and the quiz asks the reader to select all that apply. The answer counts only if the reader picks every correct option and nothing else.
Hints for an answer
Add a quote with > under an answer, indented to line up with its text. The reader sees it when they pick that answer and check. Use it to explain why a wrong answer is wrong.
Number answer
When the answer is a number, write a = and the number in place of the answers. The reader types the number, and it is compared as a number, so 3, 3.0 and 3,0 are all accepted.
Rules
One question per quiz block. Add more blocks for more questions.
A quiz has either answer options with at least one marked
[x], or a number answer, never both. Text with a broken quiz can't be saved.The number answer is a whole or decimal number, such as
9,-2or0.25.The question and the explanation can hold anything Markdown allows: code, formulas, images.
Quizzes work in pages, posts and course materials, not in comments.