markdown-to-confluence 0.4.2__tar.gz → 0.4.3__tar.gz

{markdown_to_confluence-0.4.2/markdown_to_confluence.egg-info → markdown_to_confluence-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-to-confluence
-Version: 0.4.2
+Version: 0.4.3
 Summary: Publish Markdown files to Confluence wiki
 Author-email: Levente Hunyadi <hunyadi@gmail.com>
 Maintainer-email: Levente Hunyadi <hunyadi@gmail.com>
@@ -58,7 +58,7 @@ This Python package
 * Text with **bold**, *italic*, `monospace`, <ins>underline</ins> and ~~strikethrough~~
 * Link to [sections on the same page](#getting-started) or [external locations](http://example.com/)
 * Subscript and superscript (with HTML tags `<sub>` and `<sup>`)
-* Math formulas with LaTeX notation [^math]
+* Math formulas with LaTeX notation
 * Emoji
 * Ordered and unordered lists
 * Block quotes
@@ -69,8 +69,8 @@ This Python package
 * [Table of contents](https://docs.gitlab.com/ee/user/markdown.html#table-of-contents)
 * [Admonitions](https://python-markdown.github.io/extensions/admonition/) and alert boxes in [GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) and [GitLab](https://docs.gitlab.com/ee/development/documentation/styleguide/#alert-boxes)
 * [Collapsed sections](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections)
-* draw\.io diagrams [^drawio]
-* [Mermaid diagrams](https://mermaid.live/) in code blocks (converted to images) [^mermaid]
+* draw\.io diagrams
+* [Mermaid diagrams](https://mermaid.live/) in code blocks (converted to images)
 
 Whenever possible, the implementation uses [Confluence REST API v2](https://developer.atlassian.com/cloud/confluence/rest/v2/) to fetch space properties, and get, create or update page content.
 
@@ -84,9 +84,9 @@ pip install markdown-to-confluence
 
 ### Command-line utilities
 
-**Optional.** Converting `*.drawio` diagrams into PNG or SVG images requires installing [draw.io](https://www.drawio.com/). (Refer to `--render-drawio`.)
+**Optional.** Converting `*.drawio` diagrams to PNG or SVG images before uploading to Confluence as attachments requires installing [draw.io](https://www.drawio.com/). (Refer to `--render-drawio`.)
 
-**Optional.** Converting code blocks of Mermaid diagrams into PNG or SVG images requires [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). (Refer to `--render-mermaid`.)
+**Optional.** Converting code blocks of Mermaid diagrams to PNG or SVG images before uploading to Confluence as attachments requires [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). (Refer to `--render-mermaid`.)
 
 ```sh
 npm install -g @mermaid-js/mermaid-cli
@@ -98,9 +98,9 @@ As authors of *md2conf*, we don't endorse or support any particular Confluence m
 
 **Optional.** Editable draw\.io diagrams require [draw.io Diagrams marketplace app](https://marketplace.atlassian.com/apps/1210933/draw-io-diagrams-uml-bpmn-aws-erd-flowcharts). (Refer to `--no-render-drawio`.)
 
-**Optional.** Displaying Mermaid diagrams in Confluence without pre-rendering requires a marketplace app. (Refer to `--no-render-mermaid`.)
+**Optional.** Displaying Mermaid diagrams in Confluence without pre-rendering in the synchronization phase requires a marketplace app. (Refer to `--no-render-mermaid`.)
 
-**Optional.** Displaying formulas and equations requires [LaTeX Math marketplace app](https://marketplace.atlassian.com/apps/1226109/latex-math-for-confluence-math-formula-equations).
+**Optional.** Displaying formulas and equations in Confluence requires [marketplace app](https://marketplace.atlassian.com/apps/1226109/latex-math-for-confluence-math-formula-equations), refer to [LaTeX Math for Confluence - Math Formula & Equations](https://help.narva.net/latex-math-for-confluence/).
 
 ## Getting started
 
@@ -523,7 +523,3 @@ FROM leventehunyadi/md2conf:latest
 
 CMD ["-d", "example.atlassian.net", "-u", "levente.hunyadi@instructure.com", "-a", "0123456789abcdef", "-s", "SPACE", "./"]
 ```
-
-[^math]: Requires installing Confluence plugin [LaTeX Math for Confluence - Math Formula & Equations](https://help.narva.net/latex-math-for-confluence/).
-[^drawio]: Converting draw\.io diagrams to images before uploading to Confluence requires an installation of [draw.io](https://www.drawio.com/). Editable draw\.io diagrams require separate marketplace app.
-[^mermaid]: Converting Mermaid diagrams to images before uploading to Confluence requires [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). Displaying Mermaid diagrams on the fly requires separate marketplace app.

{markdown_to_confluence-0.4.2 → markdown_to_confluence-0.4.3}/README.md

@@ -16,7 +16,7 @@ This Python package
 * Text with **bold**, *italic*, `monospace`, <ins>underline</ins> and ~~strikethrough~~
 * Link to [sections on the same page](#getting-started) or [external locations](http://example.com/)
 * Subscript and superscript (with HTML tags `<sub>` and `<sup>`)
-* Math formulas with LaTeX notation [^math]
+* Math formulas with LaTeX notation
 * Emoji
 * Ordered and unordered lists
 * Block quotes
@@ -27,8 +27,8 @@ This Python package
 * [Table of contents](https://docs.gitlab.com/ee/user/markdown.html#table-of-contents)
 * [Admonitions](https://python-markdown.github.io/extensions/admonition/) and alert boxes in [GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) and [GitLab](https://docs.gitlab.com/ee/development/documentation/styleguide/#alert-boxes)
 * [Collapsed sections](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections)
-* draw\.io diagrams [^drawio]
-* [Mermaid diagrams](https://mermaid.live/) in code blocks (converted to images) [^mermaid]
+* draw\.io diagrams
+* [Mermaid diagrams](https://mermaid.live/) in code blocks (converted to images)
 
 Whenever possible, the implementation uses [Confluence REST API v2](https://developer.atlassian.com/cloud/confluence/rest/v2/) to fetch space properties, and get, create or update page content.
 
@@ -42,9 +42,9 @@ pip install markdown-to-confluence
 
 ### Command-line utilities
 
-**Optional.** Converting `*.drawio` diagrams into PNG or SVG images requires installing [draw.io](https://www.drawio.com/). (Refer to `--render-drawio`.)
+**Optional.** Converting `*.drawio` diagrams to PNG or SVG images before uploading to Confluence as attachments requires installing [draw.io](https://www.drawio.com/). (Refer to `--render-drawio`.)
 
-**Optional.** Converting code blocks of Mermaid diagrams into PNG or SVG images requires [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). (Refer to `--render-mermaid`.)
+**Optional.** Converting code blocks of Mermaid diagrams to PNG or SVG images before uploading to Confluence as attachments requires [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). (Refer to `--render-mermaid`.)
 
 ```sh
 npm install -g @mermaid-js/mermaid-cli
@@ -56,9 +56,9 @@ As authors of *md2conf*, we don't endorse or support any particular Confluence m
 
 **Optional.** Editable draw\.io diagrams require [draw.io Diagrams marketplace app](https://marketplace.atlassian.com/apps/1210933/draw-io-diagrams-uml-bpmn-aws-erd-flowcharts). (Refer to `--no-render-drawio`.)
 
-**Optional.** Displaying Mermaid diagrams in Confluence without pre-rendering requires a marketplace app. (Refer to `--no-render-mermaid`.)
+**Optional.** Displaying Mermaid diagrams in Confluence without pre-rendering in the synchronization phase requires a marketplace app. (Refer to `--no-render-mermaid`.)
 
-**Optional.** Displaying formulas and equations requires [LaTeX Math marketplace app](https://marketplace.atlassian.com/apps/1226109/latex-math-for-confluence-math-formula-equations).
+**Optional.** Displaying formulas and equations in Confluence requires [marketplace app](https://marketplace.atlassian.com/apps/1226109/latex-math-for-confluence-math-formula-equations), refer to [LaTeX Math for Confluence - Math Formula & Equations](https://help.narva.net/latex-math-for-confluence/).
 
 ## Getting started
 
@@ -481,7 +481,3 @@ FROM leventehunyadi/md2conf:latest
 
 CMD ["-d", "example.atlassian.net", "-u", "levente.hunyadi@instructure.com", "-a", "0123456789abcdef", "-s", "SPACE", "./"]
 ```
-
-[^math]: Requires installing Confluence plugin [LaTeX Math for Confluence - Math Formula & Equations](https://help.narva.net/latex-math-for-confluence/).
-[^drawio]: Converting draw\.io diagrams to images before uploading to Confluence requires an installation of [draw.io](https://www.drawio.com/). Editable draw\.io diagrams require separate marketplace app.
-[^mermaid]: Converting Mermaid diagrams to images before uploading to Confluence requires [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). Displaying Mermaid diagrams on the fly requires separate marketplace app.

{markdown_to_confluence-0.4.2 → markdown_to_confluence-0.4.3/markdown_to_confluence.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-to-confluence
-Version: 0.4.2
+Version: 0.4.3
 Summary: Publish Markdown files to Confluence wiki
 Author-email: Levente Hunyadi <hunyadi@gmail.com>
 Maintainer-email: Levente Hunyadi <hunyadi@gmail.com>
@@ -58,7 +58,7 @@ This Python package
 * Text with **bold**, *italic*, `monospace`, <ins>underline</ins> and ~~strikethrough~~
 * Link to [sections on the same page](#getting-started) or [external locations](http://example.com/)
 * Subscript and superscript (with HTML tags `<sub>` and `<sup>`)
-* Math formulas with LaTeX notation [^math]
+* Math formulas with LaTeX notation
 * Emoji
 * Ordered and unordered lists
 * Block quotes
@@ -69,8 +69,8 @@ This Python package
 * [Table of contents](https://docs.gitlab.com/ee/user/markdown.html#table-of-contents)
 * [Admonitions](https://python-markdown.github.io/extensions/admonition/) and alert boxes in [GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) and [GitLab](https://docs.gitlab.com/ee/development/documentation/styleguide/#alert-boxes)
 * [Collapsed sections](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections)
-* draw\.io diagrams [^drawio]
-* [Mermaid diagrams](https://mermaid.live/) in code blocks (converted to images) [^mermaid]
+* draw\.io diagrams
+* [Mermaid diagrams](https://mermaid.live/) in code blocks (converted to images)
 
 Whenever possible, the implementation uses [Confluence REST API v2](https://developer.atlassian.com/cloud/confluence/rest/v2/) to fetch space properties, and get, create or update page content.
 
@@ -84,9 +84,9 @@ pip install markdown-to-confluence
 
 ### Command-line utilities
 
-**Optional.** Converting `*.drawio` diagrams into PNG or SVG images requires installing [draw.io](https://www.drawio.com/). (Refer to `--render-drawio`.)
+**Optional.** Converting `*.drawio` diagrams to PNG or SVG images before uploading to Confluence as attachments requires installing [draw.io](https://www.drawio.com/). (Refer to `--render-drawio`.)
 
-**Optional.** Converting code blocks of Mermaid diagrams into PNG or SVG images requires [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). (Refer to `--render-mermaid`.)
+**Optional.** Converting code blocks of Mermaid diagrams to PNG or SVG images before uploading to Confluence as attachments requires [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). (Refer to `--render-mermaid`.)
 
 ```sh
 npm install -g @mermaid-js/mermaid-cli
@@ -98,9 +98,9 @@ As authors of *md2conf*, we don't endorse or support any particular Confluence m
 
 **Optional.** Editable draw\.io diagrams require [draw.io Diagrams marketplace app](https://marketplace.atlassian.com/apps/1210933/draw-io-diagrams-uml-bpmn-aws-erd-flowcharts). (Refer to `--no-render-drawio`.)
 
-**Optional.** Displaying Mermaid diagrams in Confluence without pre-rendering requires a marketplace app. (Refer to `--no-render-mermaid`.)
+**Optional.** Displaying Mermaid diagrams in Confluence without pre-rendering in the synchronization phase requires a marketplace app. (Refer to `--no-render-mermaid`.)
 
-**Optional.** Displaying formulas and equations requires [LaTeX Math marketplace app](https://marketplace.atlassian.com/apps/1226109/latex-math-for-confluence-math-formula-equations).
+**Optional.** Displaying formulas and equations in Confluence requires [marketplace app](https://marketplace.atlassian.com/apps/1226109/latex-math-for-confluence-math-formula-equations), refer to [LaTeX Math for Confluence - Math Formula & Equations](https://help.narva.net/latex-math-for-confluence/).
 
 ## Getting started
 
@@ -523,7 +523,3 @@ FROM leventehunyadi/md2conf:latest
 
 CMD ["-d", "example.atlassian.net", "-u", "levente.hunyadi@instructure.com", "-a", "0123456789abcdef", "-s", "SPACE", "./"]
 ```
-
-[^math]: Requires installing Confluence plugin [LaTeX Math for Confluence - Math Formula & Equations](https://help.narva.net/latex-math-for-confluence/).
-[^drawio]: Converting draw\.io diagrams to images before uploading to Confluence requires an installation of [draw.io](https://www.drawio.com/). Editable draw\.io diagrams require separate marketplace app.
-[^mermaid]: Converting Mermaid diagrams to images before uploading to Confluence requires [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). Displaying Mermaid diagrams on the fly requires separate marketplace app.

{markdown_to_confluence-0.4.2 → markdown_to_confluence-0.4.3}/markdown_to_confluence.egg-info/SOURCES.txt

@@ -16,11 +16,13 @@ md2conf/api.py
 md2conf/application.py
 md2conf/collection.py
 md2conf/converter.py
+md2conf/domain.py
 md2conf/drawio.py
 md2conf/emoji.py
 md2conf/entities.dtd
 md2conf/extra.py
 md2conf/local.py
+md2conf/markdown.py
 md2conf/matcher.py
 md2conf/mermaid.py
 md2conf/metadata.py
@@ -52,6 +54,7 @@ tests/source/math.md
 tests/source/mermaid.md
 tests/source/missing.md
 tests/source/sections.md
+tests/source/table.md
 tests/source/tags.md
 tests/source/title.md
 tests/source/figure/diagram.drawio
@@ -73,5 +76,6 @@ tests/target/math.xml
 tests/target/mermaid.xml
 tests/target/missing.xml
 tests/target/sections.xml
+tests/target/table.xml
 tests/target/tags.xml
 tests/target/images/images.xml

{markdown_to_confluence-0.4.2 → markdown_to_confluence-0.4.3}/md2conf/__init__.py

@@ -5,7 +5,7 @@ Parses Markdown files, converts Markdown content into the Confluence Storage For
 Confluence API endpoints to upload images and content.
 """
 
-__version__ = "0.4.2"
+__version__ = "0.4.3"
 __author__ = "Levente Hunyadi"
 __copyright__ = "Copyright 2022-2025, Levente Hunyadi"
 __license__ = "MIT"

{markdown_to_confluence-0.4.2 → markdown_to_confluence-0.4.3}/md2conf/__main__.py

@@ -17,14 +17,9 @@ import typing
 from pathlib import Path
 from typing import Any, Iterable, Literal, Optional, Sequence, Union
 
-import requests
-
 from . import __version__
-from .api import ConfluenceAPI
-from .application import Application
-from .converter import ConfluenceDocumentOptions, ConfluencePageID
+from .domain import ConfluenceDocumentOptions, ConfluencePageID
 from .extra import override
-from .local import LocalConverter
 from .metadata import ConfluenceSiteMetadata
 from .properties import ArgumentError, ConfluenceConnectionProperties, ConfluenceSiteProperties
 
@@ -52,7 +47,7 @@ class Arguments(argparse.Namespace):
 
 
 class KwargsAppendAction(argparse.Action):
-    """Append key-value pairs to a dictionary"""
+    """Append key-value pairs to a dictionary."""
 
     @override
     def __call__(
@@ -72,6 +67,30 @@ class KwargsAppendAction(argparse.Action):
         setattr(namespace, self.dest, d)
 
 
+def unsupported(prefer: str) -> type[argparse.Action]:
+    class UnsupportedAction(argparse.Action):
+        """Display an error for unsupported command-line options."""
+
+        @override
+        def __call__(
+            self,
+            parser: argparse.ArgumentParser,
+            namespace: argparse.Namespace,
+            values: Union[None, str, Sequence[Any]],
+            option_string: Optional[str] = None,
+        ) -> None:
+            raise argparse.ArgumentError(
+                self,
+                f"this command-line option is no longer supported, use `--{prefer}`",
+            )
+
+        @override
+        def __repr__(self) -> str:
+            return f"{unsupported.__name__}({repr(prefer)})"
+
+    return UnsupportedAction
+
+
 class PositionalOnlyHelpFormatter(argparse.HelpFormatter):
     def _format_usage(
         self,
@@ -189,12 +208,18 @@ def main() -> None:
         help="Inline Mermaid diagram in Confluence page. (Marketplace app required.)",
     )
     parser.add_argument(
-        "--render-mermaid-format",
+        "--diagram-output-format",
         dest="diagram_output_format",
         choices=["png", "svg"],
         default="png",
         help="Format for rendering Mermaid and draw.io diagrams (default: 'png').",
     )
+    parser.add_argument(
+        "--render-mermaid-format",
+        action=unsupported("diagram-output-format"),
+        metavar="FORMAT",
+        help="Format for rendering Mermaid diagrams (default: 'png').",
+    )
     parser.add_argument(
         "--heading-anchors",
         action="store_true",
@@ -256,6 +281,8 @@ def main() -> None:
         webui_links=args.webui_links,
     )
     if args.local:
+        from .local import LocalConverter
+
         try:
             site_properties = ConfluenceSiteProperties(
                 domain=args.domain,
@@ -271,6 +298,11 @@ def main() -> None:
         )
         LocalConverter(options, site_metadata).process(args.mdpath)
     else:
+        from requests import HTTPError, JSONDecodeError
+
+        from .api import ConfluenceAPI
+        from .application import Application
+
         try:
             properties = ConfluenceConnectionProperties(
                 api_url=args.api_url,
@@ -289,14 +321,14 @@ def main() -> None:
                     api,
                     options,
                 ).process(args.mdpath)
-        except requests.exceptions.HTTPError as err:
+        except HTTPError as err:
             logging.error(err)
 
             # print details for a response with JSON body
             if err.response is not None:
                 try:
                     logging.error(err.response.json())
-                except requests.exceptions.JSONDecodeError:
+                except JSONDecodeError:
                     pass
 
             sys.exit(1)

{markdown_to_confluence-0.4.2 → markdown_to_confluence-0.4.3}/md2conf/application.py

@@ -11,7 +11,8 @@ from pathlib import Path
 from typing import Optional
 
 from .api import ConfluenceContentProperty, ConfluenceLabel, ConfluenceSession, ConfluenceStatus
-from .converter import ConfluenceDocument, ConfluenceDocumentOptions, ConfluencePageID, attachment_name, elements_from_string, get_volatile_attributes
+from .converter import ConfluenceDocument, attachment_name, elements_from_string, get_volatile_attributes
+from .domain import ConfluenceDocumentOptions, ConfluencePageID
 from .extra import override, path_relative_to
 from .metadata import ConfluencePageMetadata
 from .processor import Converter, DocumentNode, Processor, ProcessorFactory
@@ -158,7 +159,7 @@ class SynchronizingProcessor(Processor):
         ):
             self.api.update_page(page_id.page_id, content, title=title, version=page.version.number + 1)
         else:
-            LOGGER.info("Up-to-date page: %s", page_id)
+            LOGGER.info("Up-to-date page: %s", page_id.page_id)
 
         if document.labels is not None:
             self.api.update_labels(

{markdown_to_confluence-0.4.2 → markdown_to_confluence-0.4.3}/md2conf/converter.py

@@ -8,28 +8,27 @@ Copyright 2022-2025, Levente Hunyadi
 
 # mypy: disable-error-code="dict-item"
 
+import dataclasses
 import hashlib
 import importlib.resources as resources
 import logging
 import os.path
 import re
 import uuid
-import xml.etree.ElementTree
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Any, Literal, Optional, Union
 from urllib.parse import ParseResult, quote_plus, urlparse, urlunparse
 
 import lxml.etree as ET
-import markdown
 from lxml.builder import ElementMaker
 from strong_typing.core import JsonType
 
-from md2conf.drawio import extract_diagram
-
+from . import drawio, mermaid
 from .collection import ConfluencePageCollection
+from .domain import ConfluenceDocumentOptions, ConfluencePageID
 from .extra import path_relative_to
-from .mermaid import render_diagram
+from .markdown import markdown_to_html
 from .metadata import ConfluenceSiteMetadata
 from .properties import PageError
 from .scanner import ScannedDocument, Scanner
@@ -101,90 +100,6 @@ def encode_title(text: str) -> str:
     return quote_plus(text.strip())
 
 
-def emoji_generator(
-    index: str,
-    shortname: str,
-    alias: Optional[str],
-    uc: Optional[str],
-    alt: str,
-    title: Optional[str],
-    category: Optional[str],
-    options: dict[str, Any],
-    md: markdown.Markdown,
-) -> xml.etree.ElementTree.Element:
-    """
-    Custom generator for `pymdownx.emoji`.
-    """
-
-    name = (alias or shortname).strip(":")
-    span = xml.etree.ElementTree.Element("span", {"data-emoji-shortname": name})
-    if uc is not None:
-        span.attrib["data-emoji-unicode"] = uc
-
-        # convert series of Unicode code point hexadecimal values into characters
-        span.text = "".join(chr(int(item, base=16)) for item in uc.split("-"))
-    else:
-        span.text = alt
-    return span
-
-
-def math_formatter(
-    source: str,
-    language: str,
-    css_class: str,
-    options: dict[str, Any],
-    md: markdown.Markdown,
-    classes: Optional[list[str]] = None,
-    id_value: str = "",
-    attrs: Optional[dict[str, str]] = None,
-    **kwargs: Any,
-) -> str:
-    """
-    Custom formatter for language `math` in `pymdownx.superfences`.
-    """
-
-    if classes is None:
-        classes = [css_class]
-    else:
-        classes.insert(0, css_class)
-
-    html_id = f' id="{id_value}"' if id_value else ""
-    html_class = ' class="{}"'.format(" ".join(classes))
-    html_attrs = " " + " ".join(f'{k}="{v}"' for k, v in attrs.items()) if attrs else ""
-
-    return f"<div{html_id}{html_class}{html_attrs}>{source}</div>"
-
-
-def markdown_to_html(content: str) -> str:
-    return markdown.markdown(
-        content,
-        extensions=[
-            "admonition",
-            "footnotes",
-            "markdown.extensions.tables",
-            "md_in_html",
-            "pymdownx.arithmatex",
-            "pymdownx.emoji",
-            "pymdownx.highlight",  # required by `pymdownx.superfences`
-            "pymdownx.magiclink",
-            "pymdownx.superfences",
-            "pymdownx.tilde",
-            "sane_lists",
-        ],
-        extension_configs={
-            "footnotes": {"BACKLINK_TITLE": ""},
-            "pymdownx.arithmatex": {"generic": True, "preview": False, "tex_inline_wrap": ["", ""], "tex_block_wrap": ["", ""]},
-            "pymdownx.emoji": {
-                "emoji_generator": emoji_generator,
-            },
-            "pymdownx.highlight": {
-                "use_pygments": False,
-            },
-            "pymdownx.superfences": {"custom_fences": [{"name": "math", "class": "arithmatex", "format": math_formatter}]},
-        },
-    )
-
-
 def _elements_from_strings(dtd_path: Path, items: list[str]) -> ET._Element:
     """
     Creates a fragment of several XML nodes from their string representation wrapped in a root element.
@@ -333,8 +248,8 @@ def title_to_identifier(title: str) -> str:
     "Converts a section heading title to a GitHub-style Markdown same-page anchor."
 
     s = title.strip().lower()
-    s = re.sub("[^ A-Za-z0-9]", "", s)
-    s = s.replace(" ", "-")
+    s = re.sub(r"[^\sA-Za-z0-9_\-]", "", s)
+    s = re.sub(r"\s+", "-", s)
     return s
 
 
@@ -594,9 +509,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
             if absolute_path.name.endswith(".drawio.png") or absolute_path.name.endswith(".drawio.svg"):
                 return self._transform_drawio_image(absolute_path, attrs)
             elif absolute_path.name.endswith(".drawio.xml") or absolute_path.name.endswith(".drawio"):
-                self.images.append(absolute_path)
-                image_filename = attachment_name(path_relative_to(absolute_path, self.base_dir))
-                return self._create_drawio(image_filename, attrs)
+                return self._transform_drawio(absolute_path, attrs)
             else:
                 return self._transform_attached_image(absolute_path, attrs)
 
@@ -651,10 +564,28 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
                 absolute_path = png_file
 
         self.images.append(absolute_path)
-        return self._create_image(absolute_path, attrs)
+        image_name = attachment_name(path_relative_to(absolute_path, self.base_dir))
+        return self._create_attached_image(image_name, attrs)
+
+    def _transform_drawio(self, absolute_path: Path, attrs: ImageAttributes) -> ET._Element:
+        "Emits Confluence Storage Format XHTML for a draw.io diagram."
+
+        if not absolute_path.name.endswith(".drawio.xml") and not absolute_path.name.endswith(".drawio"):
+            raise DocumentError("invalid image format; expected: `*.drawio.xml` or `*.drawio`")
+
+        if self.options.render_drawio:
+            image_data = drawio.render_diagram(absolute_path, self.options.diagram_output_format)
+            image_hash = hashlib.md5(image_data).hexdigest()
+            image_filename = attachment_name(f"embedded_{image_hash}.{self.options.diagram_output_format}")
+            self.embedded_images[image_filename] = image_data
+            return self._create_attached_image(image_filename, attrs)
+        else:
+            self.images.append(absolute_path)
+            image_filename = attachment_name(path_relative_to(absolute_path, self.base_dir))
+            return self._create_drawio(image_filename, attrs)
 
     def _transform_drawio_image(self, absolute_path: Path, attrs: ImageAttributes) -> ET._Element:
-        "Emits Confluence Storage Format XHTML for a draw.io image."
+        "Emits Confluence Storage Format XHTML for a draw.io diagram embedded in a PNG or SVG image."
 
         if not absolute_path.name.endswith(".drawio.png") and not absolute_path.name.endswith(".drawio.svg"):
             raise DocumentError("invalid image format; expected: `*.drawio.png` or `*.drawio.svg`")
@@ -663,17 +594,15 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
             return self._transform_attached_image(absolute_path, attrs)
         else:
             # extract embedded editable diagram and upload as *.drawio
-            image_data = extract_diagram(absolute_path)
+            image_data = drawio.extract_diagram(absolute_path)
             image_filename = attachment_name(path_relative_to(absolute_path.with_suffix(".xml"), self.base_dir))
             self.embedded_images[image_filename] = image_data
 
             return self._create_drawio(image_filename, attrs)
 
-    def _create_image(self, absolute_path: Path, attrs: ImageAttributes) -> ET._Element:
+    def _create_attached_image(self, image_name: str, attrs: ImageAttributes) -> ET._Element:
         "An image embedded into the page, linking to an attachment."
 
-        image_name = attachment_name(path_relative_to(absolute_path, self.base_dir))
-
         attributes: dict[str, Any] = {
             ET.QName(namespaces["ac"], "align"): "center",
             ET.QName(namespaces["ac"], "layout"): "center",
@@ -803,21 +732,11 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         "Transforms a Mermaid diagram code block."
 
         if self.options.render_mermaid:
-            image_data = render_diagram(content, self.options.diagram_output_format)
+            image_data = mermaid.render_diagram(content, self.options.diagram_output_format)
             image_hash = hashlib.md5(image_data).hexdigest()
             image_filename = attachment_name(f"embedded_{image_hash}.{self.options.diagram_output_format}")
             self.embedded_images[image_filename] = image_data
-            return AC(
-                "image",
-                {
-                    ET.QName(namespaces["ac"], "align"): "center",
-                    ET.QName(namespaces["ac"], "layout"): "center",
-                },
-                RI(
-                    "attachment",
-                    {ET.QName(namespaces["ri"], "filename"): image_filename},
-                ),
-            )
+            return self._create_attached_image(image_filename, ImageAttributes(None, None, None))
         else:
             local_id = str(uuid.uuid4())
             macro_id = str(uuid.uuid4())
@@ -1388,48 +1307,6 @@ class DocumentError(RuntimeError):
     "Raised when a converted Markdown document has an unexpected element or attribute."
 
 
-@dataclass
-class ConfluencePageID:
-    page_id: str
-
-
-@dataclass
-class ConfluenceQualifiedID:
-    page_id: str
-    space_key: str
-
-
-@dataclass
-class ConfluenceDocumentOptions:
-    """
-    Options that control the generated page content.
-
-    :param ignore_invalid_url: When true, ignore invalid URLs in input, emit a warning and replace the anchor with
-        plain text; when false, raise an exception.
-    :param heading_anchors: When true, emit a structured macro *anchor* for each section heading using GitHub
-        conversion rules for the identifier.
-    :param generated_by: Text to use as the generated-by prompt (or `None` to omit a prompt).
-    :param root_page_id: Confluence page to assume root page role for publishing a directory of Markdown files.
-    :param keep_hierarchy: Whether to maintain source directory structure when exporting to Confluence.
-    :param prefer_raster: Whether to choose PNG files over SVG files when available.
-    :param render_drawio: Whether to pre-render (or use the pre-rendered version of) draw.io diagrams.
-    :param render_mermaid: Whether to pre-render Mermaid diagrams into PNG/SVG images.
-    :param diagram_output_format: Target image format for diagrams.
-    :param webui_links: When true, convert relative URLs to Confluence Web UI links.
-    """
-
-    ignore_invalid_url: bool = False
-    heading_anchors: bool = False
-    generated_by: Optional[str] = "This page has been generated with a tool."
-    root_page_id: Optional[ConfluencePageID] = None
-    keep_hierarchy: bool = False
-    prefer_raster: bool = True
-    render_drawio: bool = False
-    render_mermaid: bool = False
-    diagram_output_format: Literal["png", "svg"] = "png"
-    webui_links: bool = False
-
-
 class ConversionError(RuntimeError):
     "Raised when a Markdown document cannot be converted to Confluence Storage Format."
 
@@ -1507,15 +1384,7 @@ class ConfluenceDocument:
             raise ConversionError(path) from ex
 
         converter = ConfluenceStorageFormatConverter(
-            ConfluenceConverterOptions(
-                ignore_invalid_url=self.options.ignore_invalid_url,
-                heading_anchors=self.options.heading_anchors,
-                prefer_raster=self.options.prefer_raster,
-                render_drawio=self.options.render_drawio,
-                render_mermaid=self.options.render_mermaid,
-                diagram_output_format=self.options.diagram_output_format,
-                webui_links=self.options.webui_links,
-            ),
+            ConfluenceConverterOptions(**{field.name: getattr(self.options, field.name) for field in dataclasses.fields(ConfluenceConverterOptions)}),
             path,
             root_dir,
             site_metadata,