OneDrive Markdown editing just got a serious upgrade. Microsoft has confirmed that OneDrive and SharePoint will support native viewing and editing of Markdown (.md) files directly in the browser, with a side-by-side editor and live preview. No downloads, no third-party tools, no workarounds. Just open the file and start reading or editing.
If you have ever stored a README or documentation file in SharePoint only to find yourself downloading it just to read it properly, this update is for you.
What Is Markdown, and Why Does It Matter in Microsoft 365?
Markdown is a lightweight text format used widely in software development, documentation, and increasingly in AI-generated content. Files use the .md extension and contain plain text with simple formatting syntax like # headings, **bold**, and - lists.
Until now, opening a .md file in OneDrive or SharePoint gave you a plain text experience at best. That made Markdown a second-class citizen in a platform built around rich document experiences. With more organizations using Copilot to generate documentation, meeting summaries, and structured outputs, .md files are appearing in SharePoint libraries more often than ever. OneDrive Markdown editing addresses that gap directly.
How OneDrive Markdown Editing Works in the Browser
The OneDrive Markdown editing experience is split into two panels. On the left, you see the raw Markdown source. On the right, you see the rendered output updating in real time. This side-by-side approach means you can write and immediately see how the content will look, without switching views or saving first.
Microsoft has built the preview using Fluent 2 typography, which means rich formatting is rendered properly: tables display as actual tables, images appear inline, code blocks are styled, and links are clickable.
There is also a built-in formatting toolbar. This is important for users who are not developers. Instead of remembering that ## creates a heading or **text** makes bold, they can use the toolbar to apply formatting visually, the same way they would in Word or Outlook.
The Side-by-Side OneDrive Markdown Editing Experience
The split-screen design makes OneDrive Markdown editing accessible to a much broader audience. Technical users get the raw editor they are used to. Non-technical users get the toolbar and can work with Markdown without knowing the syntax.
This is not just a preview feature. You can create, edit, and organize .md files alongside all other Microsoft 365 file types in the same library. No separate workspace, no special handling. OneDrive Markdown editing sits right where the rest of your files already live.
Rollout Timeline
According to Microsoft, this should be rolling out around April to May 2026.
| Phase | Region | Start | Expected Complete |
|---|---|---|---|
| General Availability | Worldwide | Mid-April 2026 | Late May 2026 |
No preview phase was announced. This goes straight to general availability, which means it could appear in your tenant at any point from mid-April onwards.
How to Open and Edit a Markdown File in OneDrive
Using OneDrive Markdown editing is straightforward once it has rolled out to your tenant:
- Open OneDrive or a SharePoint document library in your browser.
- Locate any .md file in your library.
- Click the file to open it. The side-by-side editor loads automatically.
- Use the left panel for raw Markdown input.
- Watch the right panel update with the rendered output in real time.
- Use the formatting toolbar for quick formatting without memorizing syntax.
- Save as you normally would. The file stays in place, accessible to everyone with the right permissions.
No new settings to configure. No admin toggles to flip. The feature is enabled by default.
Admin Tips for OneDrive Markdown Editing
Even though OneDrive Markdown editing requires no admin action, there are a few things worth thinking about before it rolls out in your tenant.
First, existing access controls apply. If a user does not have edit permissions on a file, they will only see the rendered preview and will not be able to make changes. OneDrive Markdown editing respects all existing SharePoint and OneDrive permissions, so no new governance overhead is introduced.
Second, this is a good moment to review whether your team stores documentation in SharePoint already. If you have been putting off moving README files or project docs into SharePoint because the viewing experience was poor, that reason is now gone.
Third, update your helpdesk documentation. Users who have previously downloaded .md files to read them may not know this new experience exists. A short note in your internal newsletter or intranet can save a lot of support questions. Microsoft has also indicated they will update documentation before the rollout completes, so keep an eye on the official support pages.
For more on SharePoint file management and best practices, see Best Practices for Sharing in SharePoint: Avoiding Common Pitfalls.
License Requirements
No additional license is required for OneDrive Markdown editing. The feature is available to all users who have access to OneDrive or SharePoint as part of their Microsoft 365 subscription. There are no specific licensing tiers or add-ons needed. The feature is enabled by default and applies to all users who can access .md files stored in OneDrive and SharePoint.
Why This Connects to Copilot
Microsoft 365 Copilot generates .md files regularly. Meeting summaries, action item lists, and structured outputs from Copilot are often delivered in Markdown format. Until now, those files landed in SharePoint but could not be read cleanly without downloading them first.
OneDrive Markdown editing closes that loop. Copilot generates the file, it lands in SharePoint, and the user can open, read, and edit it right there in the browser. No friction, no extra tools. This makes OneDrive Markdown editing especially relevant for organizations that are actively rolling out or scaling Copilot usage.
For a broader look at how SharePoint is evolving its content experience with AI, see From Reading to Listening: AI Audio Summaries Land in SharePoint and Viva.
Learn more about which file types are supported in OneDrive and SharePoint on the Microsoft Support page for file type previews. You can also explore how to use the Markdown web part in SharePoint for embedding Markdown content directly in SharePoint pages.
The Paul-Take on OneDrive Markdown Editing
This is one of those updates that looks small on paper but has real-world impact for the teams actually using SharePoint to store documentation.
OneDrive Markdown editing removes a daily friction point that nobody talks about in strategy meetings but everyone experiences on the ground. Developers who push README files to SharePoint. Project managers who get Copilot-generated summaries in .md format. IT teams trying to maintain documentation without switching to a third-party wiki tool.
The feature is well designed too. The side-by-side editor is a sensible UX choice. The real-time preview removes the guesswork that makes Markdown intimidating for non-technical users. And the formatting toolbar is a smart addition that widens the audience from ‘developers’ to ‘anyone who can use Word.’
The timing is right as well. With Copilot pushing Markdown into mainstream Microsoft 365 workflows, this was a gap Microsoft needed to close. They have. OneDrive Markdown editing is not flashy, but it is exactly the kind of quality-of-life improvement that makes Microsoft 365 a better place to actually work.