Skip to content

Repository files navigation

@quartz-community/crawl-links

Processes and resolves internal and external links, tracks outgoing links, and optionally adds external link icons.

Installation

npx quartz plugin add github:quartz-community/crawl-links

Usage

plugins:
  - source: github:quartz-community/crawl-links
    enabled: true
    options:
      markdownLinkResolution: shortest

For advanced use cases, you can override in TypeScript:

import * as ExternalPlugin from "./.quartz/plugins";

ExternalPlugin.CrawlLinks({
  markdownLinkResolution: "shortest",
});

Configuration

Option Type Default Description
markdownLinkResolution "absolute" | "relative" | "shortest" "absolute" How to resolve internal links.
prettyLinks boolean true Whether to use pretty links.
openLinksInNewTab boolean false Whether to open links in a new tab.
lazyLoad boolean false Whether to lazy load links.
externalLinkIcon boolean true Whether to add an external link icon.
disableBrokenWikilinks boolean false When true, internal links whose resolved slug is not in ctx.allSlugs gain a broken CSS class (alongside internal) for styling.

Documentation

See the Quartz documentation for more information.

License

MIT

About

Quartz's default crawl links plugin.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages