Table of Contents
◾️ Steps to Create an Original Question
Click
Challengeson the left sidebar.In the top-right corner, click
＋ Create New Quiz.
Fill in the basic settings (required / optional):
Title
Description
Default Time(Recommended answering time)
Difficulty
Quiz category
Language
Tags(optional)
Next to “Choose from Question” click
＋ Add.Choose questions from the list you want to include, then click
OK.Drag questions to reorder them as desired.
Click
OK.
◾️ Bulk-Import from a ZIP File
Click the Choose File button next to “Import from ZIP ” to upload a batch of your own questions.
See details here
◾️ Overview
A Quiz is a collection of multiple Questions.
Track currently supports three Question types:
Type | Description |
MCQ (Multiple Choice Question) | Choose one or more correct options from several choices |
FIB (Fill in Blank) | Enter one or more missing words or phrases |
Free Text | Enter a free-form answer (no automatic grading) |
You can combine multiple Questions in a single Markdown document.
◾️ Basic Rules
Start each Question with an H2 heading (
##) that serves as the Question title.Write the Question body below the title in Markdown. • Headings (
# – ######) may NOT be used inside the body.If the body contains two or more lines beginning with
[ ]or[x], the Question is treated as an MCQ. • At least one[x](correct option) is required; otherwise, compilation fails.If the body contains exactly one
${FREETEXT}, the Question is treated as Free Text. •${FREETEXT}is replaced by a text-area in the UI.All other cases are treated as FIB. • Define blanks with
${answer}(exact match) or${/regex/}(regular expression). • At least one blank is required; otherwise, compilation fails.The document is rendered with
marked, so standard Markdown applies. See the Markdown extension guide for details.
◾️ Advanced Rules
Parts Within a Question (Experimental)
Currently, Track displays a Quiz as a single block, so part-splitting is effectively disabled.
If needed, the first horizontal rule defined with --- splits the Question into Part 1 and Part 2:
Everything before the first
--→ Part 1
• Everything after → Part 2
Additional --- lines stay within Part 2.
Horizontal rules defined with other characters (***, etc.) are NOT treated as splitters.
◾️ Image Handling
When referencing images in Markdown, list each file in the images section of track.yml.
To include many files at once:
images: - images/*.png
Reference images with a relative path from the Markdown file, for example:
Track uploads the images to a public path during processing.
◾️ Fill-in-the-Blank Syntax
The default placeholder syntax is ${}.
The capital of France is ${Paris}.If your content already uses ${} (e.g., ES6 code), switch to another prefix directly below the H2 title:
## Question Title - prefix: %
Blanks must then be written as %{answer}.
You can use regular expressions:
// Case-insensitive match for red or green ${/red|green/i}◾️ Level-1 Heading
A single H1 (#) is allowed at the very top of the document for a short description.
Track ignores this section when importing the Quiz.
◾️ Hint / Tips / Answer Sections
Add supplemental information at the end of a Question with H3 headings:
### hint …your hint here… ### tips …additional tips…
Content under hint, tips, or answer is stripped during compilation and never shown to candidates.
◾️ track.yml Configuration
type: quiz questions: - question1.md - question2.md images: - images/*.png
typemust bequiz.
• List one or more Markdown files under questions.
• If your Questions reference images, declare them under images (wildcards allowed).
For details, see here.
◾️ Using Extended Markdown
Book, Quiz, and Challenge all use a custom extension of marked for converting Markdown to HTML (CSS differs slightly per type, but HTML conversion is the same).