Edit Any GitLab File and Open a Merge Request in Your Browser
You can now edit Markdown, MDX, and AsciiDoc files from public GitLab repositories directly in your browser. DraftView handles the fork, commit, and merge request generation for you. No local setup required.
Documentation lives in your Git repositories, but editing it in the browser should not require a local development environment. Today, we are bringing our in-browser editor to GitLab. You can now open any Markdown, MDX, or AsciiDoc file from a public GitLab repository, edit the prose or code, and submit a merge request from your own GitLab account.
This extension expands on our GitHub integration. Whether you use GitHub or GitLab, you can now fix typos, update guides, and write documentation from any device with a browser.
The pain of web-based doc edits
Editing documentation in Git repositories usually requires a compromise. You can clone the repository, run a local terminal, and maintain a local copy. Alternatively, you can use a web IDE, which often lacks rich live previews for complex document formats.
For a quick change (like fixing a typo or updating a command), setting up a local editor is too much work. If you are editing an AsciiDoc file, you also need to manage include:: directives that pull text from other files. Finding those files manually in a repository structure is time-consuming.
DraftView removes this friction. You paste the GitLab file URL, and the editor opens the document. You make your changes, and DraftView automatically generates the merge request.
How to edit a GitLab file in one click
To edit a file, copy its URL from GitLab. The editor accepts standard GitLab file URLs, including links from nested subgroups, different branches, and tags.
Prepend the DraftView edit URL to the GitLab link:
https://www.draftview.app/edit?url=https://gitlab.com/YOUR_GROUP/YOUR_PROJECT/-/blob/main/docs/index.md
You can also paste the URL directly into the DraftView Editor.
The file loads instantly. You do not need to sign in to read or edit. The application only requests authorization when you click the submit button.
Visual and source editing modes
DraftView provides two editing modes so that you can choose the right tool for the job:
- Visual mode: This mode works like a word processor. You edit the rendered version of your document. You see headings, lists, tables, and formatting exactly as they will look on the final page. This view is ideal for subject matter experts, product managers, and reviewers who do not want to interact with raw syntax.
- Source mode: This mode provides a code editor with syntax highlighting, line numbers, and find-and-replace controls. You can use this mode for structural changes, such as configuring tables or editing custom components.
You can switch between the two modes at any time without losing your changes.
If you edit an AsciiDoc file, DraftView resolves all include:: directives automatically. It fetches the referenced files from your GitLab repository and lists them in a sidebar. You can edit the main file and the includes in the same editing session.
Submit merge requests directly from your account
When you submit your changes, DraftView uses GitLab OAuth to complete the process.
If you do not have write access to the repository, DraftView forks the project to your GitLab namespace, commits your changes to a new branch, and opens a merge request to the upstream project. The commit and the merge request appear under your GitLab username. Maintainers can review and merge your changes using their standard GitLab workflow.
Sign in with GitLab
We added GitLab as a first-class authentication provider. If you do not have a GitHub account, you can sign in directly with GitLab or request a magic link for your email inbox.
Free for public repositories
The browser editor is free to use for public repositories. You can edit files and submit merge requests without signing up for a paid plan.
Edit your first GitLab doc in seconds.
Paste any file URL from a GitLab repository, edit the content, and submit a merge request from your own account. Free for public repositories.
Try the editorFree for public repositories. No credit card required.
Resources
- Edit This Page Guide: Learn how to add an "Edit this page" button to your documentation site.
- DraftView Editor: Paste a GitHub or GitLab URL to start editing immediately.
- A Free Online AsciiDoc Editor That Opens Your Includes Too: Read our guide to editing AsciiDoc documents.