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.)
Anchors
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.