MarkItUp Sample Plugin

This project shows how to create a sample plugin for MarkItUp. The most important parts are as follows:

Next, implement your custom DocumentConverter:

from typing import BinaryIO, Any
from markitup import MarkItUp, DocumentConverter, DocumentConverterResult, StreamInfo

class RtfConverter(DocumentConverter):

    def __init__(
        self, priority: float = DocumentConverter.PRIORITY_SPECIFIC_FILE_FORMAT
    ):
        super().__init__(priority=priority)

    def accepts(
        self,
        file_stream: BinaryIO,
        stream_info: StreamInfo,
        **kwargs: Any,
    ) -> bool:
	
	# Implement logic to check if the file stream is an RTF file
	# ...
	raise NotImplementedError()


    def convert(
        self,
        file_stream: BinaryIO,
        stream_info: StreamInfo,
        **kwargs: Any,
    ) -> DocumentConverterResult:

	# Implement logic to convert the file stream to Markdown
	# ...
	raise NotImplementedError()

Next, make sure your package implements and exports the following:

# The version of the plugin interface that this plugin uses. 
# The only supported version is 1 for now.
__plugin_interface_version__ = 1 

# The main entrypoint for the plugin. This is called each time MarkItUp instances are created.
def register_converters(markitup: MarkItUp, **kwargs):
    """
    Called during construction of MarkItUp instances to register converters provided by plugins.
    """

    # Simply create and attach an RtfConverter instance
    markitup.register_converter(RtfConverter())

Finally, create an entrypoint in the pyproject.toml file:

[project.entry-points."markitup.plugin"]
sample_plugin = "markitup_sample_plugin"

Here, the value of sample_plugin can be any key, but should ideally be the name of the plugin. The value is the fully qualified name of the package implementing the plugin.

Installation

To use the plugin with MarkItUp, it must be installed. To install the plugin from the current directory use:

pip install -e .

Once the plugin package is installed, verify that it is available to MarkItUp by running:

markitup --list-plugins

To use the plugin for a conversion use the --use-plugins flag. For example, to convert an RTF file:

markitup --use-plugins path-to-file.rtf

In Python, plugins can be enabled as follows:

from markitup import MarkItUp

md = MarkItUp(enable_plugins=True) 
result = md.convert("path-to-file.rtf")
print(result.text_content)

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

3.3 KiB Raw Blame History

MarkItUp Sample Plugin

Installation

Trademarks

3.3 KiB

Raw Blame History