Skip to main content

The new lesson experience

A flowing, document-style way to build lessons. Type content, drop questions inline, and pull in media without leaving the page.

Written by Kat Morgan

The new lesson experience is the document-style way to build lessons on Mindjoy. You write content the way you'd write a doc, then drop questions, media and interactive activities in wherever they belong. No more clicking "Add block" between every paragraph.

It sits alongside the legacy lesson experience, which is still available for the lessons you've already built. New lessons default to the new experience.

Creating a lesson in the new experience

When you start a new lesson from a pathway or from your Lessons library, you'll see a format picker. Pick New editor (it's marked Early Access) and give your lesson a name.

The Create a lesson format picker with New editor (Early Access) and Legacy editor options

The editor opens on Page 1. Start typing.

An empty new-experience canvas with the Pages sidebar on the left

Writing content

The page works like any rich text doc you've used before:

  • Headings with #, ##, ###, #### followed by a space

  • Bullet lists with - then space

  • Numbered lists with 1. then space

  • Code blocks with three backticks

  • Inline math with $ your expression $

  • Bold, italic, underline, strikethrough, links and inline code from the floating toolbar that appears when you select text

Cmd + B, Cmd + I and Cmd + K (for links) work the way you'd expect.

A page-based lesson with a heading, paragraph and bullet list rendered inline

Inserting questions, media and activities

Two ways to add anything that isn't text:

  1. Type / anywhere on a new line. A menu pops up with every block type. Keep typing to filter (e.g. /match to find the Match question).

  2. Click the + in the left margin next to a block. Same options, just clickable.

The slash menu open in a lesson, showing AI, Question blocks (Multiple Choice, Long Answer, Select All Correct, Match, True or False, Resequence) and Basic blocks

You can insert:

  • Multiple Choice, Select All Correct, True / False, Match, Resequence, Free Response, Long Answer and Reflection questions

  • Images, YouTube videos and tables

  • Callouts (Note, Tip, Warning, Example, Key term)

  • Headings, dividers and code blocks

  • A page break to start a new page

Pages

Lessons are split into pages. Students see one page at a time and move through them in order. The page list lives in the left sidebar. Click + at the bottom of the sidebar to add a new page, drag pages to reorder them, and double-click a title to rename.

The Pages sidebar on the left of a lesson

If a page gets long, an outline appears in the right margin showing every heading. Click any heading to jump straight to it.

Adding a tutor

Open the lesson settings menu (the ... at the top right) and pick a tutor from the Tutor dropdown. Students can chat to the tutor in a panel beside the lesson while they work through it. If you'd rather not have one, leave it as "No tutor".

The lesson-level more menu open, showing Preview, Share, Assign, Duplicate, Convert to V1, Tutor selector with No tutor, Feedback type options and Delete

Preview, publish, assign

The three things you'll do at the top right:

Top bar of a lesson with Preview, Publish, and the more-options menu

  • Preview opens a private copy of your lesson exactly as students will see it. Edits in Preview don't change what's published.

  • Publish saves a snapshot. Students always see the snapshot that was published when they were assigned, so you can keep editing without disturbing anyone mid-lesson.

  • Assign (inside the more menu) sends the lesson to a classroom, with optional open and due dates.

For more on those, see "Publishing and versioning a lesson" and "Assignment timing and due dates for lessons".

Want the legacy experience for this one?

You can. The lesson settings menu has a Convert to V1 option that creates a legacy version of your lesson alongside the new-experience original. The new-experience version stays untouched, so you can compare or back out if you change your mind.

Walkthrough: "Switching a lesson back to the legacy experience".

Did this answer your question?