openedx / openedx/frontend-app-authoring
Decide & stage removal of waffle flag: `useReactMarkdownEditor`
@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:
- WYSIWYG (default) — form-based, point-and-click UI for building problems.
- Advanced — raw OLX (XML) editor.
- 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
- Gather feedback from the community on the feature as its enabled via migration
- 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.