Is there a list of characters that must be escaped in markup mode (inside `[ ]` blocks) documented?

Questions
1

Hi,

Is the list of characters (e.g. *) that must be escaped to be treated literally in markup mode (i.e. inside [ ] blocks), documented anywhere?

Thanks in advance.

2

yes, the syntax available in markup blocks is listed here:

1 Like
3

So are these the chars that need to be escaped:

  • *
  • _
  • `
  • <
  • @
  • =
  • -
  • +
  • /
  • $
  • \
  • '
  • "
  • ~
  • -
  • #

Or do these need to be escaped too:

  • >
  • (
  • )
4

You need to escape characters that would form a specific syntactic construct. >, ( and ) don’t start such a construct, so no escape is necessary (but allowed). < a > is also not a specific construct, due to the spaces, but you’d need to write \<a> if you don’t want the spaces. At this specificity, the thing to do is imo to just try it out, which is what I did just now. The list of characters that could potentially need escaping is the one you gave, based on the syntax page I linked.

1 Like