*generate a link to a MMD header*

        **Key Arguments:**
            - ``headerText`` -- the header text (or anchor tag)
            - ``text`` -- the doc text to link. Default *False*

        **Return:**
            - ``link`` -- the link to the header

        **Usage:**

            To generate a MMD header link:

            .. code-block:: python

                link = md.headerLink(" This is my header  ", "inline text")
                print link

                # OUTPUT:
                # [inline text][This is my header]
                #

def headerLink(
            self,
            headerText,
            text=False):
        """*generate a link to a MMD header*

        **Key Arguments:**
            - ``headerText`` -- the header text (or anchor tag)
            - ``text`` -- the doc text to link. Default *False*

        **Return:**
            - ``link`` -- the link to the header

        **Usage:**

            To generate a MMD header link:

            .. code-block:: python

                link = md.headerLink(" This is my header  ", "inline text")
                print link

                # OUTPUT:
                # [inline text][This is my header]
                #
        """
        headerText = headerText.strip()

        if text:
            return self._surround(text, "[", "][%(headerText)s]" % locals())
        else:
            return "[%(headerText)s][]" % locals()