Synchronized source and preview
A code editor and rendered Markdown preview appear side by side. Editing either surface updates the other for all collaborators, with cursors included.
Markdoc
Markdoc is a collaborative Markdown editor with live previews, comments, suggestions and version history. Open and publish files via GitHub; an account is required.
Collaborative Markdown editing
Markdoc is a collaborative Markdown editor for teams or individuals who need to write, review and maintain Markdown documents together. It combines a code-oriented source editor with a rendered preview, keeping both views synchronized as people edit.
The product supports live collaboration, anchored review threads, tracked suggestions and version history. Markdown files can be opened from GitHub gists or repositories, then published as commits to a chosen branch. The homepage describes offline editing with synchronization after reconnection.
Key features
Real-time collaboration
Presence indicators, live carets and selections support simultaneous editing, while conflict-free merging handles concurrent changes.
Contextual comments
Threads can be anchored to text and continue to follow the relevant words as the document changes. Participants can reply, resolve and reopen threads.
Tracked suggestions
Suggesting mode records proposed edits as tracked changes. Document owners can accept or reject suggestions individually or all at once.
Version history
Automatic snapshots, named versions, word-level diffs and one-click restore provide a record of document changes.
GitHub-native storage and publishing
Markdown files can be opened from GitHub gists or repositories, and publishing creates a commit on a selected branch.
Use cases
Writing Markdown documentation
Draft and refine README files, documentation pages or other Markdown files while viewing source syntax and the rendered result together.
Co-authoring documents
Work on the same document with collaborators who need to see presence, cursors and selections while changes are merged in real time.
Structured editorial review
Review proposed wording or structural changes without directly replacing the current text; owners can accept or reject tracked suggestions.
Contextual feedback
Discuss specific passages with threads that remain attached to the relevant words, even as the document evolves.
Maintaining document history
Recover or compare earlier states using snapshots, named versions, word-level diffs and one-click restore before publishing an update.
Pros and Cons
Pros
- Combines editable Markdown source and rendered preview in one synchronized workspace.
- Supports simultaneous editing with presence, live cursors and conflict-free merging.
- Provides review workflows through anchored comments and tracked suggestions.
- Maintains automatic and named versions with word-level diffs and restore.
- Publishes to GitHub gists or repositories through real commits on selected branches.
Cons
- The product is described as free while in preview, but the available source does not establish pricing after preview or any plan limits.
- The homepage confirms GitHub authentication and GitHub-based file workflows, but does not document broader account, browser or device requirements.
FAQ
What is Markdoc?
Markdoc is a shared Markdown editor with a code editor and rendered preview side by side. Changes made in either surface update for everyone in real time.
How do users sign in?
The source page says Markdoc works with GitHub authentication. It does not provide further setup or account requirements.
How does Markdoc work with GitHub?
Users can open a Markdown file from a GitHub gist or repository. Publishing creates a real commit on a branch the user chooses.
Can collaborators review and suggest changes?
Markdoc supports comments, replies, resolution and reopening, as well as suggesting mode where document owners can accept or reject tracked edits.
Does Markdoc work offline?
The homepage states that Markdoc works offline and catches up when the connection is restored. Other browser, device and platform limitations are not specified.
Quick Facts
- Category
- Productivity; Developer Tool
- Primary format
- Markdown
- Authentication
- GitHub account required
- Storage and publishing
- GitHub gists and repositories; commits to a selected branch
- Collaboration
- Real-time editing, comments and tracked suggestions
- Availability note
- Free while in preview
Markdoc Alternatives
Biji
Biji is a versatile platform designed to enhance productivity through innovative tools and features.
hob
hob is an independent workspace for coding agents, with local control over sessions, terminals, history, routing, and follow-up work.
Dcyde
Dcyde is a shared decision log for product teams to capture what was decided, why, and the source, with searchable records from Slack, Figma, or Dcyde.
runevr
runevr is a connected workspace for creative teams, bringing boards, media review, chat, recordings, drive, calls, and AI agents into one room-based environment.
Carbon Voice
Carbon Voice is an async voice messaging app for teams and individuals, with transcripts, AI catch-up, and cross-device access.
BotBoard
BotBoard is a task-management layer for AI agents to assign work, track progress, and review output via CLI, MCP, and HTTP.