Usage of (@) in spec markdown

Reading over the changelog from 0.23 to 0.24, I see that [link](@link) has been replaced by [link](@), which acts as a shorthand reference link. This isn’t mentioned anywhere in the spec, nor is it implemented in the commonmark.js dingus.

Have I missed where it was defined, or how it is to be used outside of spec.txt?

1 Like

It’s an ad hoc convention that is just used in the spec. The script tools/make_spec.lua handles it using a filter that walks the AST looking for links of this type.

2 Likes

Ah, perfect. Thank you for the explanation.