feat(build): allow ignoring only localhost dead links (#1821)

docs/config/app-configs.md

@@ -86,10 +86,10 @@ type HeadConfig =
 
 ## ignoreDeadLinks
 
-- Type: `boolean`
+- Type: `boolean | 'localhostLinks'`
 - Default: `false`
 
-When set to `true`, VitePress will not fail builds due to dead links.
+When set to `true`, VitePress will not fail builds due to dead links. When set to `localhostLinks`, the build will fail on dead links, but won't check `localhost` links.
 
 ```ts
 export default {

src/node/config.ts

@@ -73,7 +73,7 @@ export interface UserConfig<ThemeConfig = any>
    *
    * @default false
    */
-  ignoreDeadLinks?: boolean
+  ignoreDeadLinks?: boolean | 'localhostLinks'
 
   /**
    * @experimental

src/node/markdownToVue.ts

@@ -115,7 +115,10 @@ export async function createMarkdownToVueRenderFn(
       for (let url of links) {
         if (/\.(?!html|md)\w+($|\?)/i.test(url)) continue
 
-        if (url.replace(EXTERNAL_URL_RE, '').startsWith('//localhost:')) {
+        if (
+          siteConfig?.ignoreDeadLinks !== 'localhostLinks' &&
+          url.replace(EXTERNAL_URL_RE, '').startsWith('//localhost:')
+        ) {
           recordDeadLink(url)
           continue
         }