markdown-to-confluence 0.1.12__tar.gz → 0.2.0__tar.gz

{markdown_to_confluence-0.1.12 → markdown_to_confluence-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: markdown-to-confluence
-Version: 0.1.12
+Version: 0.2.0
 Summary: Publish Markdown files to Confluence wiki
 Home-page: https://github.com/hunyadi/md2conf
 Author: Levente Hunyadi
@@ -21,11 +21,11 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: lxml>=5.2
-Requires-Dist: types-lxml>=2024.4.14
+Requires-Dist: lxml>=5.3
+Requires-Dist: types-lxml>=2024.8.7
 Requires-Dist: markdown>=3.6
 Requires-Dist: types-markdown>=3.6
-Requires-Dist: pymdown-extensions>=10.8
+Requires-Dist: pymdown-extensions>=10.9
 Requires-Dist: requests>=2.32
 Requires-Dist: types-requests>=2.32
 
@@ -45,12 +45,29 @@ This Python package
 
 * Sections and subsections
 * Text with **bold**, *italic*, `monospace`, <ins>underline</ins> and ~~strikethrough~~
-* Link to [external locations](http://example.com/)
+* Link to [sections on the same page](#getting-started) or [external locations](http://example.com/)
 * Ordered and unordered lists
 * Code blocks (e.g. Python, JSON, XML)
 * Image references (uploaded as Confluence page attachments)
-* [Table of Contents](https://docs.gitlab.com/ee/user/markdown.html#table-of-contents)
-* [Admonitions](https://python-markdown.github.io/extensions/admonition/) (converted into *info*, *tip*, *note* and *warning* Confluence panels)
+* Tables
+* [Table of contents](https://docs.gitlab.com/ee/user/markdown.html#table-of-contents)
+* [Admonitions](https://python-markdown.github.io/extensions/admonition/) and [alerts](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts)
+* [Collapsed sections](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections)
+* [Mermaid diagrams](https://mermaid.live/) in code blocks (converted to images)
+
+## Installation
+
+Install the core package from PyPI:
+
+```sh
+pip install markdown-to-confluence
+```
+
+Converting code blocks of Mermaid diagrams into Confluence image attachments requires [mermaid-cli](https://github.com/mermaid-js/mermaid-cli):
+
+```sh
+npm install -g @mermaid-js/mermaid-cli
+```
 
 ## Getting started
 
@@ -131,7 +148,7 @@ Alternatively, use the `--generated-by GENERATED_BY` option. The tag takes prece
 
 You execute the command-line tool `md2conf` to synchronize the Markdown file with Confluence:
 
-```console
+```sh
 $ python3 -m md2conf sample/example.md
 ```
 
@@ -139,14 +156,15 @@ Use the `--help` switch to get a full list of supported command-line options:
 
 ```console
 $ python3 -m md2conf --help
-usage: md2conf [-h] [-d DOMAIN] [-p PATH] [-u USERNAME] [-a APIKEY] [-s SPACE] [-l {debug,info,warning,error,critical}] [-r ROOT_PAGE] [--generated-by GENERATED_BY]
-               [--no-generated-by] [--ignore-invalid-url] [--local]
+usage: md2conf [-h] [-d DOMAIN] [-p PATH] [-u USERNAME] [-a APIKEY] [-s SPACE] [-l {debug,info,warning,error,critical}] [-r ROOT_PAGE]
+               [--generated-by GENERATED_BY] [--no-generated-by] [--render-mermaid] [--no-render-mermaid]
+               [--render-mermaid-format {png,svg}] [--heading-anchors] [--ignore-invalid-url] [--local]
                mdpath
 
 positional arguments:
   mdpath                Path to Markdown file or directory to convert and publish.
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -d DOMAIN, --domain DOMAIN
                         Confluence organization domain.
@@ -163,6 +181,41 @@ optional arguments:
   --generated-by GENERATED_BY
                         Add prompt to pages (default: 'This page has been generated with a tool.').
   --no-generated-by     Do not add 'generated by a tool' prompt to pages.
+  --render-mermaid      Render Mermaid diagrams as image files and add as attachments.
+  --no-render-mermaid   Inline Mermaid diagram in Confluence page.
+  --render-mermaid-format {png,svg}
+                        Format for rendering Mermaid diagrams (default: 'png').
+  --heading-anchors     Place an anchor at each section heading with GitHub-style same-page identifiers.
   --ignore-invalid-url  Emit a warning but otherwise ignore relative URLs that point to ill-specified locations.
   --local               Write XHTML-based Confluence Storage Format files locally without invoking Confluence API.
 ```
+
+### 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.
+
+```sh
+docker run --rm --name md2conf hunyadi/md2conf -d instructure.atlassian.net -u levente.hunyadi@instructure.com -a 0123456789abcdef -s DAP ./
+```
+
+Note that the entry point for the docker container's base image is `ENTRYPOINT ["python3", "-m", "md2conf"]`.
+
+```Dockerfile
+FROM hunyadi/md2conf:latest
+
+ENV CONFLUENCE_DOMAIN='instructure.atlassian.net'
+ENV CONFLUENCE_PATH='/wiki/'
+ENV CONFLUENCE_USER_NAME='levente.hunyadi@instructure.com'
+ENV CONFLUENCE_API_KEY='0123456789abcdef'
+ENV CONFLUENCE_SPACE_KEY='DAP'
+
+CMD ["./"]
+```
+
+Alternatively,
+
+```Dockerfile
+FROM hunyadi/md2conf:latest
+
+CMD ["-d", "instructure.atlassian.net", "-u", "levente.hunyadi@instructure.com", "-a", "0123456789abcdef", "-s", "DAP", "./"]
+```

{markdown_to_confluence-0.1.12 → markdown_to_confluence-0.2.0}/README.md

@@ -14,12 +14,29 @@ This Python package
 
 * Sections and subsections
 * Text with **bold**, *italic*, `monospace`, <ins>underline</ins> and ~~strikethrough~~
-* Link to [external locations](http://example.com/)
+* Link to [sections on the same page](#getting-started) or [external locations](http://example.com/)
 * Ordered and unordered lists
 * Code blocks (e.g. Python, JSON, XML)
 * Image references (uploaded as Confluence page attachments)
-* [Table of Contents](https://docs.gitlab.com/ee/user/markdown.html#table-of-contents)
-* [Admonitions](https://python-markdown.github.io/extensions/admonition/) (converted into *info*, *tip*, *note* and *warning* Confluence panels)
+* Tables
+* [Table of contents](https://docs.gitlab.com/ee/user/markdown.html#table-of-contents)
+* [Admonitions](https://python-markdown.github.io/extensions/admonition/) and [alerts](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts)
+* [Collapsed sections](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections)
+* [Mermaid diagrams](https://mermaid.live/) in code blocks (converted to images)
+
+## Installation
+
+Install the core package from PyPI:
+
+```sh
+pip install markdown-to-confluence
+```
+
+Converting code blocks of Mermaid diagrams into Confluence image attachments requires [mermaid-cli](https://github.com/mermaid-js/mermaid-cli):
+
+```sh
+npm install -g @mermaid-js/mermaid-cli
+```
 
 ## Getting started
 
@@ -100,7 +117,7 @@ Alternatively, use the `--generated-by GENERATED_BY` option. The tag takes prece
 
 You execute the command-line tool `md2conf` to synchronize the Markdown file with Confluence:
 
-```console
+```sh
 $ python3 -m md2conf sample/example.md
 ```
 
@@ -108,14 +125,15 @@ Use the `--help` switch to get a full list of supported command-line options:
 
 ```console
 $ python3 -m md2conf --help
-usage: md2conf [-h] [-d DOMAIN] [-p PATH] [-u USERNAME] [-a APIKEY] [-s SPACE] [-l {debug,info,warning,error,critical}] [-r ROOT_PAGE] [--generated-by GENERATED_BY]
-               [--no-generated-by] [--ignore-invalid-url] [--local]
+usage: md2conf [-h] [-d DOMAIN] [-p PATH] [-u USERNAME] [-a APIKEY] [-s SPACE] [-l {debug,info,warning,error,critical}] [-r ROOT_PAGE]
+               [--generated-by GENERATED_BY] [--no-generated-by] [--render-mermaid] [--no-render-mermaid]
+               [--render-mermaid-format {png,svg}] [--heading-anchors] [--ignore-invalid-url] [--local]
                mdpath
 
 positional arguments:
   mdpath                Path to Markdown file or directory to convert and publish.
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -d DOMAIN, --domain DOMAIN
                         Confluence organization domain.
@@ -132,6 +150,41 @@ optional arguments:
   --generated-by GENERATED_BY
                         Add prompt to pages (default: 'This page has been generated with a tool.').
   --no-generated-by     Do not add 'generated by a tool' prompt to pages.
+  --render-mermaid      Render Mermaid diagrams as image files and add as attachments.
+  --no-render-mermaid   Inline Mermaid diagram in Confluence page.
+  --render-mermaid-format {png,svg}
+                        Format for rendering Mermaid diagrams (default: 'png').
+  --heading-anchors     Place an anchor at each section heading with GitHub-style same-page identifiers.
   --ignore-invalid-url  Emit a warning but otherwise ignore relative URLs that point to ill-specified locations.
   --local               Write XHTML-based Confluence Storage Format files locally without invoking Confluence API.
 ```
+
+### 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.
+
+```sh
+docker run --rm --name md2conf hunyadi/md2conf -d instructure.atlassian.net -u levente.hunyadi@instructure.com -a 0123456789abcdef -s DAP ./
+```
+
+Note that the entry point for the docker container's base image is `ENTRYPOINT ["python3", "-m", "md2conf"]`.
+
+```Dockerfile
+FROM hunyadi/md2conf:latest
+
+ENV CONFLUENCE_DOMAIN='instructure.atlassian.net'
+ENV CONFLUENCE_PATH='/wiki/'
+ENV CONFLUENCE_USER_NAME='levente.hunyadi@instructure.com'
+ENV CONFLUENCE_API_KEY='0123456789abcdef'
+ENV CONFLUENCE_SPACE_KEY='DAP'
+
+CMD ["./"]
+```
+
+Alternatively,
+
+```Dockerfile
+FROM hunyadi/md2conf:latest
+
+CMD ["-d", "instructure.atlassian.net", "-u", "levente.hunyadi@instructure.com", "-a", "0123456789abcdef", "-s", "DAP", "./"]
+```

{markdown_to_confluence-0.1.12 → markdown_to_confluence-0.2.0}/markdown_to_confluence.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: markdown-to-confluence
-Version: 0.1.12
+Version: 0.2.0
 Summary: Publish Markdown files to Confluence wiki
 Home-page: https://github.com/hunyadi/md2conf
 Author: Levente Hunyadi
@@ -21,11 +21,11 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: lxml>=5.2
-Requires-Dist: types-lxml>=2024.4.14
+Requires-Dist: lxml>=5.3
+Requires-Dist: types-lxml>=2024.8.7
 Requires-Dist: markdown>=3.6
 Requires-Dist: types-markdown>=3.6
-Requires-Dist: pymdown-extensions>=10.8
+Requires-Dist: pymdown-extensions>=10.9
 Requires-Dist: requests>=2.32
 Requires-Dist: types-requests>=2.32
 
@@ -45,12 +45,29 @@ This Python package
 
 * Sections and subsections
 * Text with **bold**, *italic*, `monospace`, <ins>underline</ins> and ~~strikethrough~~
-* Link to [external locations](http://example.com/)
+* Link to [sections on the same page](#getting-started) or [external locations](http://example.com/)
 * Ordered and unordered lists
 * Code blocks (e.g. Python, JSON, XML)
 * Image references (uploaded as Confluence page attachments)
-* [Table of Contents](https://docs.gitlab.com/ee/user/markdown.html#table-of-contents)
-* [Admonitions](https://python-markdown.github.io/extensions/admonition/) (converted into *info*, *tip*, *note* and *warning* Confluence panels)
+* Tables
+* [Table of contents](https://docs.gitlab.com/ee/user/markdown.html#table-of-contents)
+* [Admonitions](https://python-markdown.github.io/extensions/admonition/) and [alerts](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts)
+* [Collapsed sections](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections)
+* [Mermaid diagrams](https://mermaid.live/) in code blocks (converted to images)
+
+## Installation
+
+Install the core package from PyPI:
+
+```sh
+pip install markdown-to-confluence
+```
+
+Converting code blocks of Mermaid diagrams into Confluence image attachments requires [mermaid-cli](https://github.com/mermaid-js/mermaid-cli):
+
+```sh
+npm install -g @mermaid-js/mermaid-cli
+```
 
 ## Getting started
 
@@ -131,7 +148,7 @@ Alternatively, use the `--generated-by GENERATED_BY` option. The tag takes prece
 
 You execute the command-line tool `md2conf` to synchronize the Markdown file with Confluence:
 
-```console
+```sh
 $ python3 -m md2conf sample/example.md
 ```
 
@@ -139,14 +156,15 @@ Use the `--help` switch to get a full list of supported command-line options:
 
 ```console
 $ python3 -m md2conf --help
-usage: md2conf [-h] [-d DOMAIN] [-p PATH] [-u USERNAME] [-a APIKEY] [-s SPACE] [-l {debug,info,warning,error,critical}] [-r ROOT_PAGE] [--generated-by GENERATED_BY]
-               [--no-generated-by] [--ignore-invalid-url] [--local]
+usage: md2conf [-h] [-d DOMAIN] [-p PATH] [-u USERNAME] [-a APIKEY] [-s SPACE] [-l {debug,info,warning,error,critical}] [-r ROOT_PAGE]
+               [--generated-by GENERATED_BY] [--no-generated-by] [--render-mermaid] [--no-render-mermaid]
+               [--render-mermaid-format {png,svg}] [--heading-anchors] [--ignore-invalid-url] [--local]
                mdpath
 
 positional arguments:
   mdpath                Path to Markdown file or directory to convert and publish.
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -d DOMAIN, --domain DOMAIN
                         Confluence organization domain.
@@ -163,6 +181,41 @@ optional arguments:
   --generated-by GENERATED_BY
                         Add prompt to pages (default: 'This page has been generated with a tool.').
   --no-generated-by     Do not add 'generated by a tool' prompt to pages.
+  --render-mermaid      Render Mermaid diagrams as image files and add as attachments.
+  --no-render-mermaid   Inline Mermaid diagram in Confluence page.
+  --render-mermaid-format {png,svg}
+                        Format for rendering Mermaid diagrams (default: 'png').
+  --heading-anchors     Place an anchor at each section heading with GitHub-style same-page identifiers.
   --ignore-invalid-url  Emit a warning but otherwise ignore relative URLs that point to ill-specified locations.
   --local               Write XHTML-based Confluence Storage Format files locally without invoking Confluence API.
 ```
+
+### 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.
+
+```sh
+docker run --rm --name md2conf hunyadi/md2conf -d instructure.atlassian.net -u levente.hunyadi@instructure.com -a 0123456789abcdef -s DAP ./
+```
+
+Note that the entry point for the docker container's base image is `ENTRYPOINT ["python3", "-m", "md2conf"]`.
+
+```Dockerfile
+FROM hunyadi/md2conf:latest
+
+ENV CONFLUENCE_DOMAIN='instructure.atlassian.net'
+ENV CONFLUENCE_PATH='/wiki/'
+ENV CONFLUENCE_USER_NAME='levente.hunyadi@instructure.com'
+ENV CONFLUENCE_API_KEY='0123456789abcdef'
+ENV CONFLUENCE_SPACE_KEY='DAP'
+
+CMD ["./"]
+```
+
+Alternatively,
+
+```Dockerfile
+FROM hunyadi/md2conf:latest
+
+CMD ["-d", "instructure.atlassian.net", "-u", "levente.hunyadi@instructure.com", "-a", "0123456789abcdef", "-s", "DAP", "./"]
+```

{markdown_to_confluence-0.1.12 → markdown_to_confluence-0.2.0}/markdown_to_confluence.egg-info/SOURCES.txt

@@ -16,9 +16,10 @@ md2conf/api.py
 md2conf/application.py
 md2conf/converter.py
 md2conf/entities.dtd
+md2conf/mermaid.py
 md2conf/processor.py
 md2conf/properties.py
 md2conf/py.typed
-tests/test_api.py
 tests/test_conversion.py
+tests/test_mermaid.py
 tests/test_processor.py

{markdown_to_confluence-0.1.12 → markdown_to_confluence-0.2.0}/markdown_to_confluence.egg-info/requires.txt

@@ -1,7 +1,7 @@
-lxml>=5.2
-types-lxml>=2024.4.14
+lxml>=5.3
+types-lxml>=2024.8.7
 markdown>=3.6
 types-markdown>=3.6
-pymdown-extensions>=10.8
+pymdown-extensions>=10.9
 requests>=2.32
 types-requests>=2.32

{markdown_to_confluence-0.1.12 → markdown_to_confluence-0.2.0}/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.1.12"
+__version__ = "0.2.0"
 __author__ = "Levente Hunyadi"
 __copyright__ = "Copyright 2022-2024, Levente Hunyadi"
 __license__ = "MIT"

{markdown_to_confluence-0.1.12 → markdown_to_confluence-0.2.0}/md2conf/__main__.py

@@ -2,7 +2,6 @@ import argparse
 import logging
 import os.path
 import sys
-import typing
 from pathlib import Path
 from typing import Optional
 
@@ -24,6 +23,7 @@ class Arguments(argparse.Namespace):
     space: str
     loglevel: str
     ignore_invalid_url: bool
+    heading_anchors: bool
     generated_by: Optional[str]
 
 
@@ -52,7 +52,7 @@ def main() -> None:
         "-l",
         "--loglevel",
         choices=[
-            typing.cast(str, logging.getLevelName(level)).lower()
+            logging.getLevelName(level).lower()
             for level in (
                 logging.DEBUG,
                 logging.INFO,
@@ -81,6 +81,32 @@ def main() -> None:
         const=None,
         help="Do not add 'generated by a tool' prompt to pages.",
     )
+    parser.add_argument(
+        "--render-mermaid",
+        dest="render_mermaid",
+        action="store_true",
+        default=True,
+        help="Render Mermaid diagrams as image files and add as attachments.",
+    )
+    parser.add_argument(
+        "--no-render-mermaid",
+        dest="render_mermaid",
+        action="store_false",
+        help="Inline Mermaid diagram in Confluence page.",
+    )
+    parser.add_argument(
+        "--render-mermaid-format",
+        dest="diagram_output_format",
+        choices=["png", "svg"],
+        default="png",
+        help="Format for rendering Mermaid diagrams (default: 'png').",
+    )
+    parser.add_argument(
+        "--heading-anchors",
+        action="store_true",
+        default=False,
+        help="Place an anchor at each section heading with GitHub-style same-page identifiers.",
+    )
     parser.add_argument(
         "--ignore-invalid-url",
         action="store_true",
@@ -107,9 +133,12 @@ def main() -> None:
     )
 
     options = ConfluenceDocumentOptions(
+        heading_anchors=args.heading_anchors,
         ignore_invalid_url=args.ignore_invalid_url,
         generated_by=args.generated_by,
         root_page_id=args.root_page,
+        render_mermaid=args.render_mermaid,
+        diagram_output_format=args.diagram_output_format,
     )
     properties = ConfluenceProperties(
         args.domain, args.path, args.username, args.apikey, args.space

{markdown_to_confluence-0.1.12 → markdown_to_confluence-0.2.0}/md2conf/api.py

@@ -1,3 +1,4 @@
+import io
 import json
 import logging
 import mimetypes
@@ -177,7 +178,8 @@ class ConfluenceSession:
         extensions = typing.cast(Dict[str, JsonType], result["extensions"])
         media_type = typing.cast(str, extensions["mediaType"])
         file_size = typing.cast(int, extensions["fileSize"])
-        comment = typing.cast(str, extensions["comment"])
+        comment = extensions.get("comment", "")
+        comment = typing.cast(str, comment)
         return ConfluenceAttachment(id, media_type, file_size, comment)
 
     def upload_attachment(
@@ -185,6 +187,7 @@ class ConfluenceSession:
         page_id: str,
         attachment_path: Path,
         attachment_name: str,
+        raw_data: Optional[bytes] = None,
         comment: Optional[str] = None,
         *,
         space_key: Optional[str] = None,
@@ -192,7 +195,7 @@ class ConfluenceSession:
     ) -> None:
         content_type = mimetypes.guess_type(attachment_path, strict=True)[0]
 
-        if not attachment_path.is_file():
+        if not raw_data and not attachment_path.is_file():
             raise ConfluenceError(f"file not found: {attachment_path}")
 
         try:
@@ -200,9 +203,14 @@ class ConfluenceSession:
                 page_id, attachment_name, space_key=space_key
             )
 
-            if not force and attachment.file_size == attachment_path.stat().st_size:
-                LOGGER.info("Up-to-date attachment: %s", attachment_name)
-                return
+            if not raw_data:
+                if not force and attachment.file_size == attachment_path.stat().st_size:
+                    LOGGER.info("Up-to-date attachment: %s", attachment_name)
+                    return
+            else:
+                if not force and attachment.file_size == len(raw_data):
+                    LOGGER.info("Up-to-date embedded image: %s", attachment_name)
+                    return
 
             id = removeprefix(attachment.id, "att")
             path = f"/content/{page_id}/child/attachment/{id}/data"
@@ -212,17 +220,36 @@ class ConfluenceSession:
 
         url = self._build_url(path)
 
-        with open(attachment_path, "rb") as attachment_file:
+        if not raw_data:
+            with open(attachment_path, "rb") as attachment_file:
+                file_to_upload = {
+                    "comment": comment,
+                    "file": (
+                        attachment_name,  # will truncate path component
+                        attachment_file,
+                        content_type,
+                        {"Expires": "0"},
+                    ),
+                }
+                LOGGER.info("Uploading attachment: %s", attachment_name)
+                response = self.session.post(
+                    url,
+                    files=file_to_upload,  # type: ignore
+                    headers={"X-Atlassian-Token": "no-check"},
+                )
+        else:
+            LOGGER.info("Uploading raw data: %s", attachment_name)
+
             file_to_upload = {
                 "comment": comment,
                 "file": (
                     attachment_name,  # will truncate path component
-                    attachment_file,
+                    io.BytesIO(raw_data),  # type: ignore
                     content_type,
                     {"Expires": "0"},
                 ),
             }
-            LOGGER.info("Uploading attachment: %s", attachment_name)
+
             response = self.session.post(
                 url,
                 files=file_to_upload,  # type: ignore

{markdown_to_confluence-0.1.12 → markdown_to_confluence-0.2.0}/md2conf/application.py

@@ -94,7 +94,7 @@ class Application:
         """
 
         # parse file
-        with open(absolute_path, "r") as f:
+        with open(absolute_path, "r", encoding="utf-8") as f:
             document = f.read()
 
         qualified_id, document = extract_qualified_id(document)
@@ -131,9 +131,20 @@ class Application:
         )
 
     def _update_document(self, document: ConfluenceDocument, base_path: Path) -> None:
+
         for image in document.images:
             self.api.upload_attachment(
-                document.id.page_id, base_path / image, attachment_name(image), ""
+                document.id.page_id,
+                base_path / image,
+                attachment_name(image),
+            )
+
+        for image, data in document.embedded_images.items():
+            self.api.upload_attachment(
+                document.id.page_id,
+                Path("EMB") / image,
+                attachment_name(image),
+                raw_data=data,
             )
 
         content = document.xhtml()
@@ -147,7 +158,7 @@ class Application:
         page_id: str,
         space_key: Optional[str],
     ) -> None:
-        with open(path, "w") as file:
+        with open(path, "w", encoding="utf-8") as file:
             file.write(f"<!-- confluence-page-id: {page_id} -->\n")
             if space_key:
                 file.write(f"<!-- confluence-space-key: {space_key} -->\n")