this document
https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md

given that the new BIDS website also makes use of mkdocs macro and also now comprises the documentation for BIDS extension development, it may make sense to have this document there