OurBigBook Docs
Insane autolink, i.e. the link text is the same as the link address:Exact parsing rules described at: Section "Insane link parsing rules".
The website http://example.com is cool. See also:
\Q[http://example.com/2]which renders as:
The website example.com is cool. See also:
Note that the prefixes
http:// and https:// are automatically removed from the displayed link, since they are so common that they woudly simply add noise.Equivalent sane version:
The website \a[http://example.com] is cool.
\Q[\a[http://example.com/2]]which renders as:
The website example.com is cool.
Insane link with custom text:Equivalent sane version:If the custom text is empty, an autolink is generated. This is often useful if you want your link to be followed by punctuation:This could also be achieved with the sane syntax of course, but this pattern saves a tiny bit of typing.
The website http://example.com[example.com] is cool.which renders as:
The website example.com is cool.
The website \a[http://example.com][example.com] is cool.which renders as:
The website example.com is cool.
The website is really cool: http://example.com[].which renders as:
The website is really cool: example.com.
Link to a file in the current repository:This links to a raw view of that file.
The file \a[index.js] is cool.which renders as:
The file index.js is cool.
Link to a directory in the current repository:This links to an output file that contains a generated directory listing of that directory.
The directory \a[file_demo] is cooler.which renders as:
The directory file_demo is cooler.