Lychee¶

If you want to automatically archive every external link referenced in your documents, you can use lychee together with the archive proxy.

Lychee respects standard proxy environment variables. Set your proxy as the HTTP(S) proxy:

export http_proxy="http://your-proxy:8080"
export https_proxy="http://your-proxy:8080"

All requests made by Lychee will now pass through the archive proxy, causing every visited URL to be archived automatically.

Lychee is quite aggressive by default. The following settings slow it down and make it behave more like a real browser, reducing load on the proxy and avoiding false negatives:

lychee --method get --max-concurrency 1 --timeout 20 --max-retries 5 --retry-wait-time 5 ./

Every link Lychee checks will be stored by the archive proxy.

After running the command, all links found in your Markdown files (or any scanned documents) will have been archived automatically, ensuring long-term preservation and offline access.