OMJ Question Converter
🔒 Privacy: All document processing happens entirely in your browser. Your question content is never uploaded to any server.
📝 Write Questions
Author JLPT, SSW, or JFT questions directly in the browser using a guided form editor.
📤 Upload Word File
Download the official template, fill it in, upload the .docx file, and convert to validated JSON.
📋 Paste Template Text
Paste multiple questions in the OMJ template syntax and parse them instantly.
📄 Download Templates
Get official Word templates for JLPT (Kanji, Bunpou, Choukai), SSW, and JFT Basic.
Supported Profiles
JLPT
Japanese Language Proficiency Test (N1–N5). Sections: Kanji & Vocabulary, Grammar & Reading, Listening (Choukai).
SSW
Specified Skilled Worker examination across 12 industry sectors.
JFT Basic
Japan Foundation Test for Basic Japanese — Vocabulary, Conversation, Reading, Listening.
Create Questions
Questions (0)
- No questions yet.
Question Editor
Click + Add to create your first question.
Preview & Validation
Select a question to preview.
📥 Download a template first if you haven't already —
go to Word Templates.
Fill in the template and upload it here.
Click to select or drag and drop your .docx file here
Supported: .docx only · Max size: 10 MB
Parsed Questions
- Upload a file to see parsed questions.
Paste your question blocks in the OMJ template syntax below.
Each block must start with
=== OMJ QUESTION START === and end with === OMJ QUESTION END ===.
See the Help page for the full template syntax.
Word Templates
Download an official template, fill it in using Microsoft Word (or a compatible editor), then upload it in the
Create Questions → Upload Word tab.
Do not change the field labels or delete the
=== OMJ QUESTION START === / === OMJ QUESTION END === markers.
JLPT — Japanese Language Proficiency Test
JLPT Kanji & Vocabulary
For vocabulary recognition and Kanji reading questions. Supports title, passage, question, 4 text options, answer, explanation, chapter, section, lesson, and tags.
JLPT Grammar & Reading
For grammar completion and reading comprehension questions. Full passage support with multiline content.
JLPT Listening (Choukai)
For listening comprehension questions. Supports audio file references. Image-based options: enter an image URL in each option field.
SSW — Specified Skilled Worker
SSW Question Template
For all SSW sector examinations. Fields: ID (format: ssw-sector-N), question, 4 options, answer, explanation. No JLPT-specific fields.
JFT Basic — Japan Foundation Test
JFT Vocabulary (Moji-Goi)
Tests vocabulary and Hiragana/Katakana knowledge.
JFT Conversation (Kaiwa)
Dialogue-based questions. Preserves multiline conversation text.
JFT Reading (Dokkai)
Reading passage questions. Supports ruby markup (
<ruby>...<rt>...</rt></ruby>) and multiline passages.JFT Listening (Choukai)
Listening questions with audio reference field. Enter an audio path or URL in the AUDIO field.
⚠️ Note on dependencies:
Templates are generated in your browser using
docx.js.
If the CDN is unavailable, a .txt fallback file is provided that the OMJ converter can also parse directly.
Internet access is required only for the first load of these libraries — your question content is never transmitted.
Export JSON
Click Validate & Export to run the schema validator, then download the resulting JSON file.
Questions with blocking errors cannot be exported until the errors are resolved.
// Validate your questions to generate the JSON preview here.
ℹ️ About the output format
JLPT: Exports as
SSW: Exports as a JSON array of question records
JFT: Exports as a JSON array of question records
{ "sections": [ { "id": "kanji", "title": "...", "questions": [...] } ] }SSW: Exports as a JSON array of question records
[{ "id": "...", "question": "...", ... }]JFT: Exports as a JSON array of question records
[{ "id": "...", "section": "...", ... }]
Help & Template Guide
Overview
OMJ Question Converter helps you prepare question data for the Omoshiroi Japan (OMJ) learning platform. You can author questions three ways:
- Write Questions: Use the browser-based form editor.
- Upload Word: Download an official .docx template, fill it in, and upload it.
- Paste Text: Paste multiple questions in the OMJ template syntax.
OMJ Template Syntax
All three input methods use the same internal parsing engine. The template syntax uses explicit block markers and field labels:
=== OMJ QUESTION START === PROFILE: JLPT LEVEL: N5 GROUP_ID: kanji TYPE: kanji ID: N5-Kanji-1 TITLE: もんだい１ の ことばは ひらがなで どう かきますか。 PASSAGE: QUESTION: いま <u>店の</u> まえにいます。 OPTION_A: いえ OPTION_B: えき OPTION_C: みせ OPTION_D: へや ANSWER: C IMAGE: AUDIO: EXPLANATION: CHAPTER: Lesson 01 SECTION: Kanji LESSON: Lesson 01 TAGS: N5 | Vocabulary | Kanji === OMJ QUESTION END ===
Field Descriptions
Common to all profiles
PROFILE— Required. One of:JLPT,SSW,JFT.ID— Required. A unique question identifier.QUESTION— Required. The question text. May be multiline.OPTION_AthroughOPTION_D— Required. Answer options.ANSWER— Required. One of: A, B, C, D.EXPLANATION— Optional. Explanation of the correct answer.
JLPT-specific
LEVEL— N5, N4, N3, N2, or N1.GROUP_ID— Section bucket:kanji,bunpou, orchoukai.TYPE— Question type: same as GROUP_ID for standard questions.TITLE— Instruction text shown above the question.PASSAGE— Reading passage for bunpou questions.IMAGE— Image URL or project-relative path.AUDIO— Audio file URL or path (e.g.assets/audio/n5-01-1.mp3).CHAPTER,SECTION,LESSON— Metadata for organization.TAGS— Pipe-separated list:N5 | Vocabulary | Kanji.
SSW-specific
- ID format:
ssw-sector-N(e.g.ssw-agriculture-1). - Only these fields are exported:
id,question,options,answer,explanation.
JFT-specific
SECTION— Required. One of:vocabulary,conversation,reading,listening.AUDIO— Required for listening questions.- ID formats:
jft-v-1,jft-c-1,jft-r-1,jft-l-1.
HTML Markup in Questions
The following HTML tags are supported inside question text and options:
<u>text</u>— Underline<ruby>漢字<rt>かんじ</rt></ruby>— Furigana (ruby annotation)<br>— Line break<strong>,<em>— Bold, italic
Enter these as literal text in your Word template. The converter preserves them as-is in the exported JSON.
Image-Based Options (JLPT Choukai)
For Choukai questions where options are images, enter the image URL directly in the option field:
OPTION_A: https://example.com/images/option-a.png OPTION_B: https://example.com/images/option-b.png
In the online editor, select "Image options" from the Option Type dropdown, then enter the image URL for each option.
The converter will serialize these as {"image": "..."} objects as required by the schema.
Multiple Question Blocks
You can include as many question blocks as needed in a single file. Each block must have its own START and END markers. Copy and paste the blank template block for each additional question.
Validation
The converter checks:
- Required fields are present and non-empty.
- Answer key (A, B, C, or D) matches an existing option.
- No duplicate question IDs within the exported file.
- Correct root structure per profile (JLPT: sections wrapper; SSW/JFT: array).
- JFT section values are valid (vocabulary, conversation, reading, listening).
- JLPT tags is an array of strings.
- Image-based options have a usable image reference (Choukai).
Export
- Questions with errors cannot be exported until the errors are resolved.
- Questions with warnings can be exported after review.
- The exported JSON uses readable 2-space indentation.
- All Japanese characters, newlines, and HTML strings are preserved exactly.
Integration with OMJ
After downloading your validated JSON file:
- Review the file in a text editor to confirm it looks correct.
- Place it in the appropriate location in your OMJ repository (e.g.
data/N5.json). - Add any referenced image and audio files to the corresponding
assets/folders. - Test the questions in the OMJ application.
The converter does not automatically publish or modify the OMJ production application.