Gatsby Book Launch

“The missing guide to the modern web” launches on Thursday, Sep 29th: Modular: The Web’s New Architecture

ContactSign Up for Free
Community Plugin
View plugin on GitHub


ci npm

This is a plugin for gatsby-transformer-remark, which is in turn a plugin for GatsbyJS. This plugin is a simple wrapper around the remark-gitlab, which replace links to GitLab files in Markdown files with the actual content of those files, wrapped in Markdown code blocks that can optionally be further processed by a syntax highlighter (e.g. gatsby-remark-prismjs).


# npm:
npm install gatsby-remark-gitlab
# or yarn:
yarn add gatsby-remark-gitlab


If you haven’t already installed gatsby-transformer-remark, you should install it. If you want to have syntax highlighting by PrismJS, install gatsby-remark-prismjs as well.

Then in your gatsby-config.js, add this plugin to the list of plugins for gatsby-transformer-remark, preferably as the first one but definitely before gatsby-remark-prismjs:

module.exports = {
  // other configs ...
  plugins: [
      resolve: `gatsby-transformer-remark`,
      options: {
        plugins: [
            resolve: 'gatsby-remark-gitlab',
            options: {
              repository: 'user/project',
              mentionStrong: true,
          // ... other plugins ...

For sample input and output, please refer to the usage section of remark-gitlab.


gatsby-remark-gitlab is released under the MIT License. See the bundled LICENSE file for details.

© 2022 Gatsby, Inc.