Intelligent Cross-References

Intelligent cross-references are a feature designed to be a link when they can be, and text directing people to a different target (guide) if not. Here's some examples for testing:

You can link by HTML filename: Lists and Code Blocks Demo

Or by MD filename: Lists and Code Blocks Demo

If the MD filename is ambiguous, you can specify the full path: Intelligent Cross-References

For an example of an inline cross reference, see GitHub Markdown Compatibility.

Also, demonstrating that context, spaces, and case mostly don't matter:

  • Includes
  • (Above this should be a cross-reference to the includes test.)


You can use anchors but the generated labels always use the page name: GitHub Markdown Compatibility

If you want to refer to a specific anchor, the workaround is to use an explicit label: Code Blocks

If the cross-reference appears in multiple targets, Dactyl chooses the first such target listed for the file. For example, if you want to refer to the Conditionals page using the conditionals target (when linking it from the filterexamples target), you have to change the order listed in the config file. Dactyl will always use the "everything" target since that's the first one listed:


If you want to specify a different target, you have to use conditional text in Jinja templating syntax instead of smart xrefs.