Connect OneDrive.
Experimental · every planFiles.ReadWrite permission, so MDflow sees your whole OneDrive — every folder and file, listed from the root, with nothing to pick. It works with personal Microsoft accounts, and work or school accounts where your organization allows it. Read How it works below before you rely on it.Edit the markdown that lives in your OneDrive — notes, docs, anything in a .md file — directly from the MDflow editor. Browse your OneDrive in the sidebar, open a file, and save your changes straight back to OneDrive. No download, no re-upload, no copy-and-paste.
Once a workspace is connected you can:
- ›Browse your whole OneDrive from its root, folders loading as you expand them, and open the markdown files in the MDflow editor.
- ›Edit with live preview, then save back to OneDrive — the file in your OneDrive is updated in place.
- ›Create markdown files and folders, and rename or delete items of any type; deletes go to your OneDrive recycle bin, never a permanent delete.
- ›Open every other file in OneDrive in a new tab — Word, Excel, and PowerPoint files in Word, Excel, and PowerPoint Online, and PDFs, images, and video in OneDrive's own viewers.
- ›Search your OneDrive, and import any markdown file into a workspace folder as an ordinary MDflow document.
OneDrive integration is free on every plan — no Pro required. Files are read and written live through Microsoft Graph and are not copied into MDflow unless you import one, so OneDrive stays the source of truth.
Why edit OneDrive markdown in MDflow?
- ›A real editor for your OneDrive notes. MDflow gives the
.mdfiles in your OneDrive the Monaco editor with syntax highlighting, live preview, and Edit / Split / Preview views, with the preview following the editor as you scroll. - ›OneDrive stays the source of truth. Nothing is mirrored behind your back. Every save writes back to the same file in OneDrive, so your documents live where they always have — and a file only becomes an MDflow document if you import it yourself.
- ›Your whole OneDrive, nothing to pick. Every folder and file you already have is in the panel from the start. The trade-off is honest: MDflow's permission covers your whole OneDrive, not just the files you open.
- ›Conflict-safe by design. If the file changed on OneDrive since you opened it, MDflow warns you and never overwrites silently.
- ›Free on every plan. Like the GitHub and Google Drive integrations, editing OneDrive markdown needs no Pro subscription.
Before you start
| Field | What to enter |
|---|---|
| An MDflow account | Any plan — the OneDrive integration is not Pro-gated. Sign in or sign up. |
| A Microsoft account | The Microsoft account whose OneDrive holds the markdown files you want to edit. Works with personal Microsoft accounts, and work or school accounts where your organization allows it. MDflow lists your own OneDrive only — SharePoint libraries and files shared with you are not shown. |
| A workspace | You connect OneDrive per workspace, so open the workspace you want your OneDrive files to appear in first. |
Connect your account
Connecting is a one-time, browser-based sign-in — there is no token to create or paste.
Open OneDrive in the source rail
In the sidebar, click the OneDrive icon in the source rail — the strip of icons down the left of the sidebar, where OneDrive sits right after Google Drive. The OneDrive panel opens with a Connect OneDrive button.
Connect OneDrive to browse all of your OneDrive files from this workspace. Markdown files open in the MDflow editor and save back to OneDrive; every other file opens in OneDrive in a new tab.
Experimental feature
Authorize MDflow on Microsoft
MDflow sends you to Microsoft. Choose the account whose OneDrive you want — Microsoft always asks, so you can pick a different account from the one you are signed in with — then accept. Microsoft's consent screen lists access to your files, keeping that access, and reading your basic profile; MDflow needs all three. If your organization requires an IT admin to approve apps, Microsoft stops here and MDflow tells you so — see Troubleshooting below.
Browse your OneDrive
Back in your workspace, the panel lists your OneDrive from its root — there is no picker and nothing to add. The header shows the connected account, and its menu holds New document, New folder, Open OneDrive, and Disconnect. Below it, a Search OneDrive box searches your files by name and content.
Files.ReadWrite permission, plus offline_access to stay connected and User.Read to show which account is connected. Unlike Google Drive's per-file access, it covers your whole OneDrive: MDflow can read and write any file in it, and does so only when you browse, search, open, save, create, rename, or delete. The access and refresh tokens are encrypted at rest on MDflow's server and never sent to your browser — there is no picker and no browser token at all. Disconnecting deletes the stored tokens; see Disconnect below for how to revoke Microsoft's permission fully.Open, edit, and save
Open a file
Expand folders in the OneDrive panel — every file type is listed, each with its own icon. Click a markdown file (.md or .markdown, up to 500 KB) to open it in the editor with the usual Edit, Split, and Preview views. Any other file opens in OneDrive in a new tab: a Word document, Excel workbook, or PowerPoint deck opens in Word, Excel, or PowerPoint Online, and a PDF, an image, or a video opens in OneDrive's own viewer.
Edit with live preview
Edit the file just like any MDflow document. The header shows the file's OneDrive name with a OneDrive link that opens the file in OneDrive, and the same Monaco editor and preview you use everywhere else apply here.
Save back to OneDrive
Pressing Save (or ⌘S / Ctrl+S) writes the change straight back to the same file in OneDrive. There is no separate export step — the OneDrive file is updated in place.
Reload from OneDrive to load the latest version, then reapply your edit. Renaming the file in the meantime is not a conflict. Your work is only ever replaced on your explicit choice.Create, rename, and delete files
- ›New document — create a markdown file at the root of your OneDrive from the panel's header menu, or inside any folder from that folder's menu; MDflow creates it in OneDrive and opens it for editing. A name that already exists in the folder is refused, never overwritten.
- ›New folder — create a folder at the root from the header menu, or inside any folder from its menu.
- ›Rename — rename a file or folder in place; the change is applied to the item in OneDrive.
- ›Delete — deleting moves the item to your OneDrive recycle bin after a confirmation. Nothing is ever permanently deleted, so you can restore it from OneDrive.
A folder's menu also has Open in OneDrive, and a markdown file's menu has Import. Everything happens on the real item in OneDrive, so your changes show up in OneDrive's own version history exactly as if you had made them there.
How it works, and what to expect
- ›A live proxy by default. MDflow reads and writes your files through Microsoft Graph on demand. A OneDrive file enters your MDflow workspace only when you choose
Importon it — a snapshot filed in the workspace folder you pick, which then lives its own life as an ordinary MDflow document while OneDrive keeps the original. - ›Your own OneDrive, from the root. The panel lists your OneDrive like a file tree, loading each folder when you expand it. SharePoint sites and libraries, Shared with me, and items other people shared into your OneDrive are not listed.
- ›Markdown is edited, everything else is opened. Only
.md/.markdownfiles up to 500 KB are edited in MDflow. Office documents, PDFs, images, video, OneNote notebooks, and every other file type open in OneDrive in a new tab instead. - ›OneDrive features come from OneDrive. Because OneDrive files are not MDflow documents, MDflow's workspace search, version history, sharing, and comments do not apply to them — their history is OneDrive's own.
Disconnect
In the OneDrive panel, open the header menu and choose Disconnect. MDflow deletes the stored tokens for that workspace; nothing in OneDrive is deleted. Microsoft keeps the permission you granted until you remove it. To fully revoke MDflow's access, use account.live.com/consent/Manage for a personal Microsoft account, or myapps.microsoft.com for a work or school account.
Troubleshooting
| Symptom | Cause & fix |
|---|---|
| “Your organization's IT admin must approve MDflow before you can connect this account” | Your work or school account belongs to an organization whose Microsoft policy lets only an IT admin approve apps that access files, so Microsoft stopped the connection. Ask your IT admin to approve MDflow in Microsoft Entra, then connect again — or connect a personal Microsoft account instead. |
| Microsoft's consent screen says “unverified” | Expected for now: MDflow has not completed Microsoft's publisher verification, so Microsoft labels the app unverified. The permissions listed are all MDflow asks for. Some organizations only let employees approve verified apps — that is one reason you may see the IT-admin message above. |
OneDrive session expired | Microsoft access tokens expire about hourly. MDflow refreshes them automatically; if it can't — for example after you revoked MDflow's permission — click Reconnect OneDrive in the panel. |
| “Couldn't connect OneDrive” | The sign-in was cancelled on Microsoft's screen, or the connection did not complete. Click Connect OneDrive in the panel to try again. |
| A file opens in OneDrive, not the editor | Only markdown files (.md, .markdown) up to 500 KB open in the MDflow editor. Every other file type opens in OneDrive in a new tab. |
| A shared file or SharePoint library is missing | Expected: MDflow lists your own OneDrive only. SharePoint sites and libraries, Shared with me, and items others shared into your OneDrive are not shown. |