Skip to main content


Intercepts local links from markdown and other non-react pages and does a client-side pushState to avoid the browser having to refresh the page.

For instance, in a markdown file with relative links (transformed to a tags by gatsby-transformer-remark), this plugin replaces the default link behaviour with that of gatsby-link’s navigate, preserving the SPA-like page change without reload.

Check out the Using Remark example to see this plugin in action.


npm install --save gatsby-plugin-catch-links

How to use

// In your gatsby-config.js
plugins: [`gatsby-plugin-catch-links`]

Was this helpful? edit this page on GitHub