After setting up initial run using the ~[]() pattern I noticed a couple issues:
- Tilde didn’t feel natural or that it communicated as effectively as initially thought.
- Because of the way strikethrough additions are often implemented, it could end up being struck through when using a parser that doesn’t recognize the pattern.
Decided to try a different pattern: [.]()
When asking a non-developer which read more like “prepare for abbreviation” they chose the latter. Oddly enough because of file extensions and the pattern there. The added benefit here is that when the pattern is not recognized by the parser, the document appears to be readable. However, in some cases, the abbreviation is turned into a link.
See GitHub rendering of the README.md file here: https://github.com/8fold/commonmark-abbreviations