HipChat Message Markdown

Adds Markdown support to the HipChat web interface.This extension adds support for Markdown in the web interface for HipChat; i.e. https://yourgroup.hipchat.com/chat/

EXPERIMENTAL at the present time; and it will most likely remain a hack-hackety way to accomplish this until such time as HipChat supports it officially.

Requirements:

- You will need an API Token for your group at HipChat. This API Token needs to include "admin" access so this extension can acquire a list of all room IDs. You will be prompted for your API Token the first time you reload the HipChat interface after installing this extension. If you need to modify the API Token, please check the settings panel in the HipChat web interface.

Limitations:

- Private messages are not supported. You can still send private messages of course, but Markdown is not applicable in this case.

- Messages that contain @callouts are not treated as Markdown due to a limitation in the HipChat API.

- Messages that include attachments are sent in two parts. The first part is your message (in Markdown); the second part is your attachment.

- Emoticons are not supported. However, it's possible to include images now that Markdown is possible.

- /Slash commands are never treated as Markdown; for obvious reasons. A /slash command is always handled by whatever HipChat routine is associated with the command.

- There is a slight lag before seeing your Markdown message appear in the spool due to the fact that Markdown messages are processed through the HipChat API.

Syntax Hiliting:

- This extension also includes support for syntax hiliting. Nothing to do, this is enabled by default and it works together with fenced code blocks in Markdown (GFM-style).

Automatic Replies:

- TIP: select any text in the HipChat interface and press the `R` key for an automatic quoted reply.

- TIP: `Alt+R` gives a quote with the original author's display name (in order to preserve Markdown), while just `R` uses the `@mention` name (default behavior).

Tab Override:

- With this extension running you can use the TAB key to create indentations in your message (handy for code snippets); while still remaining 100% compatible with all HipChat auto-complete functionality for @callouts.

Zen Mode:

- This extension enables fullscreen editing via Zen Mode. You will find an icon to enable fullscreen editing on the message input field. Or, you can use keyboard shortcuts Alt+M or Alt+Z to toggle Zen Mode on/off.

TODO:

- Waiting for the HipChat v2 API to reimplement this method so that messages can hopefully then support @mentions together with Markdown. See: <https://www.hipchat.com/docs/apiv2/method/send_room_notification_redirect>

- Find a way to avoid needing an `admin` API Token.

SOURCE CODE & BUG REPORTS:

- See: <https://github.com/WebSharks/HipChat-MD>