1 ## Markdown Shaarli plugin
3 Convert all your shaares description to HTML formatted Markdown.
5 [Read more about Markdown syntax](http://daringfireball.net/projects/markdown/syntax).
7 Markdown processing is done with [Parsedown library](https://github.com/erusev/parsedown).
11 As a default plugin, it should already be in `tpl/plugins/` directory.
12 If not, download and unpack it there.
14 The directory structure should look like:
26 To enable the plugin, just check it in the plugin administration page.
28 You can also add `markdown` to your list of enabled plugins in `data/config.json.php`
29 (`general.enabled_plugins` list).
31 This should look like:
42 Parsedown parsing library is imported using Composer. If you installed Shaarli using `git`,
43 or the `master` branch, run
45 composer update --no-dev --prefer-dist
49 If the tag `nomarkdown` is set for a shaare, it won't be converted to Markdown syntax.
51 > Note: this is a special tag, so it won't be displayed in link list.
55 Markdown support HTML tags. For example:
57 > <strong>strong</strong><strike>strike</strike>
61 > <strong>strong</strong><strike>strike</strike>
63 If you want to shaare HTML code, it is necessary to use inline code or code blocks.
65 **If your shaared descriptions containing HTML tags before enabling the markdown plugin,
66 enabling it might break your page.**
68 > Note: HTML tags such as script, iframe, etc. are disabled for security reasons.
74 If you're using a redirector, you *need* to add a space after a link,
75 otherwise the rest of the line will be `urlencode`.
78 [link](http://domain.tld)-->test
81 Will consider `http://domain.tld)-->test` as URL.
83 Instead, add an additional space.
86 [link](http://domain.tld) -->test
89 > Won't fix because a `)` is a valid part of an URL.