v6.8.0 Release: Smart Shortcodes and Link Validation

2026-07-02

SuCoS v6.8.0 introduces highly convenient Hugo-style shortcodes for internal link management alongside major improvements to link validation efficiency. This update makes it easier to reference your internal pages dynamically while ensuring local test environments don't trigger unnecessary external requests.

Hugo-Style Shortcodes

We've added native support for ref and relref shortcodes directly within your Markdown content. This allows you to resolve page permalinks dynamically without hardcoding URLs.

Check out our [About Page]({{< ref "path/to/page.md" >} }) for absolute links, 
or link relatively using [this section]({{< relref "path/to/page.md#anchor" >} }).

By default, the shortcodes automatically resolve using the calling page's language and output format context. However, you can explicitly override these when needed by appending lang="..." or outputFormat="..." parameters. It also fully supports #anchor fragment resolution out of the box.

The validate-links engine received a robust intelligence upgrade focused on local testing workflow and edge-case handling:

  • Local BaseUrl Mapping: Absolute links containing your production domain (e.g., hardcoded production URLs) are now smart-resolved against your local site pages during testing instead of initiating actual external HTTP requests. If you prefer the legacy behavior, you can append the -b or --strict-baseurl flags to enforce exact domain-matching.
  • Hash-Routed URL Fix: Fixed a routing bug where root-path external URLs using hashes (such as Matrix links like [https://matrix.to/#/!room:matrix.org](https://matrix.to/#/!room:matrix.org)) were mistakenly flagged as internal page hits. This previously triggered frustrating, false-positive fragmentNotFound errors on the home page.

Download It Now

View Changelog