markdown-to-confluence 0.4.7__tar.gz → 0.4.8__tar.gz

{markdown_to_confluence-0.4.7 → markdown_to_confluence-0.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-to-confluence
-Version: 0.4.7
+Version: 0.4.8
 Summary: Publish Markdown files to Confluence wiki
 Author-email: Levente Hunyadi <hunyadi@gmail.com>
 Maintainer-email: Levente Hunyadi <hunyadi@gmail.com>
@@ -26,20 +26,20 @@ License-File: LICENSE
 Requires-Dist: certifi>=2025.8.3; python_version < "3.10"
 Requires-Dist: json_strong_typing>=0.4
 Requires-Dist: lxml>=6.0
-Requires-Dist: markdown>=3.8
+Requires-Dist: markdown>=3.9
 Requires-Dist: pymdown-extensions>=10.16
 Requires-Dist: PyYAML>=6.0
 Requires-Dist: requests>=2.32
 Requires-Dist: truststore>=0.10; python_version >= "3.10"
-Requires-Dist: typing-extensions>=4.14; python_version < "3.12"
+Requires-Dist: typing-extensions>=4.15; python_version < "3.12"
 Provides-Extra: dev
-Requires-Dist: markdown_doc>=0.1.4; python_version >= "3.10" and extra == "dev"
-Requires-Dist: types-lxml>=2025.3.30; extra == "dev"
-Requires-Dist: types-markdown>=3.8; extra == "dev"
+Requires-Dist: markdown_doc>=0.1.5; python_version >= "3.10" and extra == "dev"
+Requires-Dist: types-lxml>=2025.8.25; extra == "dev"
+Requires-Dist: types-markdown>=3.9; extra == "dev"
 Requires-Dist: types-PyYAML>=6.0; extra == "dev"
 Requires-Dist: types-requests>=2.32; extra == "dev"
-Requires-Dist: mypy>=1.16; extra == "dev"
-Requires-Dist: ruff>=0.12; extra == "dev"
+Requires-Dist: mypy>=1.18; extra == "dev"
+Requires-Dist: ruff>=0.13; extra == "dev"
 Provides-Extra: formulas
 Requires-Dist: matplotlib>=3.9; extra == "formulas"
 Dynamic: license-file
@@ -425,9 +425,9 @@ Use the pseudo-language `csf` in a Markdown code block to pass content directly
 
 ### Ignoring files
 
-Skip files in a directory with rules defined in `.mdignore`. Each rule should occupy a single line. Rules follow the syntax (and constraints) of [fnmatch](https://docs.python.org/3/library/fnmatch.html#fnmatch.fnmatch). Specifically, `?` matches any single character, and `*` matches zero or more characters. For example, use `up-*.md` to exclude Markdown files that start with `up-`. Lines that start with `#` are treated as comments.
+Skip files and subdirectories in a directory with rules defined in `.mdignore`. Each rule should occupy a single line. Rules follow the syntax (and constraints) of [fnmatch](https://docs.python.org/3/library/fnmatch.html#fnmatch.fnmatch). Specifically, `?` matches any single character, and `*` matches zero or more characters. For example, use `up-*.md` to exclude Markdown files that start with `up-`. Lines that start with `#` are treated as comments.
 
-Files that don't have the extension `*.md` are skipped automatically. Hidden directories (whose name starts with `.`) are not recursed into.
+Files that don't have the extension `*.md` are skipped automatically. Hidden directories (whose name starts with `.`) are not recursed into. To skip an entire directory, add the name of the directory without a trailing `/`.
 
 Relative paths to items in a nested directory are not supported. You must put `.mdignore` in the same directory where the items to be skipped reside.
 
@@ -501,7 +501,7 @@ You can add [Mermaid diagrams](https://mermaid.js.org/) to your Markdown documen
 
 *md2conf* offers two options to publish the diagram:
 
-1. Pre-render into an image (command-line option `--render-mermaid`). The source file or code block is interpreted by and converted into a PNG or SVG image with the Mermaid diagram utility [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). The generated image is then uploaded to Confluence as an attachment to the page. This is the approach we use and support.
+1. Pre-render into an image (command-line option `--render-mermaid`). The source file or code block is interpreted by and converted into a PNG or SVG image with the Mermaid diagram utility [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). The generated image is then uploaded to Confluence as an attachment to the page.
 2. Display on demand (command-line option `--no-render-mermaid`). The code block is transformed into a [diagram macro](https://stratus-addons.atlassian.net/wiki/spaces/MDFC/overview), which is processed by Confluence. You need a separate [marketplace app](https://marketplace.atlassian.com/apps/1226567/mermaid-diagrams-for-confluence) to turn macro definitions into images when a Confluence page is visited.
 
 If you are running into issues with the pre-rendering approach (e.g. misaligned labels in the generated image), verify if `mermaid-cli` can process the Mermaid source:
@@ -512,6 +512,14 @@ mmdc -i sample.mmd -o sample.png -b transparent --scale 2
 
 Ensure that `mermaid-cli` is set up, refer to *Installation* for instructions.
 
+Note that `mermaid-cli` has some implicit dependencies (e.g. a headless browser) that may not be immediately available in a CI/CD environment such as GitHub Actions. Refer to the `Dockerfile` in the *md2conf* project root, or [mermaid-cli documentation](https://github.com/mermaid-js/mermaid-cli) on how to install these dependencies such as a `chromium-browser` and various fonts.
+
+### Alignment
+
+You can configure diagram and image alignment using the JSON/YAML front-matter attribute `alignment` or the command-line argument of the same name. Possible values are `center` (default), `left` and `right`. The value configured in the Markdown file front-matter takes precedence.
+
+Unfortunately, not every third-party app supports every alignment variant. For example, the draw\.io marketplace app supports left and center but not right alignment; and diagrams produced by the Mermaid marketplace app are always centered, ignoring the setting for alignment.
+
 ### Links to attachments
 
 If *md2conf* encounters a Markdown link that points to a file in the directory hierarchy being synchronized, it automatically uploads the file as an attachment to the Confluence page. Activating the link in Confluence downloads the file. Typical examples include PDFs (`*.pdf`), word processor documents (`*.docx`), spreadsheets (`*.xlsx`), plain text files (`*.txt`) or logs (`*.log`). The MIME type is set based on the file type.
@@ -586,6 +594,12 @@ options:
   --use-panel           Transform admonitions and alerts into a Confluence custom panel.
 ```
 
+### Confluence REST API v1 vs. v2
+
+*md2conf* version 0.3.0 has switched to using [Confluence REST API v2](https://developer.atlassian.com/cloud/confluence/rest/v2/) for API calls such as retrieving current page content. Earlier versions used [Confluence REST API v1](https://developer.atlassian.com/cloud/confluence/rest/v1/) exclusively. Unfortunately, Atlassian has decommissioned Confluence REST API v1 for several endpoints in Confluence Cloud as of due date March 31, 2025, and we don't have access to an environment where we could test retired v1 endpoints.
+
+If you are restricted to an environment with Confluence REST API v1, we recommend *md2conf* [version 0.2.7](https://pypi.org/project/markdown-to-confluence/0.2.7/). Even though we don't actively support it, we are not aware of any major issues, making it a viable option in an on-premise environment with only Confluence REST API v1 support.
+
 ### Using the Docker container
 
 You can run the Docker container via `docker run` or via `Dockerfile`. Either can accept the environment variables or arguments similar to the Python options. The final argument `./` corresponds to `mdpath` in the command-line utility.

markdown_to_confluence-0.4.7/markdown_to_confluence.egg-info/PKG-INFO → markdown_to_confluence-0.4.8/README.md

@@ -1,49 +1,3 @@
-Metadata-Version: 2.4
-Name: markdown-to-confluence
-Version: 0.4.7
-Summary: Publish Markdown files to Confluence wiki
-Author-email: Levente Hunyadi <hunyadi@gmail.com>
-Maintainer-email: Levente Hunyadi <hunyadi@gmail.com>
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/hunyadi/md2conf
-Project-URL: Source, https://github.com/hunyadi/md2conf
-Keywords: markdown,converter,confluence
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Environment :: Console
-Classifier: Intended Audience :: End Users/Desktop
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Typing :: Typed
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: certifi>=2025.8.3; python_version < "3.10"
-Requires-Dist: json_strong_typing>=0.4
-Requires-Dist: lxml>=6.0
-Requires-Dist: markdown>=3.8
-Requires-Dist: pymdown-extensions>=10.16
-Requires-Dist: PyYAML>=6.0
-Requires-Dist: requests>=2.32
-Requires-Dist: truststore>=0.10; python_version >= "3.10"
-Requires-Dist: typing-extensions>=4.14; python_version < "3.12"
-Provides-Extra: dev
-Requires-Dist: markdown_doc>=0.1.4; python_version >= "3.10" and extra == "dev"
-Requires-Dist: types-lxml>=2025.3.30; extra == "dev"
-Requires-Dist: types-markdown>=3.8; extra == "dev"
-Requires-Dist: types-PyYAML>=6.0; extra == "dev"
-Requires-Dist: types-requests>=2.32; extra == "dev"
-Requires-Dist: mypy>=1.16; extra == "dev"
-Requires-Dist: ruff>=0.12; extra == "dev"
-Provides-Extra: formulas
-Requires-Dist: matplotlib>=3.9; extra == "formulas"
-Dynamic: license-file
-
 # Publish Markdown files to Confluence wiki
 
 Contributors to software projects typically write documentation in Markdown format and host Markdown files in collaborative version control systems (VCS) such as GitHub or GitLab to track changes and facilitate the review process. However, not everyone at a company has access to VCS, and documents are often circulated in Confluence wiki instead.
@@ -425,9 +379,9 @@ Use the pseudo-language `csf` in a Markdown code block to pass content directly
 
 ### Ignoring files
 
-Skip files in a directory with rules defined in `.mdignore`. Each rule should occupy a single line. Rules follow the syntax (and constraints) of [fnmatch](https://docs.python.org/3/library/fnmatch.html#fnmatch.fnmatch). Specifically, `?` matches any single character, and `*` matches zero or more characters. For example, use `up-*.md` to exclude Markdown files that start with `up-`. Lines that start with `#` are treated as comments.
+Skip files and subdirectories in a directory with rules defined in `.mdignore`. Each rule should occupy a single line. Rules follow the syntax (and constraints) of [fnmatch](https://docs.python.org/3/library/fnmatch.html#fnmatch.fnmatch). Specifically, `?` matches any single character, and `*` matches zero or more characters. For example, use `up-*.md` to exclude Markdown files that start with `up-`. Lines that start with `#` are treated as comments.
 
-Files that don't have the extension `*.md` are skipped automatically. Hidden directories (whose name starts with `.`) are not recursed into.
+Files that don't have the extension `*.md` are skipped automatically. Hidden directories (whose name starts with `.`) are not recursed into. To skip an entire directory, add the name of the directory without a trailing `/`.
 
 Relative paths to items in a nested directory are not supported. You must put `.mdignore` in the same directory where the items to be skipped reside.
 
@@ -501,7 +455,7 @@ You can add [Mermaid diagrams](https://mermaid.js.org/) to your Markdown documen
 
 *md2conf* offers two options to publish the diagram:
 
-1. Pre-render into an image (command-line option `--render-mermaid`). The source file or code block is interpreted by and converted into a PNG or SVG image with the Mermaid diagram utility [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). The generated image is then uploaded to Confluence as an attachment to the page. This is the approach we use and support.
+1. Pre-render into an image (command-line option `--render-mermaid`). The source file or code block is interpreted by and converted into a PNG or SVG image with the Mermaid diagram utility [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). The generated image is then uploaded to Confluence as an attachment to the page.
 2. Display on demand (command-line option `--no-render-mermaid`). The code block is transformed into a [diagram macro](https://stratus-addons.atlassian.net/wiki/spaces/MDFC/overview), which is processed by Confluence. You need a separate [marketplace app](https://marketplace.atlassian.com/apps/1226567/mermaid-diagrams-for-confluence) to turn macro definitions into images when a Confluence page is visited.
 
 If you are running into issues with the pre-rendering approach (e.g. misaligned labels in the generated image), verify if `mermaid-cli` can process the Mermaid source:
@@ -512,6 +466,14 @@ mmdc -i sample.mmd -o sample.png -b transparent --scale 2
 
 Ensure that `mermaid-cli` is set up, refer to *Installation* for instructions.
 
+Note that `mermaid-cli` has some implicit dependencies (e.g. a headless browser) that may not be immediately available in a CI/CD environment such as GitHub Actions. Refer to the `Dockerfile` in the *md2conf* project root, or [mermaid-cli documentation](https://github.com/mermaid-js/mermaid-cli) on how to install these dependencies such as a `chromium-browser` and various fonts.
+
+### Alignment
+
+You can configure diagram and image alignment using the JSON/YAML front-matter attribute `alignment` or the command-line argument of the same name. Possible values are `center` (default), `left` and `right`. The value configured in the Markdown file front-matter takes precedence.
+
+Unfortunately, not every third-party app supports every alignment variant. For example, the draw\.io marketplace app supports left and center but not right alignment; and diagrams produced by the Mermaid marketplace app are always centered, ignoring the setting for alignment.
+
 ### Links to attachments
 
 If *md2conf* encounters a Markdown link that points to a file in the directory hierarchy being synchronized, it automatically uploads the file as an attachment to the Confluence page. Activating the link in Confluence downloads the file. Typical examples include PDFs (`*.pdf`), word processor documents (`*.docx`), spreadsheets (`*.xlsx`), plain text files (`*.txt`) or logs (`*.log`). The MIME type is set based on the file type.
@@ -586,6 +548,12 @@ options:
   --use-panel           Transform admonitions and alerts into a Confluence custom panel.
 ```
 
+### Confluence REST API v1 vs. v2
+
+*md2conf* version 0.3.0 has switched to using [Confluence REST API v2](https://developer.atlassian.com/cloud/confluence/rest/v2/) for API calls such as retrieving current page content. Earlier versions used [Confluence REST API v1](https://developer.atlassian.com/cloud/confluence/rest/v1/) exclusively. Unfortunately, Atlassian has decommissioned Confluence REST API v1 for several endpoints in Confluence Cloud as of due date March 31, 2025, and we don't have access to an environment where we could test retired v1 endpoints.
+
+If you are restricted to an environment with Confluence REST API v1, we recommend *md2conf* [version 0.2.7](https://pypi.org/project/markdown-to-confluence/0.2.7/). Even though we don't actively support it, we are not aware of any major issues, making it a viable option in an on-premise environment with only Confluence REST API v1 support.
+
 ### Using the Docker container
 
 You can run the Docker container via `docker run` or via `Dockerfile`. Either can accept the environment variables or arguments similar to the Python options. The final argument `./` corresponds to `mdpath` in the command-line utility.

markdown_to_confluence-0.4.7/README.md → markdown_to_confluence-0.4.8/markdown_to_confluence.egg-info/PKG-INFO

@@ -1,3 +1,49 @@
+Metadata-Version: 2.4
+Name: markdown-to-confluence
+Version: 0.4.8
+Summary: Publish Markdown files to Confluence wiki
+Author-email: Levente Hunyadi <hunyadi@gmail.com>
+Maintainer-email: Levente Hunyadi <hunyadi@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/hunyadi/md2conf
+Project-URL: Source, https://github.com/hunyadi/md2conf
+Keywords: markdown,converter,confluence
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: certifi>=2025.8.3; python_version < "3.10"
+Requires-Dist: json_strong_typing>=0.4
+Requires-Dist: lxml>=6.0
+Requires-Dist: markdown>=3.9
+Requires-Dist: pymdown-extensions>=10.16
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: requests>=2.32
+Requires-Dist: truststore>=0.10; python_version >= "3.10"
+Requires-Dist: typing-extensions>=4.15; python_version < "3.12"
+Provides-Extra: dev
+Requires-Dist: markdown_doc>=0.1.5; python_version >= "3.10" and extra == "dev"
+Requires-Dist: types-lxml>=2025.8.25; extra == "dev"
+Requires-Dist: types-markdown>=3.9; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0; extra == "dev"
+Requires-Dist: types-requests>=2.32; extra == "dev"
+Requires-Dist: mypy>=1.18; extra == "dev"
+Requires-Dist: ruff>=0.13; extra == "dev"
+Provides-Extra: formulas
+Requires-Dist: matplotlib>=3.9; extra == "formulas"
+Dynamic: license-file
+
 # Publish Markdown files to Confluence wiki
 
 Contributors to software projects typically write documentation in Markdown format and host Markdown files in collaborative version control systems (VCS) such as GitHub or GitLab to track changes and facilitate the review process. However, not everyone at a company has access to VCS, and documents are often circulated in Confluence wiki instead.
@@ -379,9 +425,9 @@ Use the pseudo-language `csf` in a Markdown code block to pass content directly
 
 ### Ignoring files
 
-Skip files in a directory with rules defined in `.mdignore`. Each rule should occupy a single line. Rules follow the syntax (and constraints) of [fnmatch](https://docs.python.org/3/library/fnmatch.html#fnmatch.fnmatch). Specifically, `?` matches any single character, and `*` matches zero or more characters. For example, use `up-*.md` to exclude Markdown files that start with `up-`. Lines that start with `#` are treated as comments.
+Skip files and subdirectories in a directory with rules defined in `.mdignore`. Each rule should occupy a single line. Rules follow the syntax (and constraints) of [fnmatch](https://docs.python.org/3/library/fnmatch.html#fnmatch.fnmatch). Specifically, `?` matches any single character, and `*` matches zero or more characters. For example, use `up-*.md` to exclude Markdown files that start with `up-`. Lines that start with `#` are treated as comments.
 
-Files that don't have the extension `*.md` are skipped automatically. Hidden directories (whose name starts with `.`) are not recursed into.
+Files that don't have the extension `*.md` are skipped automatically. Hidden directories (whose name starts with `.`) are not recursed into. To skip an entire directory, add the name of the directory without a trailing `/`.
 
 Relative paths to items in a nested directory are not supported. You must put `.mdignore` in the same directory where the items to be skipped reside.
 
@@ -455,7 +501,7 @@ You can add [Mermaid diagrams](https://mermaid.js.org/) to your Markdown documen
 
 *md2conf* offers two options to publish the diagram:
 
-1. Pre-render into an image (command-line option `--render-mermaid`). The source file or code block is interpreted by and converted into a PNG or SVG image with the Mermaid diagram utility [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). The generated image is then uploaded to Confluence as an attachment to the page. This is the approach we use and support.
+1. Pre-render into an image (command-line option `--render-mermaid`). The source file or code block is interpreted by and converted into a PNG or SVG image with the Mermaid diagram utility [mermaid-cli](https://github.com/mermaid-js/mermaid-cli). The generated image is then uploaded to Confluence as an attachment to the page.
 2. Display on demand (command-line option `--no-render-mermaid`). The code block is transformed into a [diagram macro](https://stratus-addons.atlassian.net/wiki/spaces/MDFC/overview), which is processed by Confluence. You need a separate [marketplace app](https://marketplace.atlassian.com/apps/1226567/mermaid-diagrams-for-confluence) to turn macro definitions into images when a Confluence page is visited.
 
 If you are running into issues with the pre-rendering approach (e.g. misaligned labels in the generated image), verify if `mermaid-cli` can process the Mermaid source:
@@ -466,6 +512,14 @@ mmdc -i sample.mmd -o sample.png -b transparent --scale 2
 
 Ensure that `mermaid-cli` is set up, refer to *Installation* for instructions.
 
+Note that `mermaid-cli` has some implicit dependencies (e.g. a headless browser) that may not be immediately available in a CI/CD environment such as GitHub Actions. Refer to the `Dockerfile` in the *md2conf* project root, or [mermaid-cli documentation](https://github.com/mermaid-js/mermaid-cli) on how to install these dependencies such as a `chromium-browser` and various fonts.
+
+### Alignment
+
+You can configure diagram and image alignment using the JSON/YAML front-matter attribute `alignment` or the command-line argument of the same name. Possible values are `center` (default), `left` and `right`. The value configured in the Markdown file front-matter takes precedence.
+
+Unfortunately, not every third-party app supports every alignment variant. For example, the draw\.io marketplace app supports left and center but not right alignment; and diagrams produced by the Mermaid marketplace app are always centered, ignoring the setting for alignment.
+
 ### Links to attachments
 
 If *md2conf* encounters a Markdown link that points to a file in the directory hierarchy being synchronized, it automatically uploads the file as an attachment to the Confluence page. Activating the link in Confluence downloads the file. Typical examples include PDFs (`*.pdf`), word processor documents (`*.docx`), spreadsheets (`*.xlsx`), plain text files (`*.txt`) or logs (`*.log`). The MIME type is set based on the file type.
@@ -540,6 +594,12 @@ options:
   --use-panel           Transform admonitions and alerts into a Confluence custom panel.
 ```
 
+### Confluence REST API v1 vs. v2
+
+*md2conf* version 0.3.0 has switched to using [Confluence REST API v2](https://developer.atlassian.com/cloud/confluence/rest/v2/) for API calls such as retrieving current page content. Earlier versions used [Confluence REST API v1](https://developer.atlassian.com/cloud/confluence/rest/v1/) exclusively. Unfortunately, Atlassian has decommissioned Confluence REST API v1 for several endpoints in Confluence Cloud as of due date March 31, 2025, and we don't have access to an environment where we could test retired v1 endpoints.
+
+If you are restricted to an environment with Confluence REST API v1, we recommend *md2conf* [version 0.2.7](https://pypi.org/project/markdown-to-confluence/0.2.7/). Even though we don't actively support it, we are not aware of any major issues, making it a viable option in an on-premise environment with only Confluence REST API v1 support.
+
 ### Using the Docker container
 
 You can run the Docker container via `docker run` or via `Dockerfile`. Either can accept the environment variables or arguments similar to the Python options. The final argument `./` corresponds to `mdpath` in the command-line utility.

{markdown_to_confluence-0.4.7 → markdown_to_confluence-0.4.8}/markdown_to_confluence.egg-info/requires.txt

@@ -1,6 +1,6 @@
 json_strong_typing>=0.4
 lxml>=6.0
-markdown>=3.8
+markdown>=3.9
 pymdown-extensions>=10.16
 PyYAML>=6.0
 requests>=2.32
@@ -9,21 +9,21 @@ requests>=2.32
 certifi>=2025.8.3
 
 [:python_version < "3.12"]
-typing-extensions>=4.14
+typing-extensions>=4.15
 
 [:python_version >= "3.10"]
 truststore>=0.10
 
 [dev]
-types-lxml>=2025.3.30
-types-markdown>=3.8
+types-lxml>=2025.8.25
+types-markdown>=3.9
 types-PyYAML>=6.0
 types-requests>=2.32
-mypy>=1.16
-ruff>=0.12
+mypy>=1.18
+ruff>=0.13
 
 [dev:python_version >= "3.10"]
-markdown_doc>=0.1.4
+markdown_doc>=0.1.5
 
 [formulas]
 matplotlib>=3.9

{markdown_to_confluence-0.4.7 → markdown_to_confluence-0.4.8}/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.7"
+__version__ = "0.4.8"
 __author__ = "Levente Hunyadi"
 __copyright__ = "Copyright 2022-2025, Levente Hunyadi"
 __license__ = "MIT"

{markdown_to_confluence-0.4.7 → markdown_to_confluence-0.4.8}/md2conf/converter.py

@@ -405,18 +405,18 @@ class ConfluencePanel:
 
 
 ConfluencePanel.from_class = {
-    "attention": ConfluencePanel("❗", "exclamation", "#F9F9F9"),  # rST admonition
-    "caution": ConfluencePanel("❌", "x", "#FFEBE9"),
-    "danger": ConfluencePanel("☠️", "skull_crossbones", "#FFE5E5"),  # rST admonition
-    "disclaimer": ConfluencePanel("❗", "exclamation", "#F9F9F9"),  # GitLab
-    "error": ConfluencePanel("❌", "x", "#FFEBE9"),  # rST admonition
-    "flag": ConfluencePanel("🚩", "triangular_flag_on_post", "#FDECEA"),  # GitLab
-    "hint": ConfluencePanel("💡", "bulb", "#DAFBE1"),  # rST admonition
-    "info": ConfluencePanel("ℹ️", "information_source", "#DDF4FF"),
-    "note": ConfluencePanel("📝", "pencil", "#DDF4FF"),
-    "tip": ConfluencePanel("💡", "bulb", "#DAFBE1"),
-    "important": ConfluencePanel("❗", "exclamation", "#FBEFFF"),
-    "warning": ConfluencePanel("⚠️", "warning", "#FFF8C5"),
+    "attention": ConfluencePanel("❗", "exclamation", "var(--ds-background-accent-gray-subtlest)"),  # rST admonition
+    "caution": ConfluencePanel("❌", "x", "var(--ds-background-accent-orange-subtlest)"),
+    "danger": ConfluencePanel("☠️", "skull_crossbones", "var(--ds-background-accent-red-subtlest)"),  # rST admonition
+    "disclaimer": ConfluencePanel("❗", "exclamation", "var(--ds-background-accent-gray-subtlest)"),  # GitLab
+    "error": ConfluencePanel("❌", "x", "var(--ds-background-accent-red-subtlest)"),  # rST admonition
+    "flag": ConfluencePanel("🚩", "triangular_flag_on_post", "var(--ds-background-accent-orange-subtlest"),  # GitLab
+    "hint": ConfluencePanel("💡", "bulb", "var(--ds-background-accent-green-subtlest)"),  # rST admonition
+    "info": ConfluencePanel("ℹ️", "information_source", "var(--ds-background-accent-blue-subtlest)"),
+    "note": ConfluencePanel("📝", "pencil", "var(--ds-background-accent-teal-subtlest)"),
+    "tip": ConfluencePanel("💡", "bulb", "var(--ds-background-accent-green-subtlest)"),
+    "important": ConfluencePanel("❗", "exclamation", "var(--ds-background-accent-purple-subtlest)"),
+    "warning": ConfluencePanel("⚠️", "warning", "var(--ds-background-accent-yellow-subtlest)"),
 }
 
 
@@ -817,6 +817,14 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
                     str(attrs.height),
                 ),
             )
+        if attrs.alignment is ImageAlignment.CENTER:
+            parameters.append(
+                AC_ELEM(
+                    "parameter",
+                    {AC_ATTR("name"): "pCenter"},
+                    str(1),
+                ),
+            )
 
         local_id = str(uuid.uuid4())
         macro_id = str(uuid.uuid4())
@@ -1650,7 +1658,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         #   <li>[x] ...</li>
         # </ul>
         elif child.tag == "ul":
-            if len(child) > 0 and element_text_starts_with_any(child[0], ["[ ]", "[x]", "[X]"]):
+            if len(child) > 0 and all(element_text_starts_with_any(item, ["[ ]", "[x]", "[X]"]) for item in child):
                 return self._transform_tasklist(child)
 
             return None

{markdown_to_confluence-0.4.7 → markdown_to_confluence-0.4.8}/pyproject.toml

@@ -33,24 +33,24 @@ dependencies = [
     "certifi >= 2025.8.3; python_version<'3.10'",
     "json_strong_typing >= 0.4",
     "lxml >= 6.0",
-    "markdown >= 3.8",
+    "markdown >= 3.9",
     "pymdown-extensions >= 10.16",
     "PyYAML >= 6.0",
     "requests >= 2.32",
     "truststore >= 0.10; python_version>='3.10'",
-    "typing-extensions >= 4.14; python_version < '3.12'"
+    "typing-extensions >= 4.15; python_version < '3.12'"
 ]
 dynamic = ["version"]
 
 [project.optional-dependencies]
 dev = [
-    "markdown_doc >= 0.1.4; python_version >= '3.10'",
-    "types-lxml >= 2025.3.30",
-    "types-markdown >= 3.8",
+    "markdown_doc >= 0.1.5; python_version >= '3.10'",
+    "types-lxml >= 2025.8.25",
+    "types-markdown >= 3.9",
     "types-PyYAML >= 6.0",
     "types-requests >= 2.32",
-    "mypy >= 1.16",
-    "ruff >= 0.12"
+    "mypy >= 1.18",
+    "ruff >= 0.13"
 ]
 formulas = [
     "matplotlib >= 3.9"

markdown_to_confluence-0.4.8/tests/source/tasklist.md

@@ -0,0 +1,19 @@
+<!-- confluence-page-id: 00000000000 -->
+
+## Tasklist
+
+### Examples
+
+- [x] **Finished** action
+- [ ] **Unfinished** action
+
+### Counter-examples
+
+- first item is not a task
+- [x] **finished** action
+- [ ] **unfinished** action
+
+<!-- separates consecutive lists -->
+- [x] **finished** action
+- [ ] **unfinished** action
+- last item is not a task

{markdown_to_confluence-0.4.7 → markdown_to_confluence-0.4.8}/tests/target/panel.xml

@@ -8,7 +8,7 @@
   <ac:parameter ac:name="panelIcon">:information_source:</ac:parameter>
   <ac:parameter ac:name="panelIconId">2139-fe0f</ac:parameter>
   <ac:parameter ac:name="panelIconText">ℹ️</ac:parameter>
-  <ac:parameter ac:name="bgColor">#DDF4FF</ac:parameter>
+  <ac:parameter ac:name="bgColor">var(--ds-background-accent-blue-subtlest)</ac:parameter>
   <ac:rich-text-body>
     <p><strong>Info</strong></p>
     <p>This is an information panel.</p>
@@ -18,7 +18,7 @@
   <ac:parameter ac:name="panelIcon">:information_source:</ac:parameter>
   <ac:parameter ac:name="panelIconId">2139-fe0f</ac:parameter>
   <ac:parameter ac:name="panelIconText">ℹ️</ac:parameter>
-  <ac:parameter ac:name="bgColor">#DDF4FF</ac:parameter>
+  <ac:parameter ac:name="bgColor">var(--ds-background-accent-blue-subtlest)</ac:parameter>
   <ac:rich-text-body>
     <p><strong>Optional explicit title</strong></p>
     <p>This is an information panel with an explicit title.</p>
@@ -29,7 +29,7 @@
   <ac:parameter ac:name="panelIcon">:bulb:</ac:parameter>
   <ac:parameter ac:name="panelIconId">1f4a1</ac:parameter>
   <ac:parameter ac:name="panelIconText">💡</ac:parameter>
-  <ac:parameter ac:name="bgColor">#DAFBE1</ac:parameter>
+  <ac:parameter ac:name="bgColor">var(--ds-background-accent-green-subtlest)</ac:parameter>
   <ac:rich-text-body>
     <p><strong>Tip of the day</strong></p>
     <p>This is a structured macro panel showing a tip.</p>
@@ -39,7 +39,7 @@
   <ac:parameter ac:name="panelIcon">:pencil:</ac:parameter>
   <ac:parameter ac:name="panelIconId">1f4dd</ac:parameter>
   <ac:parameter ac:name="panelIconText">📝</ac:parameter>
-  <ac:parameter ac:name="bgColor">#DDF4FF</ac:parameter>
+  <ac:parameter ac:name="bgColor">var(--ds-background-accent-teal-subtlest)</ac:parameter>
   <ac:rich-text-body>
     <p><strong>A note</strong></p>
     <p>This is a structured macro panel showing a note.</p>
@@ -48,7 +48,7 @@
   <ac:parameter ac:name="panelIcon">:warning:</ac:parameter>
   <ac:parameter ac:name="panelIconId">26a0-fe0f</ac:parameter>
   <ac:parameter ac:name="panelIconText">⚠️</ac:parameter>
-  <ac:parameter ac:name="bgColor">#FFF8C5</ac:parameter>
+  <ac:parameter ac:name="bgColor">var(--ds-background-accent-yellow-subtlest)</ac:parameter>
   <ac:rich-text-body>
     <p><strong>A warning message</strong></p>
     <p>This is a structured macro panel showing a warning.</p>
@@ -57,7 +57,7 @@
   <ac:parameter ac:name="panelIcon">:exclamation:</ac:parameter>
   <ac:parameter ac:name="panelIconId">2757</ac:parameter>
   <ac:parameter ac:name="panelIconText">❗</ac:parameter>
-  <ac:parameter ac:name="bgColor">#F9F9F9</ac:parameter>
+  <ac:parameter ac:name="bgColor">var(--ds-background-accent-gray-subtlest)</ac:parameter>
   <ac:rich-text-body>
     <p><strong>Attention</strong></p>
     <p>This is a structured macro panel defined in rST syntax.</p>
@@ -66,7 +66,7 @@
   <ac:parameter ac:name="panelIcon">:x:</ac:parameter>
   <ac:parameter ac:name="panelIconId">274c</ac:parameter>
   <ac:parameter ac:name="panelIconText">❌</ac:parameter>
-  <ac:parameter ac:name="bgColor">#FFEBE9</ac:parameter>
+  <ac:parameter ac:name="bgColor">var(--ds-background-accent-orange-subtlest)</ac:parameter>
   <ac:rich-text-body>
     <p><strong>Caution</strong></p>
     <p>This is a structured macro panel defined in rST syntax.</p>
@@ -75,7 +75,7 @@
   <ac:parameter ac:name="panelIcon">:skull_crossbones:</ac:parameter>
   <ac:parameter ac:name="panelIconId">2620-fe0f</ac:parameter>
   <ac:parameter ac:name="panelIconText">☠️</ac:parameter>
-  <ac:parameter ac:name="bgColor">#FFE5E5</ac:parameter>
+  <ac:parameter ac:name="bgColor">var(--ds-background-accent-red-subtlest)</ac:parameter>
   <ac:rich-text-body>
     <p><strong>Danger</strong></p>
     <p>This is a structured macro panel defined in rST syntax.</p>
@@ -84,7 +84,7 @@
   <ac:parameter ac:name="panelIcon">:x:</ac:parameter>
   <ac:parameter ac:name="panelIconId">274c</ac:parameter>
   <ac:parameter ac:name="panelIconText">❌</ac:parameter>
-  <ac:parameter ac:name="bgColor">#FFEBE9</ac:parameter>
+  <ac:parameter ac:name="bgColor">var(--ds-background-accent-red-subtlest)</ac:parameter>
   <ac:rich-text-body>
     <p><strong>Error</strong></p>
     <p>This is a structured macro panel defined in rST syntax.</p>
@@ -94,7 +94,7 @@
   <ac:parameter ac:name="panelIcon">:bulb:</ac:parameter>
   <ac:parameter ac:name="panelIconId">1f4a1</ac:parameter>
   <ac:parameter ac:name="panelIconText">💡</ac:parameter>
-  <ac:parameter ac:name="bgColor">#DAFBE1</ac:parameter>
+  <ac:parameter ac:name="bgColor">var(--ds-background-accent-green-subtlest)</ac:parameter>
   <ac:rich-text-body>
     <p><strong>Hint</strong></p>
     <p>This is a structured macro panel defined in rST syntax.</p>
@@ -104,7 +104,7 @@
   <ac:parameter ac:name="panelIcon">:exclamation:</ac:parameter>
   <ac:parameter ac:name="panelIconId">2757</ac:parameter>
   <ac:parameter ac:name="panelIconText">❗</ac:parameter>
-  <ac:parameter ac:name="bgColor">#FBEFFF</ac:parameter>
+  <ac:parameter ac:name="bgColor">var(--ds-background-accent-purple-subtlest)</ac:parameter>
   <ac:rich-text-body>
     <p><strong>Important</strong></p>
     <p>This is a structured macro panel defined in rST syntax.</p>

{markdown_to_confluence-0.4.7 → markdown_to_confluence-0.4.8}/tests/target/tasklist.xml

@@ -4,6 +4,7 @@
   </ac:rich-text-body>
 </ac:structured-macro>
 <h2>Tasklist</h2>
+<h3>Examples</h3>
 <ac:task-list>
   <ac:task>
     <ac:task-id>1</ac:task-id>
@@ -18,3 +19,14 @@
     <ac:task-body><strong>Unfinished</strong> action</ac:task-body>
   </ac:task>
 </ac:task-list>
+<h3>Counter-examples</h3>
+<ul>
+  <li><p>first item is not a task</p></li>
+  <li><p>[x] <strong>finished</strong> action</p></li>
+  <li><p>[ ] <strong>unfinished</strong> action</p></li>
+</ul>
+<ul>
+  <li><p>[x] <strong>finished</strong> action</p></li>
+  <li><p>[ ] <strong>unfinished</strong> action</p></li>
+  <li><p>last item is not a task</p></li>
+</ul>

{markdown_to_confluence-0.4.7 → markdown_to_confluence-0.4.8}/tests/test_matcher.py

@@ -63,6 +63,7 @@ class TestMatcher(TypedTestCase):
     def test_rules(self) -> None:
         directory = Path(os.path.dirname(__file__)) / "source"
         expected = sorted(Entry(entry.name, entry.is_dir()) for entry in os.scandir(directory) if entry.is_dir() or entry.name.endswith(".md"))
+        expected.remove(Entry("docs", True))
         expected.remove(Entry("ignore.md", False))
         expected.remove(Entry("anchors.md", False))
         expected.remove(Entry("missing.md", False))

{markdown_to_confluence-0.4.7 → markdown_to_confluence-0.4.8}/tests/test_mermaid.py

@@ -8,11 +8,9 @@ Copyright 2022-2025, Levente Hunyadi
 
 import logging
 import os
-import shutil
 import unittest
-from pathlib import Path
+import xml.etree.ElementTree as ET
 
-from md2conf.extra import override
 from md2conf.mermaid import has_mmdc, render_diagram
 from tests.utility import TypedTestCase
 
@@ -32,29 +30,10 @@ graph TD
 @unittest.skipUnless(has_mmdc(), "mmdc is not available")
 @unittest.skipUnless(os.getenv("TEST_MERMAID"), "mermaid tests are disabled")
 class TestMermaidRendering(TypedTestCase):
-    out_dir: Path
-
-    @override
-    def setUp(self) -> None:
-        self.maxDiff = 1024
-
-        test_dir = Path(__file__).parent
-        parent_dir = test_dir.parent
-
-        self.out_dir = test_dir / "output"
-        self.sample_dir = parent_dir / "sample"
-        os.makedirs(self.out_dir, exist_ok=True)
-
-    @override
-    def tearDown(self) -> None:
-        shutil.rmtree(self.out_dir)
-
     def test_render_simple_svg(self) -> None:
-        svg = render_diagram(MERMAID_SOURCE, output_format="svg").decode()
-
-        self.assertIn("transform=", svg)
-        self.assertIn("translate(", svg)
-        self.assertIn("<rect height=", svg)
+        svg = render_diagram(MERMAID_SOURCE, output_format="svg")
+        root = ET.fromstring(svg)
+        self.assertTrue(root.tag.lower() == "svg" or root.tag.endswith("}svg"))
 
     def test_render_simple_png(self) -> None:
         png = render_diagram(MERMAID_SOURCE)

markdown_to_confluence-0.4.7/tests/source/tasklist.md

@@ -1,6 +0,0 @@
-<!-- confluence-page-id: 00000000000 -->
-
-## Tasklist
-
-- [x] **Finished** action
-- [ ] **Unfinished** action