See what's launched

The next gen Gatsby is here Performance, developer velocity, and scaling to meet Enterprise needs - See what’s launched

Sign Up for Free
Community Plugin
View plugin on GitHub


Adds the target and rel attributes to external links in markdown.

This is a gatsby port of the remark-external-links remark plugin.


  1. Install plugin to your site:
yarn add gatsby-remark-external-links
  1. Add following to your gatsby-config.js:
    plugins: [      
        resolve: `gatsby-transformer-remark`,
        options: {
          plugins: [
            resolve: "gatsby-remark-external-links",
            options: {
              target: "_self",
              rel: "nofollow"
  1. Restart gastby.




Type: string Default: _blank

Specifies where to display the linked URL. The value should be on of : _self, _blank, _parent, _top

You can specify null to not add the target attribute to your links


Type: string Default: nofollow noopener noreferrer

Specifies the relationship of the target object to the link object. The value is a space-separated list of link types.

You can specify null to not add the rel attribute to your links

When using target, consider adding rel=“noopener noreferrer” to avoid exploitation of the window.opener API.



© 2022 Gatsby, Inc.