1.5 KiB
1.5 KiB
description, argument-hint
| description | argument-hint |
|---|---|
| Validate quiz markdown file format | input.md |
Validate quiz markdown file format and show statistics.
Usage
markdown-quiz-exporter-tool validate INPUT.md [OPTIONS]
Arguments
INPUT.md: Quiz markdown file to validate (required)-v/-vv/-vvv: Verbosity (INFO/DEBUG/TRACE)
Examples
# Basic validation
markdown-quiz-exporter-tool validate quiz.md
# With verbose output for debugging
markdown-quiz-exporter-tool validate quiz.md -vv
Output
On Success
Shows statistics about the quiz:
- Total question count
- Single choice vs multiple choice breakdown
- Answer statistics (total, average per question, correct count)
- Explanation coverage
On Error
Shows detailed error information:
- Exact line number where error occurred
- Problematic line content
- Context lines (2 before, 2 after)
- Clear error message with fix suggestions
- Question block number
Common Errors
Mixed answer types:
Error at line 5: Cannot mix ( ) and [ ] formats in same question
Fix: Use consistent format - either ( ) for single choice OR [ ] for multiple choice
No correct answer:
Error at line 3: No correct answer marked. Use (X) or [X]
Fix: Mark at least one answer with (X) or [X]
No answers found:
Error at line 2: No answers found. Expected format: '- (X) text'
Fix: Add answer options in format - (X) answer or - [X] answer
No question text:
Error at line 1: No question text found
Fix: Add question text before answer options