*convert the kindle_notebook object*

        **Return:**
            - ``kindle_notebook``

        **Usage:**
        .. todo::

            - add usage info
            - create a sublime snippet for usage
            - update the package tutorial if needed

        .. code-block:: python 

            usage code

def convert(self):
        """
        *convert the kindle_notebook object*

        **Return:**
            - ``kindle_notebook``

        **Usage:**
        .. todo::

            - add usage info
            - create a sublime snippet for usage
            - update the package tutorial if needed

        .. code-block:: python 

            usage code 
        """
        self.log.debug('starting the ``convert`` method')

        import codecs
        pathToReadFile = self.kindleExportPath
        try:
            self.log.debug("attempting to open the file %s" %
                           (pathToReadFile,))
            readFile = codecs.open(pathToReadFile, encoding='utf-8', mode='r')
            annotations = readFile.read()
            readFile.close()
        except IOError, e:
            message = 'could not open the file %s' % (pathToReadFile,)
            self.log.critical(message)
            raise IOError(message)

        annotations = annotations.replace(u"’", "'").replace(
            u"“ ", '"').replace(u"“", '"').replace(u"”", '"').replace(u"–", "-").replace(u"—", "-")

        # COLLECT KEY COMPONENTS
        try:
            title = self.find_component("bookTitle", annotations)
        except:
            return False
        regex = re.compile(r'_xx\d*xx$')
        title = regex.sub("", title)
        authors = self.find_component("authors", annotations)
        citation = self.find_component("citation", annotations)

        # CLEAN THE CITATION
        regex = re.compile(r'</?i>', re.S)
        citation = regex.sub('*', citation)
        regex = re.compile(r'Citation \(.*?\): ', re.S)
        citation = regex.sub('', citation).replace(" Kindle edition.", "")

        # COLLECT ANNOTATIONS
        annotationDict = {}
        matchObject = re.finditer(
            r"""<div class="noteHeading">\s+Highlight\(<span.*?>(?P<color>.*?)</span>\)((?P<section>.*?)Page (?P<page>\d+))?.*?Location (?P<location>\d+)\s+</div>\s+<div class="noteText">(?P<note>.*?)</div>""",
            annotations,
            flags=re.S
        )

        for match in matchObject:
            location = int(match.group("location"))
            location = "%(location)09d" % locals()
            if match.group("page"):
                try:
                    annotationDict[location] = {"color": match.group("color"), "page": match.group(
                        "page"), "section": self.clean(match.group("section"))[3:-2], "note": self.clean(match.group("note"))}
                except:
                    print match.group("note")
                    sys.exit(0)
            else:
                try:
                    annotationDict[location] = {"color": match.group(
                        "color"), "note": self.clean(match.group("note"))}
                except:
                    print match.group("note")
                    sys.exit(0)

        # COLLECT PERSONAL NOTES
        matchObject = re.finditer(
            r"""<div class="noteHeading">\s+Note -( Page (?P<page>\d+))?.*?Location (?P<location>\d+)\s+</div>\s+<div class="noteText">(?P<note>.*?)</div>""",
            annotations,
            flags=re.S
        )

        for match in matchObject:
            location = int(match.group("location"))
            location = "%(location)09dnote" % locals()
            if match.group("page"):
                annotationDict[location] = {"color": None, "page": match.group(
                    "page"), "note": self.clean(match.group("note"))}
            else:
                annotationDict[location] = {
                    "color": None, "note": self.clean(match.group("note"))}

        annotationDict = collections.OrderedDict(
            sorted(annotationDict.items()))

        mdContent = "\n# %(title)s\n\nAuthors: **%(authors)s**\n\n" % locals()
        for k, v in annotationDict.iteritems():
            mdContent += self.convertToMD(v) + "\n\n"

        if len(annotationDict) == 0:
            return False

        pathToWriteFile = self.outputPath
        try:
            self.log.debug("attempting to open the file %s" %
                           (pathToWriteFile,))
            writeFile = codecs.open(
                pathToWriteFile, encoding='utf-8', mode='w')
        except IOError, e:
            message = 'could not open the file %s' % (pathToWriteFile,)
            self.log.critical(message)
            raise IOError(message)
        writeFile.write(mdContent)
        writeFile.close()

        self.log.debug('completed the ``convert`` method')
        return pathToWriteFile