Links

I had to nod. I was not unaware of the weakness of that link in my chain of speculations. Still, there were so many unknowns... I could offer alternatives, such as Random then did, but guesses prove nothing.

Roger Zelazny, The Chronicles of Amber - Sign of the Unicorn (1975)

Since markup languages are mostly used to write hyperlinked documents, links play a big part in the syntax. Mau's implementation uses a syntax shared by all macros in the language (see the chapter about macros)

The source code can be found
at [link](https://github.com/Project-Mau/mau).

The values between round brackets are arguments, as link is a macro.

Add text to the link¶

You can add an optional text to the link that will replace the URL in the rendered text

The source code can be found
on [link](https://github.com/Project-Mau/mau, GitHub).

Using spaces and quotes¶

Please note that if the title contains spaces or the closing parenthesis ) you need to wrap it between double quotes

The source code can be found
on [link](https://github.com/Project-Mau/mau, "the GitHub page").

Should you need to add quotes to the title you will have to escape them

The main [link](https://github.com/Project-Mau/mau, "\"repository\"").

The same rules are valid for the URL

A [link]("https://example.org/?q=[a b]","URL with special characters").

Automatic links¶

Mau provides a limited support for automatic links. A text that starts with http:// or https:// will be automatically converted into a link, for example

The source code can be found at https://github.com/Project-Mau/mau.

The parser will automatically detach any final period or comma from the URL, but otherwise all characters before the next space are considered part of it. Remember that you can always use the full link macro syntax to remove any ambiguity.

Mailto links¶

Mailto links can be created with the mailto macro, which works like the link macro described above.

Get in touch at [mailto](info@example.com).