QuizTXT writing guide

Basic rules

• Save the file as a UTF-8 TXT file.
• Separate items with the TAB key. Press the TAB key; do not type the letters “[TAB]”.
• One question per line. Write choices and explanations on the lines after the question.
• A file can have up to five questions.
• Blank lines are ignored, so you can add them between questions to keep things tidy.
• Type all symbols such as ++, ++%, ++#, :@, ::, -- and // as half-width (normal) characters.

Title (first line: ++)

++ [TAB] Quiz title [TAB] Description

• Put ++ in the first item.
• Put the quiz title in the second item.
• You can put a description in the third item. It appears under the title. The description is optional.
• If you leave out the title, no title line appears on the quiz screen.

Result screen settings (++% and ++#)New

These settings control the final result screen and the text used to share results. Write each on its own line, separate from the ++ line. Leave out any you do not need.

Messages by score (++%)

++% [TAB] Minimum score [TAB] Message

• Shows a short message under the score on the final result screen.
• Each line means “at or above this score, show this message”. Add as many lines as you need.
• The message shown is the one with the highest minimum that does not exceed the score. The lines can be in any order.

Here, 100 points shows the first message, 60–99 the second, and 0–59 the third.

Call to action and hashtags for sharing (++#)

++# [TAB] Hashtags [TAB] Call to action

• Adds a short call to action and your hashtags to the text that players copy with “Copy result” when they open the quiz from its published link.
• Separate several hashtags with spaces. #QuizTXT is added at the front automatically.
• Do not use symbols inside hashtags. A hashtag ends where a symbol appears.
• Without a call to action, a standard line (“How many can you get?”) is used.
• Posts on X and similar services have a length limit, so use two or three hashtags and keep the call to action short.

With this setting, “Copy result” copies text like this:

To change only the call to action, write ++#[TAB][TAB]Call to action. To add only hashtags, write ++#[TAB]#hashtag.

Example using the result screen settings

Short-answer questions

Question [TAB] Answer [TAB] Accepted answer [TAB] Accepted answer …

• Write the question and the answer on one line, separated by a TAB.
• You can add other accepted answers after the answer, each separated by a TAB. Any of them counts as correct.
• If there are no other accepted answers, write just the question and the answer.
• Full-width and half-width digits are treated as the same.

True/false questions

Question [TAB] ○ or ×

In the answer, write ○ if the statement is true and × if it is false. Use these exact symbols.

On the quiz screen these appear as “True” and “False” choices. The words follow the language of the screen.

Multiple-choice questions

:@ or :: [TAB] Choice

• Write the question on one line, then one choice per line below it.
• Start the correct choice with :@ and wrong choices with ::, then a TAB, then the choice.
• With one :@, the choices are radio buttons (pick one).
• With :@ on several lines, the choices are checkboxes, and the answer is correct only when all correct choices are selected.

Pick one

Pick all that apply

Shuffling the choicesNew

:@ or :: [TAB] Label [TAB] Choice

• If you write choice lines with three items, the order of the choices is shuffled when the quiz is generated. The order does not change each time the quiz is played.
• Put a label such as “A.” or “B.” in the second item and the choice in the third. Labels stay in order; only the choices move.
• If you do not need labels, leave the second item empty (type two TABs in a row).
• Choice lines with two items are not shuffled and appear in the order written.

Shuffling without labels

Players can select a choice by clicking its text as well as the radio button or checkbox.

Explanations

-- [TAB] Explanation

On the line right after the question (for multiple choice, after the choices), type --, a TAB and the explanation. For a longer explanation, write each line in the same way.

Explanations appear on the final result screen, after the second try at missed questions. They are hidden at the first check, so players can try again without seeing the answers.

Comments and stopping the reading

• Lines starting with // are comments and do not appear on the quiz screen. Use them for notes or to sort questions.
• If a line starts with ++++, everything after it is ignored.

Scoring and retry

• Press “Check” to score the quiz automatically out of 100.
• If you miss any questions, you get one more try at only the questions you missed.
• If the quiz was opened from its published link, “Copy result” lets players share their score on social media and elsewhere. See Sharing a quiz for details.

Languages

• The screens are available in English and Japanese.
• Questions and explanations can be written in English or Japanese. Labels such as “True” and “False” follow the language of the screen.

Full example

A five-question example with the result screen settings and all four question types. Copy it into a text editor and save it as a UTF-8 TXT file. Items are separated by TAB characters.