diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index 36895eb..0b22ad7 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -3,7 +3,7 @@ name: Tests
 on:
   push:
     branches:
-      - "main"
+      - "**"
     tags-ignore:
       - "v*"
   pull_request:
@@ -17,3 +17,16 @@ jobs:
       - uses: actions/checkout@v2
       - name: Setup
         uses: ./.github/workflows/setup
+      - name: Install Aquascope
+        # tag should match mdbook-aquascope version
+        run: |          
+          git clone -b v0.3.0 https://github.com/cognitive-engineering-lab/aquascope
+          cd aquascope
+          cargo make install-mdbook
+      - name: Test Rust package
+        run: cargo test --all-features --locked
+      - name: Lint Rust package
+        run: cargo clippy --all-features --locked -- -D warnings
+      - name: Test JS package
+        run: depot test
+        working-directory: js
\ No newline at end of file
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index c879800..7d68dc9 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -35,22 +35,10 @@ jobs:
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v2
-      - uses: actions-rs/toolchain@v1
+      - name: Setup
+        uses: ./.github/workflows/setup
         with:
-          toolchain: stable
           target: ${{ matrix.target }}
-          profile: minimal
-          override: true
-      - name: Install cargo-make
-        uses: baptiste0928/cargo-install@v2
-        with:
-          crate: cargo-make
-      - name: Install Depot
-        run: |
-          curl https://raw.githubusercontent.com/cognitive-engineering-lab/depot/main/scripts/install.sh | sh
-          echo "PATH=$HOME/.local/bin:$PATH" >> $GITHUB_ENV
-      - name: Initialize TS bindings
-        run: cargo make init-bindings
       - name: Build Rust package
         run: cargo build -p mdbook-quiz --release --locked ${{ matrix.kind == 'full' && '--features rust-editor --features aquascope' || '' }}
       - name: Package artifact
@@ -60,9 +48,22 @@ jobs:
         with:
           name: ${{ matrix.target }}_${{ matrix.kind }}
           path: target/release/mdbook-quiz_${{ matrix.target }}_${{ matrix.kind }}.tar.gz
+
+  build-schema:
+    runs-on: ubuntu-latest
+    steps: 
+      - uses: actions/checkout@v2
+      - name: Setup
+        uses: ./.github/workflows/setup  
+      - name: Build schema
+        run: cargo run --bin gen-json-schema --features json-schema > mdbook-quiz.schema.json
+      - uses: actions/upload-artifact@v2
+        with:
+          name: schema
+          path: mdbook-quiz.schema.json
   
   publish-artifacts:
-    needs: build-artifacts
+    needs: [build-artifacts, build-schema]
     runs-on: ubuntu-latest
     steps:
       - uses: actions/download-artifact@v2
@@ -74,6 +75,7 @@ jobs:
             x86_64-apple-darwin_bare/mdbook-quiz_x86_64-apple-darwin_bare.tar.gz
             aarch64-unknown-linux-gnu_bare/mdbook-quiz_aarch64-unknown-linux-gnu_bare.tar.gz
             aarch64-apple-darwin_bare/mdbook-quiz_aarch64-apple-darwin_bare.tar.gz      
+            schema/mdbook-quiz.schema.json
     
   publish-crate:
     needs: publish-artifacts
diff --git a/.github/workflows/setup/action.yaml b/.github/workflows/setup/action.yaml
index e76d781..4e7a9fb 100644
--- a/.github/workflows/setup/action.yaml
+++ b/.github/workflows/setup/action.yaml
@@ -1,4 +1,9 @@
 name: Setup
+
+inputs:
+  target:
+    default: x86_64-unknown-linux-gnu
+
 runs:
   using: composite
   steps:
@@ -7,6 +12,8 @@ runs:
         profile: minimal
         toolchain: stable
         components: clippy
+        target: ${{ inputs.target }}
+        override: true
     - uses: Swatinem/rust-cache@v1
     - name: Install cargo-make
       uses: baptiste0928/cargo-install@v2
@@ -15,17 +22,6 @@ runs:
     - name: Install Depot
       run: curl https://raw.githubusercontent.com/cognitive-engineering-lab/depot/main/scripts/install.sh | sh
       shell: bash
-    # Note: we have to build before test so the build script is executed
     - name: Initialize TS bindings
       run: cargo make init-bindings
-      shell: bash
-    - name: Test Rust package
-      run: cargo test --locked
-      shell: bash
-    - name: Lint Rust package
-      run: cargo clippy --locked -- -D warnings
-      shell: bash
-    - name: Test JS package
-      run: depot test
-      working-directory: js
       shell: bash
\ No newline at end of file
diff --git a/Cargo.lock b/Cargo.lock
index a6f478e..41cfebe 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -445,6 +445,12 @@ dependencies = [
  "crypto-common",
 ]
 
+[[package]]
+name = "dyn-clone"
+version = "1.0.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "23d2f3407d9a573d666de4b5bdf10569d73ca9478087346697dcbae6244bfbcd"
+
 [[package]]
 name = "either"
 version = "1.9.0"
@@ -531,6 +537,12 @@ dependencies = [
  "miniz_oxide",
 ]
 
+[[package]]
+name = "fluid-let"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "749cff877dc1af878a0b31a41dd221a753634401ea0ef2f87b62d3171522485a"
+
 [[package]]
 name = "fnv"
 version = "1.0.7"
@@ -1173,7 +1185,9 @@ dependencies = [
 name = "mdbook-quiz-schema"
 version = "0.1.1"
 dependencies = [
+ "schemars",
  "serde",
+ "serde_json",
  "toml",
  "ts-rs 7.0.0",
 ]
@@ -1183,6 +1197,7 @@ name = "mdbook-quiz-validate"
 version = "0.1.1"
 dependencies = [
  "anyhow",
+ "fluid-let",
  "markdown",
  "mdbook-quiz-schema",
  "miette",
@@ -1750,6 +1765,30 @@ dependencies = [
  "winapi-util",
 ]
 
+[[package]]
+name = "schemars"
+version = "0.8.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1f7b0ce13155372a76ee2e1c5ffba1fe61ede73fbea5630d61eee6fac4929c0c"
+dependencies = [
+ "dyn-clone",
+ "schemars_derive",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "schemars_derive"
+version = "0.8.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e85e2a16b12bdb763244c69ab79363d71db2b4b918a2def53f80b02e0574b13c"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "serde_derive_internals",
+ "syn 1.0.109",
+]
+
 [[package]]
 name = "scoped-tls"
 version = "1.0.1"
@@ -1788,11 +1827,22 @@ dependencies = [
  "syn 2.0.29",
 ]
 
+[[package]]
+name = "serde_derive_internals"
+version = "0.26.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85bf8229e7920a9f636479437026331ce11aa132b4dde37d121944a44d6e5f3c"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
 [[package]]
 name = "serde_json"
-version = "1.0.105"
+version = "1.0.107"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "693151e1ac27563d6dbcec9dee9fbd5da8539b20fa14ad3752b2e6d363ace360"
+checksum = "6b420ce6e3d8bd882e9b243c6eed35dbc9a6110c9769e74b584e0d68d1f20c65"
 dependencies = [
  "itoa",
  "ryu",
diff --git a/Makefile.toml b/Makefile.toml
index d1e35e3..bc9473e 100644
--- a/Makefile.toml
+++ b/Makefile.toml
@@ -3,7 +3,6 @@ skip_core_tasks = true
 default_to_workspace = false
 
 
-# Precommit
 [tasks.precommit-cargo]
 script = "cargo fmt && cargo clippy"
 
@@ -13,20 +12,10 @@ script = "cd js && depot fmt"
 [tasks.precommit.run_task]
 name = ["precommit-js", "precommit-cargo"]
 
-[tasks.init-bindings]
-script = """
-cargo test -p mdbook-quiz-schema --locked export_bindings
-mkdir -p js/packages/quiz/src/bindings
-cp crates/mdbook-quiz-schema/bindings/* js/packages/quiz/src/bindings
-"""
 
-# Watch
 [tasks.watch]
-script = "cargo watch -x 'install --path crates/mdbook-quiz --debug --offline --features rust-editor --features source-map' -w src -w js/packages/quiz-embed/dist --ignore-nothing"
+script = "cargo watch -x 'install --path crates/mdbook-quiz --debug --offline --features rust-editor --features source-map' -w crates -w js/packages/quiz-embed/dist --ignore-nothing"
 
-[tasks.watch.run_task]
-name = ["watch-cargo"]
-parallel = true
 
 [tasks.clean]
 script = """
@@ -35,6 +24,14 @@ cd js && depot clean && cd ..
 rm -rf js/packages/quiz/src/bindings crates/mdbook-quiz-schema/bindings
 """
 
+
+[tasks.init-bindings]
+script = """
+cargo test -p mdbook-quiz-schema --locked export_bindings
+mkdir -p js/packages/quiz/src/bindings
+cp crates/mdbook-quiz-schema/bindings/* js/packages/quiz/src/bindings
+"""
+
 [tasks.install]
 dependencies = ["init-bindings"]
 script = """
diff --git a/crates/mdbook-quiz-schema/Cargo.toml b/crates/mdbook-quiz-schema/Cargo.toml
index db69355..015dcef 100644
--- a/crates/mdbook-quiz-schema/Cargo.toml
+++ b/crates/mdbook-quiz-schema/Cargo.toml
@@ -7,9 +7,14 @@ license = "MIT OR Apache-2.0"
 edition = "2021"
 repository = "https://github.com/cognitive-engineering-lab/mdbook-quiz"
 
+[features]
+json-schema = ["dep:schemars", "dep:serde_json"]
+
 [dependencies]
 serde = {version = "1.0.188", features = ["derive"]}
 ts-rs = "7.0.0"
+schemars = {version = "0.8.15", optional = true}
+serde_json = {version = "1.0.107", optional = true}
 
 [dev-dependencies]
-toml = { workspace = true }
\ No newline at end of file
+toml = { workspace = true }
diff --git a/crates/mdbook-quiz-schema/src/bin/gen-json-schema.rs b/crates/mdbook-quiz-schema/src/bin/gen-json-schema.rs
new file mode 100644
index 0000000..fd6a6ec
--- /dev/null
+++ b/crates/mdbook-quiz-schema/src/bin/gen-json-schema.rs
@@ -0,0 +1,15 @@
+fn main() {
+  #[cfg(feature = "json-schema")]
+  {
+    use mdbook_quiz_schema::Quiz;
+    use schemars::schema_for;
+
+    let schema = schema_for!(Quiz);
+    println!("{}", serde_json::to_string_pretty(&schema).unwrap());
+  }
+
+  #[cfg(not(feature = "json-schema"))]
+  {
+    panic!("Must run with --feature json-schema")
+  }
+}
diff --git a/crates/mdbook-quiz-schema/src/lib.rs b/crates/mdbook-quiz-schema/src/lib.rs
index ac364c2..48cf5b7 100644
--- a/crates/mdbook-quiz-schema/src/lib.rs
+++ b/crates/mdbook-quiz-schema/src/lib.rs
@@ -1,49 +1,122 @@
+//! The schema for questions used in `mdbook-quiz`. Intended to be deserialized from a TOML file.
+//! See [`Quiz`] as the top-level type. Here is an example of a quiz:
+//!
+//! ```toml
+//! [[questions]]
+//! id = "b230bed3-d6ba-4048-8b06-aa655d837b04"
+//! type = "MultipleChoice"
+//! prompt.prompt = "What is 1 + 1?"
+//! prompt.distractors = ["1", "3", "**infinity**"]
+//! answer.answer = ["2"]
+//! context = """
+//! Consult your local mathematician for details.
+//! """"
+//! ```
+//!
+//! Note that all Rust identifiers with multiple words (e.g. `does_compile`) use camelCase keys,
+//! so should be written as `doesCompile` in the TOML.
+
+#![warn(missing_docs)]
+
 use serde::{Deserialize, Serialize};
+use std::collections::HashMap;
 use ts_rs::TS;
 
+#[cfg(feature = "json-schema")]
+use schemars::JsonSchema;
+
+/// A quiz is the top-level data structure in mdbook-quiz.
+/// It represents a sequence of questions.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 pub struct Quiz {
+  /// The questions of the quiz.
   pub questions: Vec<Question>,
+
+  /// Context for multipart questions.
+  ///
+  /// Maps from a string key to a description of the question context.
+  #[ts(optional)]
+  pub multipart: Option<HashMap<String, Markdown>>,
 }
 
+/// A [Markdown](https://commonmark.org/help/) string.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 pub struct Markdown(pub String);
 
+/// An individual question. One of several fixed types.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 #[serde(tag = "type")]
 pub enum Question {
+  /// A [`ShortAnswer`] question.
   ShortAnswer(ShortAnswer),
+  /// A [`Tracing`] question.
   Tracing(Tracing),
+  /// A [`MultipleChoice`] question.
   MultipleChoice(MultipleChoice),
 }
 
+/// Fields common to all question types.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 #[serde(rename_all = "camelCase")]
 pub struct QuestionFields<Prompt, Answer> {
+  /// A unique identifier for a given question.
+  ///
+  /// Used primarily for telemetry, as a stable identifer for questions.
   #[ts(optional)]
   pub id: Option<String>,
+
+  /// If this key exists, then this question is part of a multipart group.
+  /// The key must be contained in the [`Quiz::multipart`] map.
+  #[ts(optional)]
+  pub multipart: Option<String>,
+
+  /// The contents of the prompt. Depends on the question type.
   pub prompt: Prompt,
+
+  /// The contents of the answer. Depends on the question type.
   pub answer: Answer,
+
+  /// Additional context that explains the correct answer.
+  ///
+  /// Only shown after the user has answered correctly or given up.
   #[ts(optional)]
   pub context: Option<Markdown>,
+
+  /// If true, asks all users for a brief prose justification of their answer.
+  ///
+  /// Useful for getting a qualitative sense of why users respond a particular way.
   #[ts(optional)]
   pub prompt_explanation: Option<bool>,
 }
 
+/// The kind of response format (and subsequent input method) that accompanies
+/// a given short answer questions.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 #[serde(rename_all = "lowercase")]
 pub enum ShortAnswerResponseFormat {
+  /// A one-sentence response, given an `<input>`
   Short,
+
+  /// A long-form response, given a `<textarea>`
   Long,
+
+  /// A code response, given a code editor
   Code,
 }
 
+/// A prompt for a [`ShortAnswer`] question.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 pub struct ShortAnswerPrompt {
   /// The text of the prompt.
@@ -54,7 +127,9 @@ pub struct ShortAnswerPrompt {
   pub response: Option<ShortAnswerResponseFormat>,
 }
 
+/// An answer for a [`ShortAnswer`] question.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 pub struct ShortAnswerAnswer {
   /// The exact string that answers the question.
@@ -65,18 +140,24 @@ pub struct ShortAnswerAnswer {
   pub alternatives: Option<Vec<String>>,
 }
 
+/// A question where users type in a response.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 pub struct ShortAnswer(pub QuestionFields<ShortAnswerPrompt, ShortAnswerAnswer>);
 
+/// A prompt for a [`Tracing`] question.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 pub struct TracingPrompt {
   /// The contents of the program to trace.
   pub program: String,
 }
 
+/// An answer for a [`Tracing`] question.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 #[serde(rename_all = "camelCase")]
 pub struct TracingAnswer {
@@ -92,11 +173,15 @@ pub struct TracingAnswer {
   pub line_number: Option<usize>,
 }
 
+/// A question where users guess the output of a program.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 pub struct Tracing(pub QuestionFields<TracingPrompt, TracingAnswer>);
 
+/// A prompt for a [`MultipleChoice`] question.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 #[serde(rename_all = "camelCase")]
 pub struct MultipleChoicePrompt {
@@ -115,22 +200,31 @@ pub struct MultipleChoicePrompt {
   pub sort_answers: Option<bool>,
 }
 
+/// The type of response for a [`MultipleChoice`] question.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 #[serde(untagged)]
 pub enum MultipleChoiceAnswerFormat {
+  /// There is one correct answer.
   Single(Markdown),
+
+  /// There are multiple correct answers, and the user must select each.
   Multi(Vec<Markdown>),
 }
 
+/// An answer for a [`MultipleChoice`] question.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 pub struct MultipleChoiceAnswer {
   /// The text of the correct answer.
   pub answer: MultipleChoiceAnswerFormat,
 }
 
+/// A question where users select among several possible answers.
 #[derive(Debug, Serialize, Deserialize, TS)]
+#[cfg_attr(feature = "json-schema", derive(JsonSchema))]
 #[ts(export)]
 pub struct MultipleChoice(pub QuestionFields<MultipleChoicePrompt, MultipleChoiceAnswer>);
 
diff --git a/crates/mdbook-quiz-validate/Cargo.toml b/crates/mdbook-quiz-validate/Cargo.toml
index be1ffab..3c9f69c 100644
--- a/crates/mdbook-quiz-validate/Cargo.toml
+++ b/crates/mdbook-quiz-validate/Cargo.toml
@@ -18,3 +18,4 @@ anyhow = { workspace = true }
 toml-spanned-value = "0.1.0"
 tempfile = "3.8.0"
 textwrap = "0.16.0"
+fluid-let = "1.0.0"
diff --git a/crates/mdbook-quiz-validate/src/impls/markdown.rs b/crates/mdbook-quiz-validate/src/impls/markdown.rs
index 2fec24e..f5cd1fa 100644
--- a/crates/mdbook-quiz-validate/src/impls/markdown.rs
+++ b/crates/mdbook-quiz-validate/src/impls/markdown.rs
@@ -31,7 +31,17 @@ impl Validate for Markdown {
 
     let nodes = collect_nodes(&root);
     let dict = crate::spellcheck::dictionary();
-    let base = value.start() + 1; // +1 for opening quotation
+    let open_quote = &cx.contents()[value.start()..];
+    let quote_size = if let Some(next) = open_quote.strip_prefix(r#"""""#) {
+      if next.starts_with('\n') {
+        4
+      } else {
+        3
+      }
+    } else {
+      1
+    };
+    let base = value.start() + quote_size;
     for node in nodes {
       if let (Node::Text(text), Some(pos)) = (node, node.position()) {
         let errors = dict
@@ -48,7 +58,7 @@ impl Validate for Markdown {
             word: substr.to_string(),
             span: span.into(),
           };
-          cx.error(error);
+          cx.warning(error);
         }
       }
     }
@@ -76,5 +86,6 @@ prompt.prompt = "Hello **wrold**"
 answer.answer = ""
 prompt.distractors = [""]
 "#;
-  assert!(crate::harness(contents).is_err());
+  // TODO: right now this test is just verified looking at stderr
+  assert!(crate::harness(contents).is_ok());
 }
diff --git a/crates/mdbook-quiz-validate/src/impls/mod.rs b/crates/mdbook-quiz-validate/src/impls/mod.rs
index 02e9893..ff80c72 100644
--- a/crates/mdbook-quiz-validate/src/impls/mod.rs
+++ b/crates/mdbook-quiz-validate/src/impls/mod.rs
@@ -1,4 +1,5 @@
-use crate::{tomlcast, SpannedValue, Validate, ValidationContext};
+use crate::{cxensure, tomlcast, SpannedValue, SpannedValueExt, Validate, ValidationContext};
+use fluid_let::{fluid_let, fluid_set};
 use mdbook_quiz_schema::{Question, QuestionFields, Quiz};
 
 mod markdown;
@@ -6,12 +7,30 @@ mod multiple_choice;
 mod short_answer;
 mod tracing;
 
+fluid_let!(static QUIZ: Quiz);
+
 impl Validate for Quiz {
   fn validate(&self, cx: &mut ValidationContext, value: &SpannedValue) {
+    fluid_set!(QUIZ, self);
+
+    cxensure!(
+      cx,
+      !self.questions.is_empty(),
+      labels = vec![value.labeled_span()],
+      "Quiz must have at least one question"
+    );
+
     let table = tomlcast!(value.table["questions"].array);
     for (q, qvalue) in self.questions.iter().zip(table.iter()) {
       q.validate(cx, qvalue);
     }
+
+    if let Some(multipart) = &self.multipart {
+      let multipart_val = tomlcast!(value.table["multipart"]);
+      for (k, v) in multipart {
+        v.validate(cx, multipart_val.get_ref().get(k).unwrap());
+      }
+    }
   }
 }
 
@@ -30,8 +49,29 @@ impl<Prompt: Validate, Answer: Validate> Validate for QuestionFields<Prompt, Ans
     if let Some(id) = &self.id {
       cx.check_id(id, tomlcast!(value.table["id"]));
     }
+
+    if let Some(multipart) = &self.multipart {
+      let multipart_val = tomlcast!(value.table["multipart"]);
+      QUIZ.get(|quiz| {
+        let quiz = quiz.unwrap();
+        let contains_key = quiz
+          .multipart
+          .as_ref()
+          .map(|mps| mps.contains_key(multipart))
+          .unwrap_or(false);
+        cxensure!(
+          cx,
+          contains_key,
+          labels = vec![multipart_val.labeled_span()],
+          "Quiz does not have multipart: {multipart}"
+        );
+      });
+    }
+
     self.prompt.validate(cx, tomlcast!(value.table["prompt"]));
+
     self.answer.validate(cx, tomlcast!(value.table["answer"]));
+
     if let Some(context) = &self.context {
       context.validate(cx, tomlcast!(value.table["context"]));
     }
@@ -57,3 +97,42 @@ prompt.distractors = [""]
 "#;
   assert!(crate::harness(contents).is_err());
 }
+
+#[test]
+fn validate_multipart_spelling() {
+  let contents = r#"
+[multipart]
+a = """
+Hello wrold
+"""
+
+[[questions]]
+id = "hello"
+multipart = "a"
+type = "MultipleChoice"
+prompt.prompt = ""
+answer.answer = ""
+prompt.distractors = [""]
+"#;
+
+  // TODO: right now this test is just verified looking at stderr
+  assert!(crate::harness(contents).is_ok());
+}
+
+#[test]
+fn validate_multipart_key() {
+  let contents = r#"
+[multipart]
+a = ""
+
+
+[[questions]]
+id = "hello"
+multipart = "b"
+type = "MultipleChoice"
+prompt.prompt = ""
+answer.answer = ""
+prompt.distractors = [""]
+"#;
+  assert!(crate::harness(contents).is_err());
+}
diff --git a/crates/mdbook-quiz-validate/src/lib.rs b/crates/mdbook-quiz-validate/src/lib.rs
index f31fd83..4653421 100644
--- a/crates/mdbook-quiz-validate/src/lib.rs
+++ b/crates/mdbook-quiz-validate/src/lib.rs
@@ -1,3 +1,7 @@
+//! Validation logic for types in [`mdbook_quiz_schema`].
+
+#![warn(missing_docs)]
+
 use std::{
   cell::RefCell,
   collections::HashSet,
@@ -18,10 +22,16 @@ pub use toml_spanned_value::SpannedValue;
 mod impls;
 mod spellcheck;
 
+/// A thread-safe mutable set of question identifiers.
 pub type IdSet = Arc<Mutex<HashSet<String>>>;
 
+struct QuizDiagnostic {
+  error: miette::Error,
+  fatal: bool,
+}
+
 pub(crate) struct ValidationContext {
-  errors: RefCell<Vec<miette::Error>>,
+  diagnostics: RefCell<Vec<QuizDiagnostic>>,
   path: PathBuf,
   contents: String,
   ids: IdSet,
@@ -30,47 +40,61 @@ pub(crate) struct ValidationContext {
 impl ValidationContext {
   pub fn new(path: &Path, contents: &str, ids: IdSet) -> Self {
     ValidationContext {
-      errors: Default::default(),
+      diagnostics: Default::default(),
       path: path.to_owned(),
       contents: contents.to_owned(),
       ids,
     }
   }
 
-  pub fn error(&mut self, err: impl Diagnostic + Send + Sync + 'static) {
-    self.errors.borrow_mut().push(miette::Error::new(err));
+  pub fn add_diagnostic(&mut self, err: impl Into<miette::Error>, fatal: bool) {
+    self.diagnostics.borrow_mut().push(QuizDiagnostic {
+      error: err.into(),
+      fatal,
+    });
+  }
+
+  pub fn error(&mut self, err: impl Into<miette::Error>) {
+    self.add_diagnostic(err, true);
+  }
+
+  pub fn warning(&mut self, err: impl Into<miette::Error>) {
+    self.add_diagnostic(err, false);
   }
 
   pub fn check(&mut self, f: impl FnOnce() -> Result<()>) {
     if let Err(res) = f() {
-      self.errors.borrow_mut().push(res);
+      self.error(res);
     }
   }
 
   pub fn check_id(&mut self, id: &str, value: &SpannedValue) {
     let new_id = self.ids.lock().unwrap().insert(id.to_string());
     if !new_id {
-      self.errors.borrow_mut().push(miette!(
+      self.error(miette!(
         labels = vec![value.labeled_span()],
         "Duplicate ID: {id}"
       ));
     }
   }
+
+  pub fn contents(&self) -> &str {
+    &self.contents
+  }
 }
 
 impl fmt::Debug for ValidationContext {
   fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
     let handler = MietteHandler::default();
-    for error in self.errors.borrow_mut().drain(..) {
+    for diagnostic in self.diagnostics.borrow_mut().drain(..) {
       let src = NamedSource::new(self.path.to_string_lossy(), self.contents.clone());
-      let report = error.with_source_code(src);
+      let report = diagnostic.error.with_source_code(src);
       handler.debug(report.as_ref(), f)?;
     }
     Ok(())
   }
 }
 
-#[macro_export]
 macro_rules! cxensure {
   ($cx:expr, $($rest:tt)*) => {{
     $cx.check(|| {
@@ -80,11 +104,6 @@ macro_rules! cxensure {
   }};
 }
 
-pub(crate) trait Validate {
-  fn validate(&self, cx: &mut ValidationContext, value: &SpannedValue);
-}
-
-#[macro_export]
 macro_rules! tomlcast {
   ($e:ident) => { $e };
   ($e:ident .table $($rest:tt)*) => {{
@@ -101,6 +120,12 @@ macro_rules! tomlcast {
   }}
 }
 
+pub(crate) use {cxensure, tomlcast};
+
+pub(crate) trait Validate {
+  fn validate(&self, cx: &mut ValidationContext, value: &SpannedValue);
+}
+
 pub(crate) trait SpannedValueExt {
   fn labeled_span(&self) -> LabeledSpan;
 }
@@ -121,6 +146,7 @@ struct ParseError {
   span: Option<SourceSpan>,
 }
 
+/// Runs validation on a quiz with TOML-format `contents` at `path` under the ID set `ids`.
 pub fn validate(path: &Path, contents: &str, ids: &IdSet) -> anyhow::Result<()> {
   let mut cx = ValidationContext::new(path, contents, Arc::clone(ids));
 
@@ -139,12 +165,16 @@ pub fn validate(path: &Path, contents: &str, ids: &IdSet) -> anyhow::Result<()>
     }
   }
 
-  if !cx.errors.borrow().is_empty() {
+  let has_diagnostic = cx.diagnostics.borrow().len() > 0;
+  let is_fatal = cx.diagnostics.borrow().iter().any(|d| d.fatal);
+
+  if has_diagnostic {
     eprintln!("{cx:?}");
-    anyhow::bail!("Quiz failed to validate: {}", path.display())
-  } else {
-    Ok(())
   }
+
+  anyhow::ensure!(!is_fatal, "Quiz failed to validate: {}", path.display());
+
+  Ok(())
 }
 
 #[cfg(test)]
diff --git a/crates/mdbook-quiz-validate/src/spellcheck.rs b/crates/mdbook-quiz-validate/src/spellcheck.rs
index 1617759..823ba10 100644
--- a/crates/mdbook-quiz-validate/src/spellcheck.rs
+++ b/crates/mdbook-quiz-validate/src/spellcheck.rs
@@ -5,6 +5,9 @@ use zspell::{DictBuilder, Dictionary};
 static DICTIONARY: OnceLock<Dictionary> = OnceLock::new();
 static MORE_WORDS: OnceLock<String> = OnceLock::new();
 
+/// Register a `.dic` file into the dictionary for spellchecking.
+///
+/// Will return an error if called more than once.
 pub fn register_more_words(path: &Path) -> anyhow::Result<()> {
   let contents =
     fs::read_to_string(path).with_context(|| format!("Failed to read path: {}", path.display()))?;
diff --git a/crates/mdbook-quiz/build.rs b/crates/mdbook-quiz/build.rs
index e65c4cf..f548c1a 100644
--- a/crates/mdbook-quiz/build.rs
+++ b/crates/mdbook-quiz/build.rs
@@ -24,6 +24,7 @@ fn main() -> Result<()> {
     }
   }
 
+  println!("cargo:rerun-if-changed={JS_DIST_DIR}");
   let entries = fs::read_dir(js_dist_dir)?;
   let local_js_dist_dir = Path::new(LOCAL_JS_DIST_DIR);
   fs::create_dir_all(local_js_dist_dir)?;
diff --git a/example/src/chapter_1.md b/example/src/chapter_1.md
index e274f9c..b31aefc 100644
--- a/example/src/chapter_1.md
+++ b/example/src/chapter_1.md
@@ -2,6 +2,6 @@
 
 mdbook-quiz is a tool for embedding interactive quizzes into your mdBook. Here's an example you can try out:
 
-{{#quiz ./quiz.toml}}
+{{#quiz ./quiz-example.toml}}
 
 For more documentation, go to <https://github.com/cognitive-engineering-lab/mdbook-quiz>.
\ No newline at end of file
diff --git a/example/src/quiz.toml b/example/src/quiz-example.toml
similarity index 96%
rename from example/src/quiz.toml
rename to example/src/quiz-example.toml
index ddf764c..8622684 100644
--- a/example/src/quiz.toml
+++ b/example/src/quiz-example.toml
@@ -2,7 +2,6 @@
 type = "MultipleChoice"
 prompt.prompt = """
 What does it mean if a variable `x` is immutable?
-
 ```
 example
   intro h
@@ -44,4 +43,4 @@ answer.lineNumber = 4
 context = """
 This is a compiler error because line 4 tries to mutate `x` when `x` is not marked as `mut`.
 """
-id = "bba6a299-b20f-4685-934a-792a591df3c0"
+id = "bba6a299-b20f-4685-934a-792a591df3c0"
\ No newline at end of file
diff --git a/js/packages/quiz-embed/rust-editor-placeholder.css b/js/packages/quiz-embed/rust-editor-placeholder.css
index e69de29..1f80be3 100644
--- a/js/packages/quiz-embed/rust-editor-placeholder.css
+++ b/js/packages/quiz-embed/rust-editor-placeholder.css
@@ -0,0 +1 @@
+/* intentionally left blank */
\ No newline at end of file
diff --git a/js/packages/quiz-embed/rust-editor-placeholder.js b/js/packages/quiz-embed/rust-editor-placeholder.js
index ff8b4c5..96cd87d 100644
--- a/js/packages/quiz-embed/rust-editor-placeholder.js
+++ b/js/packages/quiz-embed/rust-editor-placeholder.js
@@ -1 +1,2 @@
-export default {};
+export let Editor = undefined;
+export let raSetup = undefined;
diff --git a/js/packages/quiz-embed/src/index.scss b/js/packages/quiz-embed/src/index.scss
index 0caced3..232c763 100644
--- a/js/packages/quiz-embed/src/index.scss
+++ b/js/packages/quiz-embed/src/index.scss
@@ -458,5 +458,13 @@ $error-color: #e16969;
     }
   }
 
-
+  .multipart-context {
+    padding-left: 1em;
+    .multipart-context-content {
+      border: 1px solid $light-border-color;
+      padding: 0.5em;
+      background-color: var(--theme-popup-bg);      
+      margin-bottom: 1em;      
+    }
+  }
 }
diff --git a/js/packages/quiz/src/components/quiz.tsx b/js/packages/quiz/src/components/quiz.tsx
index 90313d0..8e8fce3 100644
--- a/js/packages/quiz/src/components/quiz.tsx
+++ b/js/packages/quiz/src/components/quiz.tsx
@@ -11,7 +11,8 @@ import React, {
   useState,
 } from "react";
 
-import { Quiz } from "../bindings/Quiz";
+import type { Question } from "../bindings/Question";
+import type { Quiz } from "../bindings/Quiz";
 import {
   AnswerView,
   QuestionView,
@@ -147,42 +148,47 @@ let loadState = ({
   }
 };
 
-let Header = observer(
-  ({
-    quiz,
-    state,
-    ended,
-  }: {
-    quiz: Quiz;
-    state: QuizState;
-    ended: boolean;
-  }) => (
-    <header>
-      <h3>Quiz</h3>
-      <div className="counter">
-        {state.started ? (
-          !ended ? (
-            <>
-              Question{" "}
-              {(state.attempt == 0
-                ? state.index
-                : state.wrongAnswers!.indexOf(state.index)) + 1}{" "}
-              /{" "}
-              {state.attempt == 0
-                ? quiz.questions.length
-                : state.wrongAnswers!.length}
-            </>
-          ) : null
-        ) : (
+interface HeaderProps {
+  quiz: Quiz;
+  state: QuizState;
+  ended: boolean;
+}
+
+let Header = observer(({ quiz, state, ended }: HeaderProps) => (
+  <header>
+    <h3>Quiz</h3>
+    <div className="counter">
+      {state.started ? (
+        !ended ? (
           <>
-            {quiz.questions.length} question
-            {quiz.questions.length > 1 ? "s" : null}
+            Question{" "}
+            {(state.attempt == 0
+              ? state.index
+              : state.wrongAnswers!.indexOf(state.index)) + 1}{" "}
+            /{" "}
+            {state.attempt == 0
+              ? quiz.questions.length
+              : state.wrongAnswers!.length}
           </>
-        )}
-      </div>
-    </header>
-  )
-);
+        ) : null
+      ) : (
+        <>
+          {quiz.questions.length} question
+          {quiz.questions.length > 1 ? "s" : null}
+        </>
+      )}
+    </div>
+  </header>
+));
+
+interface AnswerReviewProps {
+  quiz: Quiz;
+  state: QuizState;
+  name: string;
+  nCorrect: number;
+  onRetry: () => void;
+  onGiveUp: () => void;
+}
 
 let AnswerReview = ({
   quiz,
@@ -191,20 +197,14 @@ let AnswerReview = ({
   nCorrect,
   onRetry,
   onGiveUp,
-}: {
-  quiz: Quiz;
-  state: QuizState;
-  name: string;
-  nCorrect: number;
-  onRetry: () => void;
-  onGiveUp: () => void;
-}) => {
+}: AnswerReviewProps) => {
   let confirm = !state.confirmedDone ? (
     <p style={{ marginBottom: "1em" }}>
       You can either <button onClick={onRetry}>retry the quiz</button> or{" "}
       <button onClick={onGiveUp}>see the correct answers</button>.
     </p>
   ) : null;
+  let questionTitles = generateQuestionTitles(quiz);
   return (
     <>
       <h3>Answer Review</h3>
@@ -222,6 +222,7 @@ let AnswerReview = ({
           <div className="answer-wrapper" key={i}>
             <AnswerView
               index={i + 1}
+              title={questionTitles[i]}
               quizName={name}
               question={question}
               userAnswer={answer}
@@ -236,15 +237,6 @@ let AnswerReview = ({
   );
 };
 
-export interface QuizViewProps {
-  name: string;
-  quiz: Quiz;
-  fullscreen?: boolean;
-  cacheAnswers?: boolean;
-  allowRetry?: boolean;
-  onFinish?: (answers: TaggedAnswer[]) => void;
-}
-
 export let useCaptureMdbookShortcuts = (capture: boolean) => {
   useLayoutEffect(() => {
     if (capture) {
@@ -291,6 +283,44 @@ export let useCaptureMdbookShortcuts = (capture: boolean) => {
   }, [capture]);
 };
 
+export interface QuizViewProps {
+  name: string;
+  quiz: Quiz;
+  fullscreen?: boolean;
+  cacheAnswers?: boolean;
+  allowRetry?: boolean;
+  onFinish?: (answers: TaggedAnswer[]) => void;
+}
+
+let aCode = "a".charCodeAt(0);
+export let generateQuestionTitles = (quiz: Quiz): string[] => {
+  let groups: Question[][] = [];
+  let group = undefined;
+  let part = undefined;
+  quiz.questions.forEach(q => {
+    if (q.multipart) {
+      if (q.multipart === part) {
+        group.push(q);
+      } else {
+        group = [q];
+        groups.push(group);
+      }
+      part = q.multipart;
+    } else {
+      group = [q];
+      groups.push(group);
+    }
+  });
+
+  return groups.flatMap((g, i) =>
+    g.map((q, j) => {
+      let title = (i + 1).toString();
+      if (q.multipart) title += String.fromCharCode(aCode + j);
+      return title;
+    })
+  );
+};
+
 export let QuizView: React.FC<QuizViewProps> = observer(
   ({ quiz, name, fullscreen, cacheAnswers, allowRetry, onFinish }) => {
     let [quizHash] = useState(() => hash.MD5(quiz));
@@ -377,7 +407,12 @@ export let QuizView: React.FC<QuizViewProps> = observer(
     });
 
     let nCorrect = state.answers.filter(a => a.correct).length;
-    state.confirmedDone; // HACK: need this component to observe confirmedDone on first render...
+
+    // HACK: need this component to observe confirmedDone
+    // on first render...
+    state.confirmedDone;
+
+    let questionTitles = generateQuestionTitles(quiz);
 
     let body = (
       <section>
@@ -401,7 +436,9 @@ export let QuizView: React.FC<QuizViewProps> = observer(
             <QuestionView
               key={state.index}
               quizName={name}
-              index={state.index + 1}
+              multipart={quiz.multipart}
+              index={state.index}
+              title={questionTitles[state.index]}
               attempt={state.attempt}
               question={quiz.questions[state.index]}
               questionState={questionStates[state.index]}
diff --git a/js/packages/quiz/src/questions/mod.tsx b/js/packages/quiz/src/questions/mod.tsx
index 914be30..364ff6b 100644
--- a/js/packages/quiz/src/questions/mod.tsx
+++ b/js/packages/quiz/src/questions/mod.tsx
@@ -3,7 +3,8 @@ import _ from "lodash";
 import React, { useId, useMemo, useRef, useState } from "react";
 import { RegisterOptions, useForm } from "react-hook-form";
 
-import { Question } from "../bindings/Question";
+import type { Question } from "../bindings/Question";
+import type { Quiz } from "../bindings/Quiz";
 import { MarkdownView } from "../components/markdown";
 import { MoreInfo } from "../components/more-info";
 import { useCaptureMdbookShortcuts } from "../lib";
@@ -106,14 +107,27 @@ This explanation helps us understand *why* a reader answers a particular way, so
 we can better improve the surrounding text.
 `.trim();
 
-export let QuestionView: React.FC<{
+interface QuestionViewProps {
   quizName: string;
+  multipart: Quiz["multipart"];
   question: Question;
   index: number;
+  title: string;
   attempt: number;
   questionState?: any;
   onSubmit: (answer: TaggedAnswer) => void;
-}> = ({ quizName, question, index, attempt, questionState, onSubmit }) => {
+}
+
+export let QuestionView: React.FC<QuestionViewProps> = ({
+  quizName,
+  multipart,
+  question,
+  index,
+  title,
+  attempt,
+  questionState,
+  onSubmit,
+}) => {
   let start = useMemo(now, [quizName, question, index]);
   let ref = useRef<HTMLFormElement>(null);
   let [showExplanation, setShowExplanation] = useState(false);
@@ -156,10 +170,24 @@ export let QuestionView: React.FC<{
 
   let explanationId = useId();
 
+  let titleNumber = title.substring(0, 1);
+  let promptContext = question.multipart ? (
+    <div className="multipart-context">
+      <p>
+        <strong>Question {titleNumber} has multiple parts.</strong> The box
+        below contains the shared context for each part.
+      </p>
+      <div className="multipart-context-content">
+        <MarkdownView markdown={multipart[question.multipart]} />
+      </div>
+    </div>
+  ) : null;
+
   return (
     <div className={classNames("question", questionClass)}>
       <div className="prompt">
-        <h4>Question {index}</h4>
+        <h4>Question {title}</h4>
+        {promptContext}
         <methods.PromptView prompt={question.prompt} />
         {window.telemetry ? (
           <BugReporter quizName={quizName} question={index} />
@@ -204,21 +232,32 @@ export let QuestionView: React.FC<{
   );
 };
 
-export let AnswerView: React.FC<{
+interface AnswerViewProps {
   quizName: string;
   question: Question;
   index: number;
+  title: string;
   userAnswer: Question["answer"];
   correct: boolean;
   showCorrect: boolean;
-}> = ({ quizName, question, index, userAnswer, correct, showCorrect }) => {
+}
+
+export let AnswerView: React.FC<AnswerViewProps> = ({
+  quizName,
+  question,
+  index,
+  title,
+  userAnswer,
+  correct,
+  showCorrect,
+}) => {
   let methods = getQuestionMethods(question.type);
   let questionClass = questionNameToCssClass(question.type);
 
   return (
     <div className={classNames("answer", questionClass)}>
       <div className="prompt">
-        <h4>Question {index}</h4>
+        <h4>Question {title}</h4>
         <methods.PromptView prompt={question.prompt} />
         {window.telemetry ? (
           <BugReporter quizName={quizName} question={index} />
diff --git a/js/packages/quiz/src/questions/multiple-choice.tsx b/js/packages/quiz/src/questions/multiple-choice.tsx
index f89692f..5bc6185 100644
--- a/js/packages/quiz/src/questions/multiple-choice.tsx
+++ b/js/packages/quiz/src/questions/multiple-choice.tsx
@@ -2,9 +2,9 @@ import classNames from "classnames";
 import _ from "lodash";
 import React, { useId } from "react";
 
-import { Markdown } from "../bindings/Markdown";
-import { MultipleChoiceAnswer } from "../bindings/MultipleChoiceAnswer";
-import { MultipleChoicePrompt } from "../bindings/MultipleChoicePrompt";
+import type { Markdown } from "../bindings/Markdown";
+import type { MultipleChoiceAnswer } from "../bindings/MultipleChoiceAnswer";
+import type { MultipleChoicePrompt } from "../bindings/MultipleChoicePrompt";
 import { MarkdownView } from "../components/markdown";
 import { QuestionMethods } from "./types";
 
diff --git a/js/packages/quiz/src/questions/short-answer.tsx b/js/packages/quiz/src/questions/short-answer.tsx
index 1b1f199..d652c34 100644
--- a/js/packages/quiz/src/questions/short-answer.tsx
+++ b/js/packages/quiz/src/questions/short-answer.tsx
@@ -1,7 +1,7 @@
 import React from "react";
 
-import { ShortAnswerAnswer } from "../bindings/ShortAnswerAnswer";
-import { ShortAnswerPrompt } from "../bindings/ShortAnswerPrompt";
+import type { ShortAnswerAnswer } from "../bindings/ShortAnswerAnswer";
+import type { ShortAnswerPrompt } from "../bindings/ShortAnswerPrompt";
 import { MarkdownView } from "../components/markdown";
 import { QuestionMethods } from "./types";
 
diff --git a/js/packages/quiz/src/questions/tracing.tsx b/js/packages/quiz/src/questions/tracing.tsx
index 2646c80..81dcb82 100644
--- a/js/packages/quiz/src/questions/tracing.tsx
+++ b/js/packages/quiz/src/questions/tracing.tsx
@@ -2,8 +2,8 @@ import classNames from "classnames";
 import _ from "lodash";
 import React, { useId, useState } from "react";
 
-import { TracingAnswer } from "../bindings/TracingAnswer";
-import { TracingPrompt } from "../bindings/TracingPrompt";
+import type { TracingAnswer } from "../bindings/TracingAnswer";
+import type { TracingPrompt } from "../bindings/TracingPrompt";
 // import { MoreInfo } from "../components/more-info";
 import { Snippet } from "../components/snippet";
 import { QuestionMethods } from "./types";
diff --git a/js/packages/quiz/tests/multiple-choice.test.tsx b/js/packages/quiz/tests/multiple-choice.test.tsx
index 7307411..d87c590 100644
--- a/js/packages/quiz/tests/multiple-choice.test.tsx
+++ b/js/packages/quiz/tests/multiple-choice.test.tsx
@@ -1,14 +1,14 @@
 import { render, screen, waitFor } from "@testing-library/react";
 import user from "@testing-library/user-event";
-import { MultipleChoice } from "@wcrichto/quiz-schema";
 import React from "react";
 import { beforeEach, describe, expect, it } from "vitest";
 
+import { MultipleChoice } from "../src/bindings/MultipleChoice";
 import { MultipleChoiceMethods, QuestionView } from "../src/lib";
 import { submitButton } from "./utils";
 
 describe("MultipleChoice", () => {
-  let question: MultipleChoice = {
+  let question: MultipleChoice & { type: "MultipleChoice" } = {
     type: "MultipleChoice",
     prompt: { prompt: "Hello world", distractors: ["B", "C"] },
     answer: { answer: "A" },
@@ -25,6 +25,8 @@ describe("MultipleChoice", () => {
       <QuestionView
         quizName={"Foobar"}
         question={question}
+        multipart={{}}
+        title={"1"}
         index={1}
         attempt={0}
         questionState={state}
@@ -55,7 +57,7 @@ describe("MultipleChoice", () => {
 });
 
 describe("MultipleChoice multi-answer", () => {
-  let question: MultipleChoice = {
+  let question: MultipleChoice & { type: "MultipleChoice" } = {
     type: "MultipleChoice",
     prompt: { prompt: "Hello world", distractors: ["C", "D"] },
     answer: { answer: ["A", "B"] },
@@ -72,7 +74,9 @@ describe("MultipleChoice multi-answer", () => {
       <QuestionView
         quizName={"Foobar"}
         question={question}
+        multipart={{}}
         index={1}
+        title="1"
         attempt={0}
         questionState={state}
         onSubmit={answer => {
diff --git a/js/packages/quiz/tests/question.test.tsx b/js/packages/quiz/tests/question.test.tsx
index af56de9..e264e36 100644
--- a/js/packages/quiz/tests/question.test.tsx
+++ b/js/packages/quiz/tests/question.test.tsx
@@ -1,14 +1,14 @@
 import { render, screen, waitFor } from "@testing-library/react";
 import user from "@testing-library/user-event";
-import { ShortAnswer } from "@wcrichto/quiz-schema";
 import React from "react";
 import { beforeEach, describe, expect, it } from "vitest";
 
+import { Question } from "../src/bindings/Question";
 import { QuestionView } from "../src/lib";
 import { submitButton } from "./utils";
 
 describe("Question prompt for explanation", () => {
-  let question: ShortAnswer = {
+  let question: Question = {
     type: "ShortAnswer",
     prompt: { prompt: "Hello world" },
     answer: { answer: "Yes" },
@@ -22,7 +22,9 @@ describe("Question prompt for explanation", () => {
       <QuestionView
         quizName={"Foobar"}
         question={question}
+        multipart={{}}
         index={1}
+        title="1"
         attempt={0}
         onSubmit={answer => {
           submitted = answer;
diff --git a/js/packages/quiz/tests/quiz.test.tsx b/js/packages/quiz/tests/quiz.test.tsx
index 7e99d1f..8517763 100644
--- a/js/packages/quiz/tests/quiz.test.tsx
+++ b/js/packages/quiz/tests/quiz.test.tsx
@@ -1,10 +1,11 @@
 import { render, screen, waitFor } from "@testing-library/react";
 import user from "@testing-library/user-event";
-import { Quiz } from "@wcrichto/quiz-schema";
 import React from "react";
 import { beforeEach, describe, expect, it } from "vitest";
 
-import { QuizView } from "../src/lib";
+import { Question } from "../src/bindings/Question";
+import { Quiz } from "../src/bindings/Quiz";
+import { QuizView, generateQuestionTitles } from "../src/lib";
 import { startButton, submitButton } from "./utils";
 
 let quiz: Quiz = {
@@ -116,3 +117,27 @@ describe("Quiz retry", () => {
     ).toThrow();
   });
 });
+
+describe("generateQuestionTitles", () => {
+  it("handles multi-part questions", () => {
+    let template: Question = {
+      type: "ShortAnswer",
+      prompt: { prompt: "" },
+      answer: { answer: "" },
+    };
+    let questions: Question[] = [
+      { ...template, multipart: "a" },
+      { ...template, multipart: "a" },
+      { ...template, multipart: "b" },
+      { ...template },
+      { ...template, multipart: "c" },
+    ];
+    expect(generateQuestionTitles({ questions })).toStrictEqual([
+      "1a",
+      "1b",
+      "2a",
+      "3",
+      "4a",
+    ]);
+  });
+});
diff --git a/js/packages/quiz/tests/short-answer.test.tsx b/js/packages/quiz/tests/short-answer.test.tsx
index b4e87a4..ed0ffe3 100644
--- a/js/packages/quiz/tests/short-answer.test.tsx
+++ b/js/packages/quiz/tests/short-answer.test.tsx
@@ -1,14 +1,14 @@
 import { render, screen, waitFor } from "@testing-library/react";
 import user from "@testing-library/user-event";
-import { ShortAnswer } from "@wcrichto/quiz-schema";
 import React from "react";
 import { beforeEach, describe, expect, it } from "vitest";
 
+import { ShortAnswer } from "../src/bindings/ShortAnswer";
 import { QuestionView } from "../src/lib";
 import { submitButton } from "./utils";
 
 describe("ShortAnswer", () => {
-  let question: ShortAnswer = {
+  let question: ShortAnswer & { type: "ShortAnswer" } = {
     type: "ShortAnswer",
     prompt: { prompt: "Hello world" },
     answer: { answer: "Yes", alternatives: ["Ok"] },
@@ -21,7 +21,9 @@ describe("ShortAnswer", () => {
       <QuestionView
         quizName={"Foobar"}
         question={question}
+        multipart={{}}
         index={1}
+        title="1"
         attempt={0}
         onSubmit={answer => {
           submitted = answer;
diff --git a/js/packages/quiz/tests/tracing.test.tsx b/js/packages/quiz/tests/tracing.test.tsx
index 3095b97..c4e681a 100644
--- a/js/packages/quiz/tests/tracing.test.tsx
+++ b/js/packages/quiz/tests/tracing.test.tsx
@@ -1,14 +1,14 @@
 import { render, screen, waitFor } from "@testing-library/react";
 import user from "@testing-library/user-event";
-import { Tracing } from "@wcrichto/quiz-schema";
 import React from "react";
 import { beforeEach, describe, expect, it } from "vitest";
 
+import { Tracing } from "../src/bindings/Tracing";
 import { QuestionView } from "../src/lib";
 import { submitButton } from "./utils";
 
 describe("Tracing", () => {
-  let question: Tracing = {
+  let question: Tracing & { type: "Tracing" } = {
     type: "Tracing",
     prompt: { program: "fn main(){}" },
     answer: { doesCompile: true, stdout: "Yes" },
@@ -21,7 +21,9 @@ describe("Tracing", () => {
       <QuestionView
         quizName={"Foobar"}
         question={question}
+        multipart={{}}
         index={1}
+        title="1"
         attempt={0}
         onSubmit={answer => {
           submitted = answer;
diff --git a/mdbook-quiz.schema.json b/mdbook-quiz.schema.json
new file mode 100644
index 0000000..5a0b096
--- /dev/null
+++ b/mdbook-quiz.schema.json
@@ -0,0 +1,470 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Quiz",
+  "description": "A quiz is the top-level data structure in mdbook-quiz. It represents a sequence of questions.",
+  "type": "object",
+  "required": [
+    "questions"
+  ],
+  "properties": {
+    "multipart": {
+      "description": "Context for multipart questions.\n\nMaps from a string key to a description of the question context.",
+      "type": [
+        "object",
+        "null"
+      ],
+      "additionalProperties": {
+        "$ref": "#/definitions/Markdown"
+      }
+    },
+    "questions": {
+      "description": "The questions of the quiz.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/Question"
+      }
+    }
+  },
+  "definitions": {
+    "Markdown": {
+      "description": "A [Markdown](https://commonmark.org/help/) string.",
+      "type": "string"
+    },
+    "MultipleChoiceAnswer": {
+      "description": "An answer for a [`MultipleChoice`] question.",
+      "type": "object",
+      "required": [
+        "answer"
+      ],
+      "properties": {
+        "answer": {
+          "description": "The text of the correct answer.",
+          "allOf": [
+            {
+              "$ref": "#/definitions/MultipleChoiceAnswerFormat"
+            }
+          ]
+        }
+      }
+    },
+    "MultipleChoiceAnswerFormat": {
+      "description": "The type of response for a [`MultipleChoice`] question.",
+      "anyOf": [
+        {
+          "description": "There is one correct answer.",
+          "allOf": [
+            {
+              "$ref": "#/definitions/Markdown"
+            }
+          ]
+        },
+        {
+          "description": "There are multiple correct answers, and the user must select each.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Markdown"
+          }
+        }
+      ]
+    },
+    "MultipleChoicePrompt": {
+      "description": "A prompt for a [`MultipleChoice`] question.",
+      "type": "object",
+      "required": [
+        "distractors",
+        "prompt"
+      ],
+      "properties": {
+        "answerIndex": {
+          "description": "If defined, don't randomize distractors and put answer at this index.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "distractors": {
+          "description": "An array of incorrect answers.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Markdown"
+          }
+        },
+        "prompt": {
+          "description": "The text of the prompt.",
+          "allOf": [
+            {
+              "$ref": "#/definitions/Markdown"
+            }
+          ]
+        },
+        "sortAnswers": {
+          "description": "If defined, don't randomize distractors and sort answers by content.",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        }
+      }
+    },
+    "Question": {
+      "description": "An individual question. One of several fixed types.",
+      "oneOf": [
+        {
+          "description": "A [`ShortAnswer`] question.",
+          "type": "object",
+          "allOf": [
+            {
+              "$ref": "#/definitions/QuestionFields_for_ShortAnswerPrompt_and_ShortAnswerAnswer"
+            }
+          ],
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "ShortAnswer"
+              ]
+            }
+          }
+        },
+        {
+          "description": "A [`Tracing`] question.",
+          "type": "object",
+          "allOf": [
+            {
+              "$ref": "#/definitions/QuestionFields_for_TracingPrompt_and_TracingAnswer"
+            }
+          ],
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "Tracing"
+              ]
+            }
+          }
+        },
+        {
+          "description": "A [`MultipleChoice`] question.",
+          "type": "object",
+          "allOf": [
+            {
+              "$ref": "#/definitions/QuestionFields_for_MultipleChoicePrompt_and_MultipleChoiceAnswer"
+            }
+          ],
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "type": "string",
+              "enum": [
+                "MultipleChoice"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    "QuestionFields_for_MultipleChoicePrompt_and_MultipleChoiceAnswer": {
+      "description": "Fields common to all question types.",
+      "type": "object",
+      "required": [
+        "answer",
+        "prompt"
+      ],
+      "properties": {
+        "answer": {
+          "description": "The contents of the answer. Depends on the question type.",
+          "allOf": [
+            {
+              "$ref": "#/definitions/MultipleChoiceAnswer"
+            }
+          ]
+        },
+        "context": {
+          "description": "Additional context that explains the correct answer.\n\nOnly shown after the user has answered correctly or given up.",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Markdown"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "id": {
+          "description": "A unique identifier for a given question.\n\nUsed primarily for telemetry, as a stable identifer for questions.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "multipart": {
+          "description": "If this key exists, then this question is part of a multipart group. The key must be contained in the [`Quiz::multipart`] map.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "prompt": {
+          "description": "The contents of the prompt. Depends on the question type.",
+          "allOf": [
+            {
+              "$ref": "#/definitions/MultipleChoicePrompt"
+            }
+          ]
+        },
+        "promptExplanation": {
+          "description": "If true, asks all users for a brief prose justification of their answer.\n\nUseful for getting a qualitative sense of why users respond a particular way.",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        }
+      }
+    },
+    "QuestionFields_for_ShortAnswerPrompt_and_ShortAnswerAnswer": {
+      "description": "Fields common to all question types.",
+      "type": "object",
+      "required": [
+        "answer",
+        "prompt"
+      ],
+      "properties": {
+        "answer": {
+          "description": "The contents of the answer. Depends on the question type.",
+          "allOf": [
+            {
+              "$ref": "#/definitions/ShortAnswerAnswer"
+            }
+          ]
+        },
+        "context": {
+          "description": "Additional context that explains the correct answer.\n\nOnly shown after the user has answered correctly or given up.",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Markdown"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "id": {
+          "description": "A unique identifier for a given question.\n\nUsed primarily for telemetry, as a stable identifer for questions.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "multipart": {
+          "description": "If this key exists, then this question is part of a multipart group. The key must be contained in the [`Quiz::multipart`] map.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "prompt": {
+          "description": "The contents of the prompt. Depends on the question type.",
+          "allOf": [
+            {
+              "$ref": "#/definitions/ShortAnswerPrompt"
+            }
+          ]
+        },
+        "promptExplanation": {
+          "description": "If true, asks all users for a brief prose justification of their answer.\n\nUseful for getting a qualitative sense of why users respond a particular way.",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        }
+      }
+    },
+    "QuestionFields_for_TracingPrompt_and_TracingAnswer": {
+      "description": "Fields common to all question types.",
+      "type": "object",
+      "required": [
+        "answer",
+        "prompt"
+      ],
+      "properties": {
+        "answer": {
+          "description": "The contents of the answer. Depends on the question type.",
+          "allOf": [
+            {
+              "$ref": "#/definitions/TracingAnswer"
+            }
+          ]
+        },
+        "context": {
+          "description": "Additional context that explains the correct answer.\n\nOnly shown after the user has answered correctly or given up.",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/Markdown"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "id": {
+          "description": "A unique identifier for a given question.\n\nUsed primarily for telemetry, as a stable identifer for questions.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "multipart": {
+          "description": "If this key exists, then this question is part of a multipart group. The key must be contained in the [`Quiz::multipart`] map.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "prompt": {
+          "description": "The contents of the prompt. Depends on the question type.",
+          "allOf": [
+            {
+              "$ref": "#/definitions/TracingPrompt"
+            }
+          ]
+        },
+        "promptExplanation": {
+          "description": "If true, asks all users for a brief prose justification of their answer.\n\nUseful for getting a qualitative sense of why users respond a particular way.",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        }
+      }
+    },
+    "ShortAnswerAnswer": {
+      "description": "An answer for a [`ShortAnswer`] question.",
+      "type": "object",
+      "required": [
+        "answer"
+      ],
+      "properties": {
+        "alternatives": {
+          "description": "Other acceptable strings answers.",
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "string"
+          }
+        },
+        "answer": {
+          "description": "The exact string that answers the question.",
+          "type": "string"
+        }
+      }
+    },
+    "ShortAnswerPrompt": {
+      "description": "A prompt for a [`ShortAnswer`] question.",
+      "type": "object",
+      "required": [
+        "prompt"
+      ],
+      "properties": {
+        "prompt": {
+          "description": "The text of the prompt.",
+          "allOf": [
+            {
+              "$ref": "#/definitions/Markdown"
+            }
+          ]
+        },
+        "response": {
+          "description": "Format of the response.",
+          "anyOf": [
+            {
+              "$ref": "#/definitions/ShortAnswerResponseFormat"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "ShortAnswerResponseFormat": {
+      "description": "The kind of response format (and subsequent input method) that accompanies a given short answer questions.",
+      "oneOf": [
+        {
+          "description": "A one-sentence response, given an `<input>`",
+          "type": "string",
+          "enum": [
+            "short"
+          ]
+        },
+        {
+          "description": "A long-form response, given a `<textarea>`",
+          "type": "string",
+          "enum": [
+            "long"
+          ]
+        },
+        {
+          "description": "A code response, given a code editor",
+          "type": "string",
+          "enum": [
+            "code"
+          ]
+        }
+      ]
+    },
+    "TracingAnswer": {
+      "description": "An answer for a [`Tracing`] question.",
+      "type": "object",
+      "required": [
+        "doesCompile"
+      ],
+      "properties": {
+        "doesCompile": {
+          "description": "True if the program should pass the compiler",
+          "type": "boolean"
+        },
+        "lineNumber": {
+          "description": "If doesCompile=false, then the line number of the code causing the error",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint",
+          "minimum": 0.0
+        },
+        "stdout": {
+          "description": "If doesCompile=true, then the contents of stdout after running the program",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      }
+    },
+    "TracingPrompt": {
+      "description": "A prompt for a [`Tracing`] question.",
+      "type": "object",
+      "required": [
+        "program"
+      ],
+      "properties": {
+        "program": {
+          "description": "The contents of the program to trace.",
+          "type": "string"
+        }
+      }
+    }
+  }
+}