First.
Third.
``` ### Font awesome * Option: `--ext-font-awesome` This allows to turn autolinks with `fa` scheme into font awesome icons: ``` $ mmark --ext-font-awesome Here is the user icon:Here is the user icon: .
A more interesting example: .
``` In general, all path components in URIs that go after the name of icon will be prefixed with `"fa-"` and added as classes, so you can do a lot of fancy stuff, see http://fontawesome.io/examples/. ### Footnotes * Option: `--ext-footnotes` The extension performs two transformations: * It turns links with URIs with `footnote` scheme and single path piece consisting of a number into links to footnote references. * It turns block quotes with the `"footnotes"` label (see the example below) into a footnote section. ``` $ mmark --ext-footnotes Here goes some text [1](footnote:1). > footnotes 1. Here we have the footnote. ----------------------- Control-DHere goes some text 1.
To enable that mode press Ctrl+A.
``` The use of reference-style links seems more aesthetically pleasant to the author, but you can of course do something like this instead: ``` To enable that mode press [Ctrl+A](kbd:). ``` ### Link targets * Option: `--ext-link-target` When title of a link starts with the word `"_blank"`, `"_self"`, `"_parent"`, or `"_top"`, it's stripped from title (as well as all whitespace after it) and added as the value of `target` attribute of the resulting link. For example: ``` $ mmark --ext-kbd This [link](/url '_blank My title') opens in new tab. ----------------------- Control-DThis link opens in new tab.
``` ### MathJax * Option: `--ext-mathjax` The extension allows to transform inline code spans into MathJax inline spans and code blocks with the info string `"mathjax"` (case-sensitive) into MathJax display spans. Every line in such a code block will produce a separate display span, i.e. a separate line with a formula (which is probably what you want anyway). Inline code spans must start and end with the dollar sign `$` to be recognized as MathJax markup: ```` $ mmark --ext-mathjax Let's talk about `$A$` and `$B$`. ```mathjax A \xrightarrow{f} B ``` ----------------------- Control-DLet's talk about \(A\) and \(B\).
\[A \xrightarrow{f} B\]
```` ### Email obfuscation * Option: `--obfuscate-email CLASS` This extension makes email addresses in autolinks be rendered as something like this: ``` [mark@arch ~]$ mmark --ext-obfuscate-email protected-email Send all your spam toSend all your spam to Enable JavaScript to see this email, if you can!
``` You'll also need to include jQuery and this bit of JS code for the magic to work: ```java-script $(document).ready(function () { $(".protected-email").each(function () { var item = $(this); var email = item.data('email'); item.attr('href', 'mailto:' + email); item.html(email); }); }); ``` ### Punctuation prettifier * Option: `--ext-punctuation` This makes MMark prettify punctuation (only affects plain text in inlines), the effect is the following: * Replace `...` with ellipsis `…` * Replace `---` with em-dash `—` * Replace `--` with en-dash `–` * Replace `"` with left double quote `“` when previous character was a space character, otherwise replace it with right double quote `”` * Replace `'` with left single quote `‘` when previous character was a space character, otherwise replace it with right single quote `’` aka apostrophe For example (not sure if this is the correct punctuation to use here, but it demonstrates the effect): ``` [mark@arch ~]$ mmark --ext-punctuation Something---we don't know what, happened... ----------------------- Control-DSomething—we don’t know what, happened…
``` ### GHC syntax highlighter * Option: `--ext-ghc-highlighter` Use the [GHC syntax highlighter](https://hackage.haskell.org/package/ghc-syntax-highlighter) package to highlight code blocks with `"haskell"` info string using lexer of GHC itself. The resulting HTML will be rendered as described [here](https://hackage.haskell.org/package/mmark-ext/docs/Text-MMark-Extension-GhcSyntaxHighlighter.html#v:ghcSyntaxHighlighter). Example: ```` [mark@arch ~]$ mmark --ext-skylighting Some Haskell: ```haskell main :: IO () main = return () ``` ----------------------- Control-DSome Haskell:
main :: IO ()
main = return ()
Some Haskell:
main :: IO ()
main = return ()
Foo.
Bar.
Baz.
```` ## Contribution Issues, bugs, and questions may be reported in [the GitHub issue tracker for this project](https://github.com/mmark-md/mmark-cli/issues). Pull requests are also welcome. ## License Copyright © 2018 Mark Karpov Distributed under BSD 3 clause license.