§ Getting started
Accepted formats
Assessium accepts PDF, DOCX, PPTX, TXT, and Markdown as AI source material, and Markdown, JSON, or raw text for direct import.
For AI generation
- Upload PDF, DOCX, PPTX, TXT, or Markdown as source material.
- Assessium extracts the text and drafts questions from it.
For direct import
- Markdown for lecturer-friendly structured imports.
- JSON for schema-shaped content pipelines.
- Raw text for quick cleanup of existing questions.
Markdown Assessium understands
Markdown is the most forgiving author format. Use a single # title, optional metadata lines before the questions, then one ## heading per question.
# Introduction to Data Structures - Midterm Course Code: CS 201 Lecturer Name: Dr. Robert Akah-Mansu Time Limit Minutes: 45 Instructions: - Answer every question. - Submit before the timer ends. ## Question 1 (2 marks) Which structure uses LIFO ordering? - [ ] Queue - [x] Stack - [ ] Heap - [ ] Linked list ## Question 2 (3 marks) Select all linear data structures. - [x] Array - [x] Linked list - [ ] Heap - [ ] Binary tree ## Question 3 (3 marks) Name one advantage of a linked list. Answer: dynamic size; efficient insertion; efficient deletion Explanation: Linked lists can grow without contiguous memory.
- Metadata lines are key-value pairs such as Course Code, Course Title, Lecturer Name, Semester, Assessment Type, Time Limit Minutes, and Result Visibility Mode.
- Question headings can include marks, for example ## Question 1 (2 marks).
- Checked Markdown options, - [x], become accepted answers.
- Multiple checked options become a multiple-select question.
- Answer or Answers lines can also provide accepted answers.
- Explanation lines are saved as instructor notes and feedback text.
JSON Assessium understands
{
"title": "Introduction to Data Structures - Midterm",
"courseCode": "CS 201",
"lecturerName": "Dr. Robert Akah-Mansu",
"timeLimitMinutes": 45,
"instructions": ["Answer every question."],
"questions": [
{
"type": "MULTIPLE_CHOICE",
"prompt": "Which structure uses LIFO ordering?",
"points": 2,
"options": ["Queue", "Stack", "Heap", "Linked list"],
"acceptedAnswers": ["b"]
},
{
"type": "SHORT_ANSWER",
"prompt": "Name one linked-list advantage.",
"points": 3,
"acceptedAnswers": ["dynamic size", "efficient insertion"]
}
]
}- Question type values are MULTIPLE_CHOICE, MULTIPLE_SELECT, TRUE_FALSE, or SHORT_ANSWER.
- Options can be strings or objects with id/text fields.
- Accepted answers can be option IDs, option labels, booleans, numbers, or short-answer strings.
- Points can be numeric strings or numbers.
- Required defaults to true when omitted.
Raw text Assessium understands
Introduction to Data Structures - Midterm Course Code: CS 201 Lecturer Name: Dr. Robert Akah-Mansu Time Limit Minutes: 45 1. Which structure uses LIFO ordering? (2 marks) A. Queue B. Stack C. Heap D. Linked list Answer: B 2. Name one linked-list advantage. (3 marks) Expected answer: dynamic size; efficient insertion; efficient deletion
- Raw text questions should start with a number, such as 1. or Q1.
- Options should use A. Option, B. Option, or similar lettered labels.
- Use Answer, Correct Answer, Correct Answers, Correct, or Ans to mark accepted answers.
- Metadata key-value lines can appear between the title and the first question.
- Raw text is best-effort. Clear numbering and explicit answer lines produce cleaner imports.
note
Direct import (paste or upload) reads Markdown, JSON, and TXT. To bring in a PDF, DOCX, or PPTX, use Generate with AI, which extracts the text for you.
accepted-formats