From b38c35a36d6d88b3b73bee3e655c0847e35e3ed5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Lorber?= <slorber@users.noreply.github.com>
Date: Fri, 23 Jul 2021 12:24:03 +0200
Subject: [PATCH] docs: mention Link can be used for external links (#5212)

---
 website/docs/docusaurus-core.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/website/docs/docusaurus-core.md b/website/docs/docusaurus-core.md
index 6d4ca9bb10..ea580e0092 100644
--- a/website/docs/docusaurus-core.md
+++ b/website/docs/docusaurus-core.md
@@ -60,6 +60,8 @@ This component enables linking to internal pages as well as a powerful performan
 
 The component is a wrapper around react-router’s `<Link>` component that adds useful enhancements specific to Docusaurus. All props are passed through to react-router’s `<Link>` component.
 
+External links also work, and automatically have these props: `target="_blank" rel="noopener noreferrer"`.
+
 ```jsx {2,7}
 import React from 'react';
 import Link from '@docusaurus/Link';
@@ -70,8 +72,7 @@ const Page = () => (
       Check out my <Link to="/blog">blog</Link>!
     </p>
     <p>
-      {/* Note that external links still use `a` tags, but automatically opens in new tab. */}
-      Follow me on <a href="https://twitter.com/docusaurus">Twitter</a>!
+      Follow me on <Link to="https://twitter.com/docusaurus">Twitter</Link>!
     </p>
   </div>
 );