User Guide

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

Overview
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.

To start, here's two sample quiz document (standard quiz doc, barebone quiz doc) to give you a sense of the variety of questions we can ingest. We support much much more formats and more are added everyday as our AI gets more intelligent.
Prefer docx over PDF
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.
Supported Question Types
  1. True-false question
  2. Multiple choice question
  3. Multiple response question
  4. Cloze question (fill-in-the-blank)
  5. Cloze question (select dropdown menu)
  6. Open-ended question
  7. Matching question
Answer Scheme
To key in the answers for each question, you can either use our web interface or do it directly in your docx file.

In most cases, the 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, these are some surefire ways.

Inside your docx file, include the label answer: immediately after each question like so:

1.  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.


In addition, for MCQs and true-false questions, you may also use asterisk * and bold to label the correct answers.

2.  Which color of light has the shortest frequency?

   a) Blue*

   b) Red

   c) Green

   d) Orange

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

   (a) George Bush

  *(b) George Washington

   (c) George Clooney

   (d) George Russell

4.  What is the chemical formula of water?

   a. O2H

   b. HO2

   c. H2O

   d. OH2

5.  T* F  The sky is blue.


Specifically, you can
  • Add asterisk * on the immediate right of the correct option.
  • Add asterisk * on the immediate left of the correct option.
  • Bold the correct option including the mcq label.


Alternatively, you can 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.

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

Answer Scheme

1) Process G is pollination

2) a

3) b

4) c

5) T



Finally, setting of answers inside pdf files is currently not supported but will be in the near future.
Standard Question Formatting
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.
Non Standard Question Formatting
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.
Non Standard MCQ
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
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
Matching question is a question type where learners have a associate elements of two list with each other. Here's an example:

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.



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

Match the following terms with their definitions:

1. Atrocity

2. Fanatical

3. Pensive

To register as 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. Also, in this format, you cannot set the correct answer for the questions. You will have to use our web interface to do so after conversion has taken place.

If you want to define the correct answer together with the questions, here's how you can do it:

7. Match the invention with its inventor.

  Thomas Edison = Light Bulb

  Alexander Graham Bell = Telephone

  Wright brothers = Aeroplane

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

7. Match the invention with its inventor.

  Thomas Edison

  Alexander Graham Bell

  Wright brothers

The items on the left of the equal sign would be treated as the matching questions, and the right would be treated as the correct matching options.
Cloze Question
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.


The cloze question starts with a question number (recommended practice for all questions too) followed by the question text. To create the "blanks", use a series of underscore (this symbol _) 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] 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] 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
Fill-in-the-blanks only
Select-dropdown only
Fill-in-the-blanks and select-dropdown

You can always use our platform to adminster the questions if your LMS doesn't support it. We provide a lightweight quiz engine for you to do that.
Shared Stimulus
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.
Missing Charts and Shapes
Charts and shapes are not extracted from your Word document, only images. We suggest that you replace the charts and shapes with the screenshot image of objects. This can be done on the original word doc or on our web interface after quiz question extraction.

Maths Equation Errors
If the extracted maths equation looks compressed and pixelated, this is due to the use of MathType Equation in your document. MathType equations were used in old word documents because Microsoft Word didn't have good support for rendering maths equations in the past, so teachers would install a separate plugin for it.

Now, however, you should convert them into the newer Office Math Equation. 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 math type.
If however, you see solid border with two grey tabs on the side, then its Office Math and no further action is required.
Once the offending offending MathType Equation is found, double click on it and a pop up will appear.
Check the box "Apply to all equations" and click the "yes" button. All the MathType equation will be automatically converted into Office Math and you can resubmit your file for conversion on GETMARKED Digitaliser.

Handling Conversion Errors
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.
Support
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.