*create MMD image link*

        **Key Arguments:**
            - ``title`` -- the title for the image
            - ``url`` -- the image URL
            - ``width`` -- the width in pixels of the image. Default *800*

        **Return:**
            - ``imageLink`` -- the MMD image link

        **Usage:**

            To create a MMD image link:

            .. code-block:: python

                imageLink = md.image(
                    "http://www.thespacedoctor.co.uk/images/thespacedoctor_icon_white_circle.png", "thespacedoctor icon", 400)
                print imageLink

                # OUTPUT:
                # ![thespacedoctor icon][thespacedoctor icon 20170228t130146.472262]
                #
                # [thespacedoctor icon 20170228t130146.472262]: http://www.thespacedoctor.co.uk/images/thespacedoctor_icon_white_circle.png "thespacedoctor icon" width=400px
                #

def image(
            self,
            url,
            title="",
            width=800):
        """*create MMD image link*

        **Key Arguments:**
            - ``title`` -- the title for the image
            - ``url`` -- the image URL
            - ``width`` -- the width in pixels of the image. Default *800*

        **Return:**
            - ``imageLink`` -- the MMD image link

        **Usage:**

            To create a MMD image link:

            .. code-block:: python

                imageLink = md.image(
                    "http://www.thespacedoctor.co.uk/images/thespacedoctor_icon_white_circle.png", "thespacedoctor icon", 400)
                print imageLink

                # OUTPUT:
                # ![thespacedoctor icon][thespacedoctor icon 20170228t130146.472262]
                #
                # [thespacedoctor icon 20170228t130146.472262]: http://www.thespacedoctor.co.uk/images/thespacedoctor_icon_white_circle.png "thespacedoctor icon" width=400px
                #
        """
        title = title.strip()
        caption = title

        now = datetime.now()
        figId = now.strftime("%Y%m%dt%H%M%S.%f")

        if len(title):
            figId = "%(title)s %(figId)s" % locals()

        imageLink = """\n\n![%(caption)s][%(figId)s]

[%(figId)s]: %(url)s "%(title)s" width=%(width)spx\n\n""" % locals()

        return imageLink