I'm looking for a part-time remote job.

Hire me

I'm the author of:

Mastering Redmine is a comprehensive guide with tips, tricks and best practices, and an easy-to-learn structure.

Check the book's project or

Buy the book

Social pages of the book:

By buying this book you also donate to Redmine (see this page).

Follow me:

WikiNG plugin for Redmine

The WikiNG plugin for Redmine is aimed to extend Redmine Wiki syntax by making it more developer-ready, more emotional and social...

WikiNG is not known to be compatible with Markdown.

Syntax extensions

The WikiNG plugin adds the following extensions:

  • New links:
  • New blocks:
    • <warning> ... </warning> or warning. ...
    • <notice> ... </notice> or notice. ...
    • <tip> ... </tip> or tip. ...
  • New footnote syntax:
    • Now footnotes can be written inline with double parentheses1: ((...))
  • Smileys:
    • :), =), :D, =D, :'(, :(, ;), :P, :O, :/, :S, :|, :X, :*, O:), >:), B), (!), (?), (v), (x) and @}->-
      , , , , , , , , , , , , , , , , , , , , and
  • Special characters:
    • <-, <->, ->, <=, <=>, =>, -- and ---
      ←, ↔, →, ⇐, ⇔, ⇒, – and
  • Markers:
    • {TODO}
    • {UPDATE}
    • {FIXME}
    • {NEW}
    • {FREE}
    • {BETA}
  • CSS classes:
    • shadow → drops shadow for images, e.g., !(wiking shadow).image.png!
    • mac-shadow → drops the Mac-style shadow for images, e.g., !(wiking mac-shadow).image.png!
    • pressed → embosses code blocks, e.g., <pre class="wiking pressed">...</pre>
    • button → renders a link as a button, e.g., "(wiking button)anchor":link
    • small → makes font slightly smaller, e.g., %(wiking small)small text% or p(wiking small). small paragraph
  • Macros:
    • User-defined macros (see below)
      Macros {{version}} and {{date}} are not compatible with formatted text caching.
    • Conditional macro: {{date >= YYYY-MM-DD}} ... {{date}}
    • Conditional macro: {{version < x.x.x}} ... {{version}}
    • Macro for creating and calling custom hook: {{wiking_hook(<name>)}}

Check this page for more detailed syntax. To experiment with the syntax use the playground.

User-defined macros

Redmine supports the macro concept, the main idea of which is to allow adding custom macros by plugins. But, WikiNG uses it in a different way – it allows adding custom macros through the Web interface! This means, that now custom macros can be added not only by developers in their plugins, but also by administrators.

For adding custom macros WikiNG adds the new “Custom Wiki macros” menu to Administration:

Custom Wiki macros

For details about custom macros check this page.

Consider sharing you custom macros with the community using the forum (check Guidelines).


In addition to just rendering links to user profiles since 1.0.0b of the plugin user links also produce mentions. Mentions, like activities, get listed in the user profile (to accommodate both the plugin adds the tabbed menu there). In this list a mention is a Redmine object, that contains link(s) to the user.


Each user link (and, therefore, mention) also generates the email notification (if the administrator and the mentioned user have configured Redmine accordingly). This way the mentioned user gets notified about the mention by email!

To make sure, that mentions will be emailed to mentioned users...

The administrator needs to:

  • Configure Email notifications as described here.
  • Enable the User mentioned action in Administration → Settings → Email notifications.

Users need to:

  • Set the Email notifications option in their profiles to “For any event on all my projects”, “Only for things I watch or I’m involved in” or “Only for things I am the owner of”.

In user links you need to use the user’s numeric identifier or login name. These data are to be determined from user profile URLs, what makes usage of this feature slightly troublesome. Therefore, to help here since 1.1.0 WikiNG supports user mentions autocompletion – you type a few characters and the plugin suggests users with these characters in identifier, login, first or last name.

Adding support for mentions in third-party plugins

The mentioning and notification works due to the special event and mention API implemented for main Redmine objects, that support Wiki formatted text (e.g., Wiki pages, issues). In other words, similar objects in third-party plugins may fail to appear in mentions of users and to notify mentioned users.

So, you (or the author) may need to modify third-party plugins to let their objects be “mentionable”... Check this page on how to do this.


To install the plugin do:

  • Copy wiking directory to #{RAILS_ROOT}/plugins
  • Run: rake redmine:plugins:migrate RAILS_ENV=production
  • Restart Redmine


You can contribute to the plugin by sharing your theme, if you have created one, or by improving icons/pictures, that are used for, e.g., markers.

You can also share your custom macros on the forum (see Guidelines).

Similar plugins

1 just use double parentheses

SyntaxReference.png View - WikiNG Syntax Reference window (67.6 KB) Andriy Lesyuk, 01 Jul 2012 09:01

HiddenText.png View - Hidden text (7.77 KB) Andriy Lesyuk, 01 Jul 2012 09:01

wiki-toolbar.png View - New icon on the Wiki toolbar (3.76 KB) Andriy Lesyuk, 17 Sep 2013 07:01

CustomWikiMacros.png View - Custom Wiki macros (63.8 KB) Andriy Lesyuk, 20 May 2014 23:17

Mentions.png View - Mentions (44.9 KB) Andriy Lesyuk, 20 May 2014 23:21

Terms of use | Privacy policy