User Guide

Ideally, if we did our job well, you would never have to visit this page. But since you are here, something must have went wrong. This user guide will provide you with some unambiguous recommendation to fix your problem.

GETMARKED Digitaliser allows you to import any kind of quiz in one-click as long as the document was prepared for classroom use in mind. Your quiz do not need to be formatted in any specific way, we will intelligently infer what's inside.

Here's some sample Word document quizzes to give you a sense of the variety of questions we can convert:

We support much much more formats and more are added everyday as our AI gets more intelligent.

Supported Question types

True-false question
Multiple choice question
Multiple response question
Cloze question
(fill-in-the-blank)
Cloze question
(select dropdown menu)
Open-ended question
Matching question
Likert question

Supported Platforms

Canvas
Blackboard
Moodle
Brightspace
Schoology
CYPHER/NEO LMS
Zensai Learn365 (Formerly LMS365)
Sakai
Google Classroom/Forms
Microsoft Forms
itslearning
Ilias
TalentLMS
Adobe Captivate
Wooclap
Kahoot!
Quizizz
Blooket
Gimkit
Quizalize
Pear Assessment (Formerly Edulastic)
Socrative
Zoom
LearnDash
Coursera
H5P.com Quiz (Question Set)
SLS

Support file formats

docx
json (Google Form)
Canvas, Brightspace, itslearning, NEO LMS, Ilias QTI zip file
Blackboard pools and tests zip file
Common cartridge imscc file
QTI 1.2 zip file
QTI 2.1 zip file
QTI 2.2 zip file
Moodle XML file
Cognero QTI zip file
WebCT zip file
GIFT TXT file
Aiken TXT file
Blackboard TSV TXT file
CSV Spreadsheet
pdf (discouraged)

To set the correct answers for each question, you can either use our web interface or do it directly in your docx file.

In most cases, our system would be able to intelligently infer where the answers are in your docx file. If however you are facing difficulties in getting your answers picked up, you can either create an answer scheme at the bottom of the document (recommended approach) or annotate the answers directly in the question.

There are four ways to annotate the correct answer in the question, with multiple choice questions you can annotate the correct answer using either:

Bold
Highlight
Answer tag
Asterisk

Here's some examples,

1. Which color of light has the shortest frequency?

a) Blue

b) Red

c) Green

d) Orange

2. Who is the first President of the United States?

(a) George Bush

(b) George Washington

(c) George Clooney

(d) George Russell

3. What is the chemical formula of water?

a. O₂H

b. HO₂

*c. H₂O

d. OH₂

4. T* F The sky is blue.

Specifically, you can

Highlight the entire choice option.
Bold the entire choice option.
Add asterisk * on the immediate right of the correct option.
Add asterisk * on the immediate left of the correct option.

For True-false questions, you may even simply leave the correct answer directly below the question body. Here's some example.

1. The earth has two moons.

F

2. There are seven continents in the world.

True

3. New Mexico is part of Mexico.

False

For open ended questions, you can only use Answer: tag to annotate the correct answer. Append the tag at the end of each question like so:

5. Process H also occurs in plant P. The diagram shows how a fruit is formed from the flower of plant P. The fruit of plant P has also been cut open.

(i) Describe the process G.

Answer: Process G is pollination

Any variant of answer: or ans: is accepted. The colon : after ans must be present.

Alternatively, you can also leave all the answers in an Answer Scheme at the end of the document too. Please be sure to start the answer scheme with the word Answer Scheme in its own line.

(all the questions from 1 to 5) ...

Answer Scheme

1) a

2) b

3) c

4) T

5) Process G is pollination

Finally, setting of answers inside pdf files is currently not supported but will be in the near future.

Beyond the simple Answer Scheme definition you see above, where every answer is in its own line. Answer scheme can also be defined in tables. Please be sure to start the answer scheme with the word --Answer Scheme-- in its own line.

(16 multiple choice questions not shown for brevity ....)

Answer Scheme

Q1	Q2	Q3	Q4
A	C	B	D
Q5	Q6	Q7	Q8
C	C	A	B

9	D	13	B
10	C	14	B
11	A	15	A
12	C	16	B

Lastly, please note that Answer Scheme cannot be used to define the answers for both Select-Drop-Down questions and Matching Questions.

Currently, feedback can set for any question type by using the Feedback: or Explanation: tag. Here's an example.

1) What is the color of the sky?

a) Orange

b) Red

c) Blue

d) Green

Answer: c

Explanation: The color of the sky is blue due to rayleigh scattering.

Feedback will be shown to the learner after an attempt, regardless of whether they got it right or wrong. If your feedback consist of multi-line paragraphs and content, then you must place the Feedback: tag as the last metadata tag in the question. Nothing should come after it.

If you want to feedback to be displayed specifically for when the response is correct or incorrect use the following tags respectively Correct Feedback: and Incorrect Feedback:

Currently, choice specific feedback for MCQ is not available. Please reach out to support if you need it.

If you are facing difficulties converting your files, we recommend that adhere these standard formatting guideline:

All questions should start with a question number following by parenthesis.
Question content should be after the question number and not before.
All MCQ options should start with an alphabetical label followed by a parenthesis.
Answers are annotated using asterisk on the immediate right of the correct answer.

Here's an example.

1) How many days are there in a year?

a) 360 days

b) 365 days*

c) 361 days

d) 375 days

We accept any format as long as it's prepared for classroom use. But if you are facing issues trying to get your question recognised, this is a surefire way to do so. Please do not preemptively style your quiz in this format before verifying that it fails on our system. Our mission is to help you save time, not give you more work to do.

In cases where you want to create a quiz in a quick and dirty way, this is the most barebone and stripped down format we accept.

What is the largest living terrestrial animal on earth?

Rhinoceros

Hippopotamus

Elephant*

Giraffe

The earth rotates around the sun.

True

You can forgo both (1) starting the question with a question number and (2) starting the mcq option with an alphabetical label.

Regardless of how you choose to create your quiz, please ensure that either all or none of the questions starts with question number. We do not accept inconsistent quiz structure.

Lastly, if you choose to start with a question number for each quiz question, there's more than one way to define them. Here's two ways.

Question 1.

What is the largest living animal on earth?

A) Blue whale

B) Giant Squid

C) Elephant

D) Crocodile

Ans: A

Question: 2

What is the largest living terrestrial animal on earth?

A) Rhinoceros

B) Hippopotamus

C) Elephant*

D) Giraffe

The bottom line is that you should just submit your quiz file as is for conversion. If it doesn't convert optimally, then you can make adjustments. We support a lot more formats that what is on this user guide.

There's a huge variety of ways MCQs can be created. Here are some non standard MCQ that we support.

6. Pregnant patients at term increase their tidal volume by approximately:

10%

20%

30%

40%*

When an MCQ is without option labels (i.e. ABCD), it must have a correct answer annotated by bold or asterisk and a minimum of four options to be registered as an MCQ.

7. How many litres of blood does a human body have?

two litres
three litres
four litres
five litres

Bullet points can also be used in place of regular option labels. Currently, only 4 and 5 bullet point options are supported.

8. How many bones does the adult human body have?

1) 124

2) 168

3) 206

4) 251

MCQ option labels can be numeric too (i.e. 1234 instead of ABCD).

Lastly, please note that while we support non standard MCQ formats, you are discouraged from using it as those formats are inherently ambiguous and might convert sub-optimally in some edge cases.

Multiple response question (MRQ) is the same as MCQ except that learners can select two or more options. Creating an MRQ is the same as how you would create an MCQ, only that you annotate more than one option as the correct answer.

6. Select all the states that are part of the European Union.

A) Vietnam

B) Brazil

C) France*

D) Germany

*E) Italy

In the above example, the correct answer is C), D) and E).

You can also define the correct answer using the ans: tag.

6. Which options belows are consider organs of the human body. Select all that apply.

A) Skin

B) Hair

C) Brain

D) Toe

E) Heart

Ans: A, C, E

Matching question is a question type where learners have to associate elements of two list with each other.

To register as a matching question, there must be an instruction within the question text that contains "match the ...." (or equivalent) to hint that it is a matching question. Here's an example.

7. Match the invention with its inventor.

Thomas Edison = Light Bulb

Alexander Graham Bell = Telephone

Wright brothers = Aeroplane

The items on the left of the equal sign would be treated as the "questions", and the right would be treated as the correct matching "options".

Different LMS will render matching question differently, here's how it might look in your LMS:

7. Match the invention with its inventor.

Thomas Edison
Alexander Graham Bell
Wright brothers

Here's another possible format to create matching question.

Match the following terms with their definitions:

1. Atrocity

2. Fanatical

3. Pensive

a. An extremely wicked or cruel act.

b. Filled with excessive and single-minded zeal.

c. Engaged in, involving, or reflecting deep or serious thought.

In this format, the list with number labels will be the "questions" and the list with alphabet labels will be the matching "options". you cannot set the correct answer in the Word document for this format. Please use our web interface to define the correct answer after import. If you want to define the correct answer together with the questions in Word document, please use the equal sign format mentioned above.

When exported to your LMS, it may be rendered as such:

Match the following terms with their definitions:

1. Atrocity
2. Fanatical
3. Pensive

Cloze questions are questions that get the learner to fill-in-the-blank. It can be constructed like so:

15. The Grand Canyon is a steep-sided canyon carved by the Colorado River in [[*Arizona, Utah, California, Nevada]]. The canyon is a result of [[erosion, weathering]] which exposes one of the most complete geologic columns on the planet.

15. The Grand Canyon is a steep-sided canyon carved by the Colorado River in _________ [*Arizona, Utah, California, Nevada]. The canyon is a result of _________ [erosion, weathering] which exposes one of the most complete geologic columns on the planet.

The cloze question starts with a question number (recommended practice for all questions too) followed by the question text.

To create the "blank", you can use double square brackets [[ ... ]] to represent a "blank". Alternatively, use a series of underscore (this symbol _ and at least 4 of them) followed by a single enclosing square bracket ____ [ ... ] as you might do if you were preparing the quiz for normal classroom use.

There are two types of cloze questions you can choose from. Either select-dropdown or fill-in-the-blank. Here's how you are create them:

Select-dropdown: options are defined inside the square brackets with the correct answer annotated by asterisk either at the front or the back of the option.

For example, ________ [*Arizona, Utah, California, Nevada] or [[*Arizona, Utah, California, Nevada]] will render as

Fill-in-the-blank: answers should be defined inside square brackets, separated by a comma between alternative correct answers.

For example, _______ [Arizona, Utah] or [[Arizona, Utah]] will be rendered as .

Finally, please note that different LMS has different level of support for this very useful question type.

Cloze Type	Canvas	Moodle	Blackboard	Schoology	Brightspace	NEO LMS	itslearning
Fill-in-the-blanks only
Select-dropdown only
Fill-in-the-blanks and select-dropdown

In language exams, it might be common to have a passage where learners are supposed to fill-in-the-blanks. It can be constructed like so below:

Suddenly she came upon a little three-legged table, all made of solid glass; there was (9) _________ on it except a tiny golden key, and Alice’s first (10) _________ was that it might belong to one of the doors of the hall; but, alas! either the locks were too large, or the key was too small, but at any rate it would not open any of them. (11) _________ , on the second time round, she came upon a low curtain she had not noticed before, and behind it was a little door about fifteen inches high: she tried the little golden key in the lock, and to her great delight it fitted!

Note that this question doesn't have to start with a question number as all the response fields are numbered and that there are at least 3 response fields. Response field also need to have at least 4 underscore to be treated as a response field.

Should you choose to not number the response field, then you should follow the format of a cloze question instead.

It is common when creating quiz questions to have multiple questions refer to the same data (aka. shared stimulus). Here's an example,

Using the table below, answer questions 10 to 12.

	Knocky	Flor	Ella	Juan
Breed	Jack Russell	Poodle	Streetdog	Cocker Spaniel
Age	16	9	10	5
Owner	Mother-in-law	Me	Me	Sister-in-law
Eating Habits	Eats everyone's leftovers	Nibbles at food	Hearty eater	Will eat till he explodes

10. Who is the owner of Ella?

Ans: me

11. Which dog is the oldest?

Ans: Knocky

12. What breed is Juan?

Ans: Cocker Spaniel

After conversion, the shared stimulus (in this case the table) will be included in each of the individual question.

One surefire way to ensure that the shared stimulus is recognised by the system is to use the phrase

".... to answer questions X to Y" or "... to answer the next X questions",

where X and Y are numbers.

Variants of the same phrasing will also be accepted.

Charts, shapes and grouped images are not extracted from your Word document, only standalone images. We suggest that you replace those objects with the screenshot of itself. This can be done on the original word doc or on our web interface after quiz question extraction.

If the extracted maths equation looks different from what you see in your Word document (e.g. compressed and/or pixelated), this is due to the use of MathType Equation in your document. MathType equation is a closed proprietary standard developed by WIRIS. As the data is proprietary, extracting it is extremely difficult. We strongly recommend that you migrate to using Office Math Equation, which is an open standard developed by Microsoft and comes along with every Microsoft Word.

To identify whether an equation is a MathType equation, click on it. If you see dashed line borders and small grey squares like the image below, then it is a MathType equation.

$MathType equation$

If however, you see solid border with two grey tabs on the side, then its Office Math and no further action is required.

$office math equation$

Once the offending MathType Equation is found, double-click on it and a pop up will appear.

$convert math type to office math equation$

Check the box "Apply to all equations" and click the "yes" button. All your MathType equation will be automatically converted into Office Math Equations and you can resubmit your file for conversion on GETMARKED Digitaliser.

If you do not see the dialog box to convert all equations appear, it is because your MS Word has MathType add-in installed. We recommend you disable it temporarily so that you can convert your equations to Office Math Equation.

Here's the instructions for Windows:

From the Office Button or File tab, choose Word Options (2010 and later: Options).
Along the left pane of the resulting window click Add-Ins.
At the bottom of the window, next to "Manage" use the drop-down menu to choose Word Add-ins and click Go.
In the list of currently active templates, uncheck the box next to MathType Commands 6 for Word.dotm or MathType Commands for Word.dotm.

For more help on how to disable MathType add-in in your MS Word, please refer to the full instructions.

For subjects like Computing, your quiz questions might contain code content, which is customarily styled with a monospace font and have their whitespace indents preserved.

To tell GETMARKED Word document importer that your text or paragraph is code, please apply Consolas font on text that should be treated as code in your Word document. Below is a sample of what the code text will look like after import from your Word document, with all indents kept when it normally isn't.

Question 1. From the code snippet below, what is the output of factorial if n is 5 ?


n = int(input('Type a number, and its factorial will be printed: '))

if n < 0:
    raise ValueError('You must enter a non-negative integer')

factorial = 1
for i in range(2, n + 1):
    factorial *= i

print(factorial)

Please note that when you export code text to your LMS, your LMS may style it differently from how we style it. For most LMS, they will always use a monospace font when rendering code text.

You can refer to this word document code quiz on how code question should be constructed.

Metadata can be defined at the end of every question in your Word document. Here's a sample.

1. Explain how insulin regulates a person's blood sugar level.

Bloom: Explain

Difficulty: Medium

Topic: Hormones

Subject: AP Biology

Metadata keyword must be followed by a colon.

The metadata captured would be store your item bank where you can later use it to filter and retrieve questions of specific topic or difficulty or any other dimension that you specified. Here's a list of metadata that we accept. The list is non-exhaustive.


                                ['ans', 'answer', 'correct answer', 'answers', 'answerscheme', 'markscheme', 'jawaban',
                                'đáp án', 'solución', 'diff', 'dif', 'difficulty', 'difficulty level', 'complexity',
                                'lod', 'type', 'category', 'question type', 'answer location', 'accessibility', 'subject',
                                'title', 'section', 'feedback', 'general feedback', 'explanation', 'explanations', 'reference',
                                'references', 'explanation/reference', 'rationale', 'reason', "here's why", 'explanation of answer',
                                'forklaring', 'solution', 'pembahasan', 'razonada', 'correct feedback', 'incorrect feedback',
                                'bloom', 'blooms', "bloom's", 'taxonomy', 'skill level', 'level', 'aacsb standard', 'skl',
                                'aacsb', 'aicpa bb', 'aicpa fc', 'aicpa fn', 'aicpa pc', 'ima', 'min', 'national standards',
                                'national standard', 'learning objective', 'learning objectives', 'lo', 'learning outcome',
                                'learning outcomes', 'objective', 'chapter this maps to', 'cognitive domain', 'page ref',
                                'page', 'reference', 'page reference', 'page number', 'source', 'section', 'ref', 'pts',
                                'points', 'item weight', 'nat', 'analytic', 'top', 'topic', 'topics', 'ahead', 'var', 'sta',
                                'has variables', 'date created', 'date modified', 'msc', 'keywords']

If there are errors in the extracted questions or if your document fails to convert completely, here are some steps you can take:

Email support with the document and specify the problem that you face. We will get back to you in 24hrs.
Format the document as if you will be using it in classroom. Quiz documents that are generated by a LMS tends not to convert well.
Remove all bold, underline and italics. Annotate answers using only asterisk on the immediate right of the correct answer.
Remove content that has nothing to do with the quiz. Things like cover page, table of content, answer scheme should be removed.
If your document is huge, reduce half the content and try converting again. Repeat until it works.

Submitting an Mht docx file for import will result in a no data found in file error. A Mht Word file is a Docx file where the underlying data is stored as HTML. This is a very uncommon format and is not supported by us.

Luckily, it very easy to convert it into a proper Word document file. Open the offending file using Microsoft Word, make any changes to the document (e.g. add a new line by pressing the Enter key). Then Save as a new docx file. Resubmitting the new file and it will now import correctly in GETMARKED Digitaliser.

PDF conversion is meant for legacy worksheets where the instructor only have hardcopies of it left. If you have the original docx file, you should use docx. Conversion from docx file is more performant. Many of the features are only available in docx conversion.

If your pdf was originally exported from Word, then you can use Microsoft Word to open the pdf file and convert it back into docx. The docx file, while not the same as the original, would still perform better than a pdf.

If you have to use pdf (due to legacy hardcopy worksheets), then we recommended that each pdf file is less than 15 pages and only contains the quiz questions and nothing else (i.e. remove the cover page, answer scheme, etc.). Additionally, the scan quality should be at least 150 dpi greyscale. Black and white is not recommended. Docx files have no such limitations.

Below are links to resources that will show you how to export your quiz and question banks from your LMS:

Once exported, you can upload the resulting question bank file into GETMARKED. We support question bank files from all major learning management systems.

Should you encounter any difficulties with the conversion, please reach out to support@getmarked.ai. We are very responsive and will get back to you within one work day.

If we did our job well, you will never need a user guide