Metadata-Version: 2.1
Name: mkdocs_quiz
Version: 0.0.41
Summary: A mkdocs plugin to create a quiz in your markdown document.
Home-page: https://github.com/skyface753/mkdocs-quiz
Author: Sebastian Jörz
Author-email: sjoerz@skyface.de
License: Apache License 2.0
Description-Content-Type: text/markdown
Requires-Dist: mkdocs

# MkDocs Quiz Plugin

## [Demo](https://skyface753.github.io/mkdocs-quiz/)

## Create your first quiz

```bash
<?quiz?>
question: Are you ready?
answer-correct: Yes!
answer: No!
answer: Maybe!
content:
<h2>Provide some additional content</h2>
<?/quiz?>
```

> **Info** The answers can get styled with HTML (like `<code>Yes!</code>`)

> **Warning** The quiz content needs to be valid **_HTML_**

## Multiple choice

You can also create a multiple choice quiz, by providing multiple answers as correct.

```bash
<?quiz?>
question: Are you ready?
answer-correct: Yes!
answer: No!
answer-correct: Maybe!
content:
<h2>Provide some additional content</h2>
<?/quiz?>
```

## Screenshots

### Quiz (single choice)

<img src="assets/images/quiz.png" width="400rem">

### Quiz (multiple choice)

<img src="assets/images/quiz-multi.png" width="400rem">

## Disable for a page

```markdown
---
quiz: disable
---
```
