Obsidian Stats logoObsidian Stats

Note Quiz Engine

by markdown-quiz
5
4
3
2
1
Score: 50/100
Install Code

Description

Turn Obsidian notes into quizzes, practice multiple-choice and text questions, and track your scores in Markdown.

Reviews

No reviews yet.

Stats

0
stars
69
downloads
0
forks
33
days
33
days
33
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
23
commits

Latest Version

0.3.2
a month ago

Changelog

Adds an explicit quiz generation language setting with Japanese, English, and source-note options. The selected language is sent directly in the prompt and overrides provider defaults.

Also includes the portable release ZIP generated by pnpm run package.

Install

  1. Download note-quiz-engine.zip below (not Source code).
  2. Extract it into your vault's .obsidian/plugins/ folder.
  3. Restart Obsidian and enable Note Quiz Engine.

Validation: TypeScript build, ESLint, 225 tests, startup smoke test with another quiz processor, and public ZIP extraction check.

See all version on GitHub

README file from

Github

Note Quiz Engine

English: README_EN.md

Obsidianのノートを、択一問題と記述問題の問題集に変えるプラグインです。問題の表示、採点、解説、正答率、成績履歴をMarkdownに保存します。AI連携は任意で、Claudianなどが作った問題も手書きの問題も同じ形式で使えます。

主な機能

  • 択一問題と記述問題、複数の正答文字列
  • 即時採点、解説、Score / Accuracy、再挑戦
  • quiz_source、quiz_created、Quiz Resultsの保存
  • Claudianなどへ渡す問題生成プロンプトと、1クリック生成
  • 生成言語の選択（日本語、English、元ノートと同じ言語）

インストール

  1. GitHub Releasesからnote-quiz-engine.zipをダウンロードします（Source codeではありません）。
  2. ZIPを解凍します。
  3. 中のnote-quiz-engineフォルダをVaultの.obsidian/plugins/へコピーします。
  4. Obsidianを再起動します。
  5. 設定 → コミュニティプラグイン → Note Quiz Engineを有効にします。

ZIPにはnote-quiz-engine/main.js、manifest.json、styles.cssだけが入っています。Node.jsやnpmは利用者には不要です。

使い方

ノートを開くと上部にGenerate quizとStart quizが表示されます。Generate quizはAIで新しい問題ノートを作成し、Start quizは現在のノートの問題を開始します。全問回答すると問題ノートの末尾に成績が保存されます。

AI / Claudianとの連携

Generate quizは現在のノートと設定したプロンプトをClaudianへ渡します。プラグインはLLM APIへ直接接続しません。Copilot、Codex、OpenCode、Ollamaなどを使う場合は、Generate quiz promptでプロンプトをコピーし、生成されたMarkdownをImport generated quiz from clipboardで取り込めます。

クイズ生成言語

設定 → Note Quiz Engine → Quiz generation languageで選びます。

  • 日本語: question、options、answers、explanationを日本語で生成します。
  • English: すべて英語で生成します。
  • 元ノートと同じ言語: 元ノートの言語を使います。

選択した言語はLLMプロバイダーの初期言語より優先されます。コマンド、ファイル名、API名などの技術識別子は必要に応じて原文で保持されます。

問題フォーマット

1つのMarkdownファイルに複数のnote-quizブロックを書けます。

```note-quiz
quiz:
  type: choice
  question: "メモリ使用状況を確認するコマンドは？"
  options:
    - "df"
    - "free"
  answer: 2
  explanation: "freeはメモリとswapを表示します。"
```

```note-quiz
quiz:
  type: text
  question: "メモリ使用状況を確認するコマンドを答えてください。"
  answers:
    - "free"
    - "free -h"
  explanation: "freeコマンドで確認できます。"
```

既存のquizブロックもStart quizで利用できます。インライン表示を使う新しいノートではnote-quizを使用してください。

アンインストール

設定 → コミュニティプラグインでNote Quiz Engineを無効化し、Vaultの.obsidian/plugins/note-quiz-engineフォルダを削除します。生成済みのMarkdown問題と成績は自動では削除されません。

開発者向け

pnpm install
pnpm run check
pnpm run package

Release ZIPはdist/note-quiz-engine.zipに生成されます。

Sponsors