QuizTXT Format Guide

Create automatically graded questions from a simple TXT file and retry only the questions answered incorrectly.

Create QuizTXT from Questions and Answers

Write the question, correct answer, and, if needed, alternative answers or explanations in a TXT file using the format below.

When you upload the TXT file to QuizTXT, it displays the questions and grades them automatically, and you can retry only the questions answered incorrectly.

First Line: ++

Write the first line of the TXT file in the following format.

++[TAB]Question Title[TAB]Description
  • Enter ++ at the beginning of the first line.
  • Enter the question title in the second field.
  • You may enter a description in the third field. It appears below the title on the question screen.
  • The title and description are optional.
  • Separate each field with the TAB key.
++[TAB]World Geography Check[TAB]Enter your answers and grade them.
Do not type the characters “[TAB]”; press the actual TAB key to separate fields.

Writing Questions

  • Write one question per line, followed by the correct answer and, if needed, alternative answers.
  • Separate all fields with the TAB key.
  • You may add multiple alternative answers after the correct answer.
  • A single full-width or half-width numeral is treated as equivalent.
  • If there are no alternative answers, enter only the question and correct answer.
  • Blank lines are ignored.
What is the capital of France?[TAB]Paris

Multiple-Choice Questions

Write the question on one line, then write each choice on a separate line below it.

Begin a correct choice with :@ and an incorrect choice with ::, then press the TAB key and write the choice text.

Which feature is available in QuizTXT? :@[TAB]1. Automatic grading and retrying incorrect answers ::[TAB]2. Automatic creation of websites ::[TAB]3. Automatic increase of website visitors --[TAB]QuizTXT supports automatic grading and lets users retry only the questions they answered incorrectly.
  • :@ marks a correct choice.
  • :: marks an incorrect choice.
  • If there is more than one :@ choice, the question is displayed as a multiple-selection checkbox question.
  • After :@ or ::, separate the marker and the choice with an actual TAB character.
  • Write one choice per line below the question.
  • To add an explanation, place a -- line after the choices.
:@ and :: must be entered using ASCII characters. Do not type the characters “[TAB]”; press the actual TAB key.

True/False Questions

In the answer field, enter ○ if the statement is true, or × if it is false.

Paris is the capital of France.[TAB]○ Mount Everest is the second-highest mountain in the world.[TAB]×
In this question format, QuizTXT recognizes ○ and ×.

Images

On the line immediately after a question, enter [*], then specify the image URL in the second field, separated by an actual TAB character.

The second field contains the value of src (the image URL). The third field may contain the value of style. The style field is optional.

You can display multiple images for a single question by adding multiple [*] lines. Specify one image per line.

The images are displayed below the question in the order specified.

In what year did the Constitution of Japan come into effect?[TAB]1947 [*][TAB]https://sample.com/img1.jpg [*][TAB]https://sample.com/img2.jpg[TAB]width:300px; max-width:100%; height:auto; [*][TAB]https://sample.com/img3.jpg --[TAB]The Constitution of Japan came into effect in 1947.
  • Enter [*] using ASCII characters.
  • Enter [*] in the first field.
  • Enter the image URL in the second field.
  • You may enter the contents of the style attribute in the third field. This field is optional.
  • Separate each field with an actual TAB character.
  • You can specify multiple images for a single question.
  • To add multiple images, add one [*] line for each image.
  • Specify an image URL that can be displayed directly in a web browser.
  • If a question does not need an image, no [*] line is required.
When specifying a style, enter only the contents of the style attribute in the third field, not the full style="..." attribute.
Make sure you have the necessary rights to use each image, including copyright and other applicable rights.

Explanation

On the line immediately after the question, enter two ASCII hyphens --, press the TAB key, and then write the explanation.

For a multi-line explanation, write each line in the same format.

Mount Everest is the second-highest mountain in the world.[TAB]× --[TAB]Mount Everest is the highest mountain in the world by elevation above sea level. --[TAB]Its elevation is generally stated as 8,848.86 m.

Comments

Lines beginning with two ASCII slashes // are treated as comments and are not displayed on the question screen.

Comments can be used for notes or to group questions within the source file.

If a line begins with ++++, all following lines are ignored.

// Geography Questions Paris is the capital of France.[TAB]○ --[TAB]Paris is the capital and largest city of France. // Mountain Questions Mount Everest is the second-highest mountain in the world.[TAB]× --[TAB]Mount Everest is the highest mountain in the world by elevation above sea level.

Example

Copy the example below into a text editor and save it as a UTF-8 TXT file.

Separate fields with actual TAB characters.