# no-html-links

Ensure that the Docusaurus [`<Link>`](/guides/docusaurus-core#link) component is used instead of `<a>` tags.

The `<Link>` component has prefetching and preloading built-in. It also does build-time broken link detection, and helps Docusaurus understand your site's structure better.

## Rule Details

Examples of **incorrect** code for this rule:

```html
<a href="/page">go to page!</a>

<a href="https://x.com/docusaurus" target="_blank">X</a>
```

Examples of **correct** code for this rule:

```js
import Link from '@docusaurus/Link'

<Link to="/page">go to page!</Link>

<Link to="https://x.com/docusaurus">X</Link>
```

## Rule Configuration

Accepted fields:

```mdx-code-block
<APITable>
```

| Option                | Type      | Default | Description                                                                         |
| --------------------- | --------- | ------- | ----------------------------------------------------------------------------------- |
| `ignoreFullyResolved` | `boolean` | `false` | Set to true will not report any `<a>` tags with absolute URLs including a protocol. |

```mdx-code-block
</APITable>
```

## Related pages

- [no-untranslated-text](./api-misc-eslint-plugin-no-untranslated-text.md)
- [prefer-docusaurus-heading](./api-misc-eslint-plugin-prefer-docusaurus-heading.md)
- [string-literal-i18n-messages](./api-misc-eslint-plugin-string-literal-i18n-messages.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.