chore: add match documentation

[gjuchault]

Hi,

match usage is not described anywhere else but in the code. It could be nice to give the function signature as long as an example (most common case would be "how to surround with <strong/> tag")