openedx / openedx/frontend-app-authoring

Decide & stage removal of waffle flag: `useReactMarkdownEditor`

Open
#3,114 3 comments 0 reactions 1 assignee View on GitHub

@farhan is already working on this.

Since Jun 25, 2026.

Dominant language
TypeScript
Stars
17
Forks
218
Avg merge
9d 20h
Merged PRs (30d)
20

Description

  • Flag name: useReactMarkdownEditor
  • Flag details: Gates the "Switch to Markdown Editor" option for CAPA problems in the authoring MFE.
  • Current status: "Enabled by default" via a migration in openedx/openedx-platform#36872 (merged June 9, 2025). The migration runs on both new and existing instances and will not overwrite an existing "No" waffle flag — org/course-level overrides still take precedence. Operators who wish to disable it can opt out toggling flag to No.
  • Removal date: None set yet — a removal decision is pending community feedback.

Short Feature Description

Problem Block can be created/edited in 3 editors:

  1. WYSIWYG (default) — form-based, point-and-click UI for building problems.
  2. Advanced — raw OLX (XML) editor.
  3. Markdown — text-based editor using a custom edX syntax (gated by this waffle flag).

Feature Behavior & Known Limitations

Editor Naming Limitation: The "Markdown" editor does not support real Markdown syntax — it uses a custom edX text format with no syntax in common with standard Markdown (e.g. no **bold**, _italic_, or [links]). A rename/redesign is under active discussion. See openedx/frontend-app-authoring#2444 for details.

Copying following 2 important feature behaviours from PR

Problems created using the form-based or advanced editors in the Authoring MFE do not support Markdown, as there is currently no OLX-to-Markdown converter available. As a result, the Switch to Markdown Editor button will not be shown for these problems. Work on this converter can begin after the Teak release. (Source: openedx/frontend-app-authoring#1805)

For Teak, as per the discussion here, once a user switches to the Markdown editor, they cannot revert to the form-based or advanced editors unless the waffle flag is turned off for that course.

Note: My testing contradicts second point, see testing notes in the comment below

What to do in this ticket

  1. Gather feedback from the community on the feature as its enabled via migration
  2. As a follow-up step, decide either to remove the waffle flag — once we confirm it will remain an out-of-the-box feature.

References

  • Original feature PR: openedx/frontend-app-authoring#1805
  • Flag PR: openedx/openedx-platform#36512
  • Enable-by-default PR (closed without merging): openedx/openedx-platform#36602
  • Enable-by-default PR (merged): openedx/openedx-platform#36872
  • Teak backport: openedx/edx-platform#36876
  • Related open product discussion: openedx/frontend-app-authoring#2444

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.