Comprobación de Enlaces
VMark verifica que los destinos locales de enlaces e imágenes en tu markdown existan realmente en disco. Se ejecuta junto al motor de lint de markdown con Cmd-Shift-L o Herramientas → Comprobar Markdown.
Qué comprueba
Para cada enlace e imagen local en el documento:
[text](./other.md)— el archivo./other.mdse resuelve y existe— el archivo de imagen existe[text](./other.md#section)— el archivo existe (la comprobación del ancla la maneja la reglalinkFragments)
Cuando un destino falta, el texto del enlace se subraya con un trazo ondulado rojo y aparece una entrada en la insignia de lint y en la navegación con F2.
Qué omite
- Enlaces solo de fragmento (
#anchor) — los maneja la reglalinkFragments, que comprueba contra los encabezados del documento actual - URLs externas —
http://,https://,ftp://,mailto:,tel:,data:,file: - Documentos sin título — sin una ruta de archivo guardada, las URLs relativas no se pueden resolver contra ningún directorio
Cómo funciona la resolución
La Comprobación de Enlaces resuelve las rutas relativas al directorio del archivo de origen:
Enlace en /repo/docs/intro.md | Se resuelve a |
|---|---|
[a](./other.md) | /repo/docs/other.md |
[a](../shared.md) | /repo/shared.md |
[a](images/logo.png) | /repo/docs/images/logo.png |
[a](/docs/intro.md) | /repo/docs/docs/intro.md (interpretado como relativo dentro del directorio del archivo) |
Los fragmentos se eliminan antes de la búsqueda del archivo — [a](./other.md#section) solo comprueba ./other.md.
Rendimiento
- Asíncrono — se ejecuta en paralelo con las reglas síncronas; los resultados se fusionan cuando están listos
- Deduplicado — cada ruta única resuelta se comprueba una vez por ejecución, incluso si está enlazada varias veces
- Sin activación por pulsación de tecla —
fs.existsen cada pulsación saturaría el sistema; solo se ejecuta con el activador explícito de lint - Tolerancia a errores operativos — si
fs.existslanza una excepción (permiso denegado, problema de alcance de capacidad), el resultado eserror(omitido), nomissing. Mejor silencioso que erróneo.
Códigos de diagnóstico
| Código | Severidad | Activador |
|---|---|---|
| M001 | Error | Archivo de imagen no encontrado en la ruta local resuelta |
| M002 | Error | Archivo enlazado no encontrado en la ruta local resuelta |
Ver también
- Lint de Markdown — referencia completa de reglas
- Configuración → Markdown → Lint