markdown-to-confluence 0.5.4__py3-none-any.whl → 0.5.5__py3-none-any.whl

{markdown_to_confluence-0.5.4.dist-info → markdown_to_confluence-0.5.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-to-confluence
-Version: 0.5.4
+Version: 0.5.5
 Summary: Publish Markdown files to Confluence wiki
 Author-email: Levente Hunyadi <hunyadi@gmail.com>
 Maintainer-email: Levente Hunyadi <hunyadi@gmail.com>
@@ -27,18 +27,18 @@ Requires-Dist: cattrs>=25.3
 Requires-Dist: lxml>=6.0
 Requires-Dist: markdown>=3.10
 Requires-Dist: orjson>=3.11
-Requires-Dist: pymdown-extensions>=10.19
+Requires-Dist: pymdown-extensions>=10.20
 Requires-Dist: PyYAML>=6.0
 Requires-Dist: requests>=2.32
 Requires-Dist: truststore>=0.10
-Requires-Dist: typing-extensions>=4.15; python_version < "3.12"
+Requires-Dist: typing-extensions>=4.15; python_version < "3.11"
 Provides-Extra: dev
-Requires-Dist: markdown_doc>=0.1.6; extra == "dev"
-Requires-Dist: types-lxml>=2025.11.25; extra == "dev"
+Requires-Dist: markdown_doc>=0.1.7; extra == "dev"
+Requires-Dist: types-lxml>=2026.1.1; extra == "dev"
 Requires-Dist: types-markdown>=3.10; extra == "dev"
 Requires-Dist: types-PyYAML>=6.0; extra == "dev"
 Requires-Dist: types-requests>=2.32; extra == "dev"
-Requires-Dist: mypy>=1.19; extra == "dev"
+Requires-Dist: mypy[faster-cache]>=1.19; extra == "dev"
 Requires-Dist: ruff>=0.14; extra == "dev"
 Provides-Extra: formulas
 Requires-Dist: matplotlib>=3.9; extra == "formulas"
@@ -612,6 +612,35 @@ This Markdown document is neither parsed, nor synchronized with Confluence.
 
 This is useful if you have a page in a hierarchy that participates in parent-child relationships but whose content is edited directly in Confluence. Specifically, these documents can be referenced with relative links from other Markdown documents in the file system tree.
 
+### Excluding content sections
+
+When maintaining documentation in both Git repositories and Confluence, you may want certain content to appear only in the repository but not on Confluence pages. Use HTML comment markers to wrap and exclude specific sections from synchronization:
+
+```markdown
+# Project Documentation
+
+This content appears in both Git and Confluence.
+
+<!-- confluence-skip-start -->
+## Internal References
+- See [internal design doc](../internal/design.md)
+- Related to issue #123
+- Development notes for the team
+<!-- confluence-skip-end -->
+
+## Getting Started
+This section is published to Confluence.
+```
+
+Content between `<!-- confluence-skip-start -->` and `<!-- confluence-skip-end -->` markers is removed before conversion and will not appear on the Confluence page. This is useful for:
+
+- Repository-specific navigation and cross-references
+- GitLab/GitHub-specific metadata
+- Content relevant only for developers with repository access
+
+Multiple exclusion blocks can be used in the same document.
+
+
 ### Labels
 
 If a Markdown document has the front-matter attribute `tags`, *md2conf* assigns the specified tags to the Confluence page as labels.
@@ -681,36 +710,46 @@ options:
                         Use this option to set the log verbosity.
   -r ROOT_PAGE          Root Confluence page to create new pages. If omitted, will raise exception when creating new pages.
   --keep-hierarchy      Maintain source directory structure when exporting to Confluence.
-  --flatten-hierarchy   Flatten directories with no index.md or README.md when exporting to Confluence.
+  --skip-hierarchy      Flatten directories with no `index.md` or `README.md` when exporting to Confluence.
   --generated-by MARKDOWN
-                        Add prompt to pages (default: 'This page has been generated with a tool.').
+                        Add prompt to pages.
   --no-generated-by     Do not add 'generated by a tool' prompt to pages.
   --skip-update         Skip saving Confluence page ID in Markdown files.
-  --render-drawio       Render draw.io diagrams as image files. (Installed utility required to covert.)
+  --heading-anchors     Place an anchor at each section heading with GitHub-style same-page identifiers.
+  --no-heading-anchors  Omit the extra anchor from section headings. (May break manually placed same-page references.) (default)
+  --force-valid-url     Raise an error when relative URLs point to an invalid location. (default)
+  --no-force-valid-url  Emit a warning but otherwise ignore relative URLs that point to an invalid location.
+  --skip-title-heading  Remove the first heading from document body when it is used as the page title (does not apply if title comes from front-matter).
+  --keep-title-heading  Keep the first heading in document body even when used as page title. (default)
+  --prefer-raster       Prefer PNG over SVG when both exist. (default)
+  --no-prefer-raster    Use SVG files directly instead of preferring PNG equivalents.
+  --render-drawio       Render draw.io diagrams as image files. (Installed utility required to covert.) (default)
   --no-render-drawio    Upload draw.io diagram sources as Confluence page attachments. (Marketplace app required to display.)
-  --render-mermaid      Render Mermaid diagrams as image files. (Installed utility required to convert.)
+  --render-mermaid      Render Mermaid diagrams as image files. (Installed utility required to convert.) (default)
   --no-render-mermaid   Upload Mermaid diagram sources as Confluence page attachments. (Marketplace app required to display.)
-  --render-plantuml     Render PlantUML diagrams as image files. (Installed utility required to convert.)
+  --render-plantuml     Render PlantUML diagrams as image files. (Installed utility required to convert.) (default)
   --no-render-plantuml  Upload PlantUML diagram sources as Confluence page attachments. (Marketplace app required to display.)
-  --render-latex        Render LaTeX formulas as image files. (Matplotlib required to convert.)
+  --render-latex        Render LaTeX formulas as image files. (Matplotlib required to convert.) (default)
   --no-render-latex     Inline LaTeX formulas in Confluence page. (Marketplace app required to display.)
   --diagram-output-format {png,svg}
-                        Format for rendering Mermaid and draw.io diagrams (default: 'png').
-  --prefer-raster       Prefer PNG over SVG when both exist (default: enabled).
-  --no-prefer-raster    Use SVG files directly instead of preferring PNG equivalents.
-  --heading-anchors     Place an anchor at each section heading with GitHub-style same-page identifiers.
-  --no-heading-anchors  Don't place an anchor at each section heading.
-  --ignore-invalid-url  Emit a warning but otherwise ignore relative URLs that point to ill-specified locations.
-  --skip-title-heading  Skip the first heading from document body when it is used as the page title (does not apply if title comes from front-matter).
-  --no-skip-title-heading
-                        Keep the first heading in document body even when used as page title (default).
-  --title-prefix TEXT   String to prepend to Confluence page title for each published page.
+                        Format for rendering Mermaid and draw.io diagrams. (default: png)
   --webui-links         Enable Confluence Web UI links. (Typically required for on-prem versions of Confluence.)
-  --alignment {center,left,right}
-                        Alignment for block-level images and formulas (default: 'center').
-  --max-image-width MAX_IMAGE_WIDTH
-                        Maximum display width for images [px]. Wider images are scaled down for page display. Original size kept for full-size viewing.
+  --no-webui-links      Use hierarchical links including space and page ID. (default)
   --use-panel           Transform admonitions and alerts into a Confluence custom panel.
+  --no-use-panel        Use standard Confluence macro types for admonitions and alerts (info, tip, note and warning). (default)
+  --layout-image-alignment {center,left,right,None}
+                        Alignment for block-level images and formulas.
+  --layout-image-max-width INT
+                        Maximum display width for images [px]. Wider images are scaled down for page display.
+  --layout-table-width INT
+                        Maximum table width in pixels.
+  --layout-table-display-mode {responsive,fixed}
+                        Set table display mode. (default: responsive)
+  --layout-alignment {center,left,right,None}
+                        Default alignment for block-level content.
+  --ignore-invalid-url  Emit a warning but otherwise ignore relative URLs that point to ill-specified locations.
+  --title-prefix TEXT   String to prepend to Confluence page title for each published page.
+  --line-numbers        Inject line numbers in Markdown source to help localize conversion errors.
   --local               Write XHTML-based Confluence Storage Format files locally without invoking Confluence API.
   --headers KEY=VALUE [KEY=VALUE ...]
                         Apply custom headers to all Confluence API requests.
@@ -723,46 +762,49 @@ options:
 ```python
 from md2conf.api import ConfluenceAPI
 from md2conf.environment import ConnectionProperties
-from md2conf.options import ConverterOptions, DocumentOptions, ImageLayoutOptions, LayoutOptions, TableLayoutOptions
+from md2conf.options import ConfluencePageID, ConverterOptions, DocumentOptions, ImageLayoutOptions, LayoutOptions, TableLayoutOptions
 from md2conf.publisher import Publisher
 
 properties = ConnectionProperties(
-    api_url=...,
-    domain=...,
-    base_path=...,
-    user_name=...,
-    api_key=...,
-    space_key=...,
-    headers=...,
+    domain=str() or None,
+    base_path=str() or None,
+    space_key=str() or None,
+    api_url=str() or None,
+    user_name=str() or None,
+    api_key=str(),
+    headers={str(): str()} or None,
 )
 options = DocumentOptions(
-    root_page_id=...,
-    keep_hierarchy=...,
-    title_prefix=...,
-    generated_by=...,
+    root_page_id=ConfluencePageID() or None,
+    keep_hierarchy=bool(),
+    title_prefix=str() or None,
+    generated_by=str() or None,
+    skip_update=bool(),
     converter=ConverterOptions(
-        heading_anchors=...,
-        ignore_invalid_url=...,
-        skip_title_heading=...,
-        prefer_raster=...,
-        render_drawio=...,
-        render_mermaid=...,
-        render_plantuml=...,
-        render_latex=...,
-        diagram_output_format=...,
-        webui_links=...,
-        use_panel=...,
+        heading_anchors=bool(),
+        force_valid_url=bool(),
+        skip_title_heading=bool(),
+        prefer_raster=bool(),
+        render_drawio=bool(),
+        render_mermaid=bool(),
+        render_plantuml=bool(),
+        render_latex=bool(),
+        diagram_output_format='png' or 'svg',
+        webui_links=bool(),
+        use_panel=bool(),
         layout=LayoutOptions(
             image=ImageLayoutOptions(
-                alignment=...,
-                max_width=...,
+                alignment='center' or 'left' or 'right' or None,
+                max_width=int() or None,
             ),
             table=TableLayoutOptions(
-                width=...,
-                display_mode=...,
+                width=int() or None,
+                display_mode='responsive' or 'fixed',
             ),
+            alignment='center' or 'left' or 'right' or None,
         ),
     ),
+    line_numbers=bool(),
 )
 with ConfluenceAPI(properties) as api:
     Publisher(api, options).process(mdpath)

{markdown_to_confluence-0.5.4.dist-info → markdown_to_confluence-0.5.5.dist-info}/RECORD

@@ -1,41 +1,43 @@
-markdown_to_confluence-0.5.4.dist-info/licenses/LICENSE,sha256=SEEBf2BMI1LUHnDvyHnV6L12A6zTAOQcsyMvaawAXWo,1077
-md2conf/__init__.py,sha256=0xq0z3v7oQaJxJwZRPOd-Z4zgOOCnzgDJYa9nytHTD0,402
-md2conf/__main__.py,sha256=BPUZd0uzCsAOH3Y5o7ydvV7Z77jSI8fHfo4AZPyYj2c,14639
-md2conf/api.py,sha256=3TlUmiDU31dfL8raMwv2wQWV_IvVq6fu8j86cjKTz1A,42780
-md2conf/attachment.py,sha256=Nc3qGDENWBnsI6OVwMLXnk0EyEITpvov9MluDFD90ZI,1689
+markdown_to_confluence-0.5.5.dist-info/licenses/LICENSE,sha256=SEEBf2BMI1LUHnDvyHnV6L12A6zTAOQcsyMvaawAXWo,1077
+md2conf/__init__.py,sha256=TlQmZzCRIxd5nfwKqbjScEoeeE6okogDHEHRyXzmQBo,402
+md2conf/__main__.py,sha256=4D4OiRJUY1m0UnhndIjg9bOFfAOsuyw12OzgxzypFnw,9480
+md2conf/api.py,sha256=6lJnu-daNxDhOoJdTQ3GAyt6RkFSIP92iC4ptm8sNhs,43028
+md2conf/attachment.py,sha256=3fGLXX3utOP9dZeZqfs9sFiwH5yFgk7ixfhKbTfUb8U,1720
+md2conf/clio.py,sha256=pyiZKipOTQUqR6f0fblchPL1yAr6mM_GPCzS_-Kv1aQ,7851
 md2conf/coalesce.py,sha256=YHnqFwow5wCj6OQ3oosig01D2lxWusAScMF4HAUO2-g,1305
 md2conf/collection.py,sha256=ukN74VCa4HaGSh6tLXpLd0j_UNPywcnKI0X7usgdSCo,824
-md2conf/compatibility.py,sha256=4ZNN6VLqxSbI1kowdsPproGZqwxBISys4Z22vBfe6Z8,687
-md2conf/converter.py,sha256=7eP4sEPgmyjiD0PO3jjyS5TcDY3OSW9hYsriLd9rbek,63201
-md2conf/csf.py,sha256=6H9G-5cZyyWMJr0tFskPNiWdQ2Ehq-V8EhlvvxhukWY,6582
+md2conf/compatibility.py,sha256=b6n_JFRlNU5Jx4RJqS7FgMp4tk0iYGFxb4--fkIsQcM,873
+md2conf/converter.py,sha256=M7jILSSlY_G1WsyQ9tcZ3MsNmGH1T1GTUIiJQ0SSjlY,66627
+md2conf/csf.py,sha256=w-ng621pWbECwlAwVOWrH0mszG_v9Ac0W39RtHyNa2w,8365
 md2conf/emoticon.py,sha256=0g4rkx3d58xU4nnLak5ms7i0FSDnq0WJrLVFRgGyLC8,542
 md2conf/entities.dtd,sha256=M6NzqL5N7dPs_eUA_6sDsiSLzDaAacrx9LdttiufvYU,30215
 md2conf/environment.py,sha256=TfNEz3Pyw9qe7f8i7e_kph16c09fhZ4cLNZZzIjmI18,3892
 md2conf/extension.py,sha256=_IBf_yhYb6luQM3A-vAAtCpjHay33kE4Au_SGuC3kow,2274
 md2conf/external.py,sha256=uY1G7bdqEMJW66vOvKsh5CS4oHY-YA7h2VVuaSdaqBo,2366
 md2conf/formatting.py,sha256=ygL59VgpioX069axEX-7XjKs0sUjTfIZiBE5fWmITxc,4557
-md2conf/frontmatter.py,sha256=iWtn_oXoLQxvCsdI3OXs1ylWGmB-gc7mMLpSGg113i4,1888
-md2conf/image.py,sha256=YrtcE5KhzcbjiT-oQEkk--yKSiRSPlDUtMpekoepIdo,5289
-md2conf/latex.py,sha256=haZKkUxSEcPj3fVmiIVZAwgszqNqGLk1GQ7i8KGHpo0,2226
+md2conf/frontmatter.py,sha256=3hUvrxvopI90UxJX7BLwLkjsC6LKLVr4mJ_ctB4r-po,2263
+md2conf/image.py,sha256=E9sLj9xU41pKHBo_8saBcyOuJMwNPwVQFIMmW_7QTzA,5257
+md2conf/latex.py,sha256=RukmO19gvmOFIfWTyBNth1r7FlnihvX56R1EWiaNRdU,2466
 md2conf/local.py,sha256=eY3WpY-lNzLZeAfxX1ACVEhuzz0HDYX_sNQogJfkqcM,3673
-md2conf/markdown.py,sha256=4Km-AbQH04nDgPF0ijo-Ld7o8jTPXzENIMn7P1qIk0o,3148
+md2conf/markdown.py,sha256=Okhzod811q5-AGn1dOdsYKeB8jBE0GXD2d4_k7Dk9y8,5939
 md2conf/matcher.py,sha256=Xg4YSb87iPkCzhKuKytBut6NOkEab3IM-AjzXbwy64U,6774
 md2conf/metadata.py,sha256=NOjbCIrwLgTIIeNgmo7w5JXuT-pxOXBGSg-irfdpokk,976
-md2conf/options.py,sha256=DLxnQBhDmDJgfEDSYyMChJi_krS1nsquOHBKg82aGrY,4500
+md2conf/options.py,sha256=G6J2l7JW__bIjpTJEQfiFkX3mdB9Q1XbJoN9xduzt3k,7993
 md2conf/png.py,sha256=GU3-0dG6HqwGjedJVUciaIdA-6CdPTy_clsOQGr6dGE,6251
 md2conf/processor.py,sha256=xVLpvKg2FEO0tWsHQ8sm7YpimQepbZ07W0_yUzcvl6c,11116
-md2conf/publisher.py,sha256=xRIig53b4-DLncL07XBgLN3ecmTsWwNEK3ckjyhqfU8,11574
+md2conf/publisher.py,sha256=n0YkMPw0YZQAUyj-PEW5RSes8YNxIEexFMSMtA7jrTY,14435
 md2conf/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-md2conf/scanner.py,sha256=bupKNe47DRc8MyMLzYfgtzyVHV9osJSgnr7KCnKsMuM,3888
-md2conf/serializer.py,sha256=W4_yLJfT3vLw0PUg88lpUEnvn64CjaX3ZaKgIrwcxfw,1786
-md2conf/svg.py,sha256=fjr8sWe-tqdAKaIq2bsR9qPrhnCXUmoVRtezHZa86cg,11558
+md2conf/reflection.py,sha256=9b2X9BEisVHpZY5SWv89Z5ZucZ7bO1dIKmWGiooMS68,2638
+md2conf/scanner.py,sha256=2OYBUxooIm8dJBzYMxB3YjdWam6QiNA6fFi5BocvFTo,4217
+md2conf/serializer.py,sha256=fkSzSIPUMSOze4NrpYsqzfFrXQiRYROO9HrueQZoeSo,2144
+md2conf/svg.py,sha256=dR4dnwbjoQq9iIM4nH9PQ4SUdTrZS0BKt0hMyO4C8qE,11607
 md2conf/text.py,sha256=cnYV_JQp_v91LbQHo3qvxcEuhIdaPjCjkmLOKINcNv4,1736
-md2conf/toc.py,sha256=aJEH3fIzDr2RufxFbHJ8maEpezp8uXI_uw90k3-KNkA,4585
+md2conf/toc.py,sha256=g1mmfcK3c4qff-oQM9dr6s_6gF7WTMbNXoxsDAsiJBY,4614
 md2conf/uri.py,sha256=my0deyR5SlppJrYCbXF1Zz94QA1JT-HTWe9pKw7AJ_A,1158
-md2conf/xml.py,sha256=uaaUDs0hfluNX74dfkY_Dxu1KmeNDGogpGRGpUVEfE4,5526
+md2conf/xml.py,sha256=eR41FaqiketsCxTFBhwKEUW4g1ZQohvlh5J5WC3X-7Q,6690
 md2conf/drawio/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 md2conf/drawio/extension.py,sha256=HHLUriTfg82VCfOEyzU-6j2IM9rxR3I1UdSDdujWHgU,4409
-md2conf/drawio/render.py,sha256=veSu5gjm5ggLnmaH7uvH9qNeOygBJpqhSKK_LJs0QTk,8581
+md2conf/drawio/render.py,sha256=BgQRIScH_JpiVX7YTY543x7hQjThskqHf_w9YQ9Y5o0,8636
 md2conf/mermaid/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 md2conf/mermaid/config.py,sha256=5Dec2QcdB_GtnuXIW6nhJK8J5caduNZU1oz1mcmmb44,376
 md2conf/mermaid/extension.py,sha256=1drXVM_KbS00dcjSCRru0wwbil4zq3aR81dHMhfe7zA,4021
@@ -44,12 +46,12 @@ md2conf/mermaid/render.py,sha256=zO6M5UWSKiezoxPojD8iwFnwrFEDw_P6liQi-C3LQgw,181
 md2conf/mermaid/scanner.py,sha256=oIpaNxiZBNcmggnjlyYGcIVOXcYQWjf1lEVdyIwE4xE,1379
 md2conf/plantuml/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 md2conf/plantuml/config.py,sha256=j0ONhkzmAPagh00ltamTKlVEvXa6R284We9pDxRy-5U,378
-md2conf/plantuml/extension.py,sha256=EQ-2O4d2cWBGcIHcFFXgaCNrfi357hS6IE_PsvwJ8_k,6256
+md2conf/plantuml/extension.py,sha256=TPwcQHw9s76GThVQVdgcPB0THmnDFPly2Zqei6pG63I,6285
 md2conf/plantuml/render.py,sha256=Lf1It2KxHPKNGM1rhIDg9zdC3iqhRNCduByqa0_k_qw,3725
 md2conf/plantuml/scanner.py,sha256=Oso6VbHVuMaPMKMazQc_bf4hhOT5WeJN5WiVPM8peyM,1347
-markdown_to_confluence-0.5.4.dist-info/METADATA,sha256=bz_rRHiqV-EYCMcXCE9NMlUc8bk28SbFz9KO43YuW0E,45324
-markdown_to_confluence-0.5.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-markdown_to_confluence-0.5.4.dist-info/entry_points.txt,sha256=F1zxa1wtEObtbHS-qp46330WVFLHdMnV2wQ-ZorRmX0,50
-markdown_to_confluence-0.5.4.dist-info/top_level.txt,sha256=_FJfl_kHrHNidyjUOuS01ngu_jDsfc-ZjSocNRJnTzU,8
-markdown_to_confluence-0.5.4.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-markdown_to_confluence-0.5.4.dist-info/RECORD,,
+markdown_to_confluence-0.5.5.dist-info/METADATA,sha256=zpy0fBKhzk-S2JcDLMZefDDTI5jrF1hTfIQkY7zyKg0,47514
+markdown_to_confluence-0.5.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+markdown_to_confluence-0.5.5.dist-info/entry_points.txt,sha256=F1zxa1wtEObtbHS-qp46330WVFLHdMnV2wQ-ZorRmX0,50
+markdown_to_confluence-0.5.5.dist-info/top_level.txt,sha256=_FJfl_kHrHNidyjUOuS01ngu_jDsfc-ZjSocNRJnTzU,8
+markdown_to_confluence-0.5.5.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+markdown_to_confluence-0.5.5.dist-info/RECORD,,

{markdown_to_confluence-0.5.4.dist-info → markdown_to_confluence-0.5.5.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

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.5.4"
+__version__ = "0.5.5"
 __author__ = "Levente Hunyadi"
 __copyright__ = "Copyright 2022-2026, Levente Hunyadi"
 __license__ = "MIT"

md2conf/__main__.py

@@ -17,15 +17,16 @@ import typing
 from io import StringIO
 from pathlib import Path
 from types import TracebackType
-from typing import Any, Iterable, Literal, Sequence
+from typing import Any, Iterable, Sequence
 
 from requests.exceptions import HTTPError, JSONDecodeError
 
 from . import __version__
+from .clio import add_arguments, get_options
 from .compatibility import override
 from .environment import ArgumentError, ConfluenceSiteProperties, ConnectionProperties
 from .metadata import ConfluenceSiteMetadata
-from .options import ConfluencePageID, ConverterOptions, DocumentOptions, ImageLayoutOptions, LayoutOptions
+from .options import ConfluencePageID, ConverterOptions, DocumentOptions
 
 LOGGER = logging.getLogger(__name__)
 
@@ -39,26 +40,14 @@ class Arguments(argparse.Namespace):
     api_key: str | None
     space: str | None
     loglevel: str
-    heading_anchors: bool
-    ignore_invalid_url: bool
     root_page: str | None
     keep_hierarchy: bool
-    skip_title_heading: bool
     title_prefix: str | None
     generated_by: str | None
     skip_update: bool
-    prefer_raster: bool
-    render_drawio: bool
-    render_mermaid: bool
-    render_plantuml: bool
-    render_latex: bool
-    diagram_output_format: Literal["png", "svg"]
+    line_numbers: bool
     local: bool
     headers: dict[str, str]
-    webui_links: bool
-    alignment: Literal["center", "left", "right"]
-    max_image_width: int | None
-    use_panel: bool
 
 
 class KwargsAppendAction(argparse.Action):
@@ -129,16 +118,7 @@ def get_parser() -> argparse.ArgumentParser:
     parser.add_argument(
         "-l",
         "--loglevel",
-        choices=[
-            logging.getLevelName(level).lower()
-            for level in (
-                logging.DEBUG,
-                logging.INFO,
-                logging.WARN,
-                logging.ERROR,
-                logging.CRITICAL,
-            )
-        ],
+        choices=[logging.getLevelName(level).lower() for level in (logging.DEBUG, logging.INFO, logging.WARN, logging.ERROR, logging.CRITICAL)],
         default=logging.getLevelName(logging.INFO),
         help="Use this option to set the log verbosity.",
     )
@@ -154,16 +134,16 @@ def get_parser() -> argparse.ArgumentParser:
         help="Maintain source directory structure when exporting to Confluence.",
     )
     parser.add_argument(
-        "--flatten-hierarchy",
+        "--skip-hierarchy",
         dest="keep_hierarchy",
         action="store_false",
-        help="Flatten directories with no index.md or README.md when exporting to Confluence.",
+        help="Flatten directories with no `index.md` or `README.md` when exporting to Confluence.",
     )
     parser.add_argument(
         "--generated-by",
         default="This page has been generated with a tool.",
         metavar="MARKDOWN",
-        help="Add prompt to pages (default: 'This page has been generated with a tool.').",
+        help="Add prompt to pages.",
     )
     parser.add_argument(
         "--no-generated-by",
@@ -178,108 +158,15 @@ def get_parser() -> argparse.ArgumentParser:
         default=False,
         help="Skip saving Confluence page ID in Markdown files.",
     )
-    parser.add_argument(
-        "--render-drawio",
-        dest="render_drawio",
-        action="store_true",
-        default=True,
-        help="Render draw.io diagrams as image files. (Installed utility required to covert.)",
-    )
-    parser.add_argument(
-        "--no-render-drawio",
-        dest="render_drawio",
-        action="store_false",
-        help="Upload draw.io diagram sources as Confluence page attachments. (Marketplace app required to display.)",
-    )
-    parser.add_argument(
-        "--render-mermaid",
-        dest="render_mermaid",
-        action="store_true",
-        default=True,
-        help="Render Mermaid diagrams as image files. (Installed utility required to convert.)",
-    )
-    parser.add_argument(
-        "--no-render-mermaid",
-        dest="render_mermaid",
-        action="store_false",
-        help="Upload Mermaid diagram sources as Confluence page attachments. (Marketplace app required to display.)",
-    )
-    parser.add_argument(
-        "--render-plantuml",
-        dest="render_plantuml",
-        action="store_true",
-        default=True,
-        help="Render PlantUML diagrams as image files. (Installed utility required to convert.)",
-    )
-    parser.add_argument(
-        "--no-render-plantuml",
-        dest="render_plantuml",
-        action="store_false",
-        help="Upload PlantUML diagram sources as Confluence page attachments. (Marketplace app required to display.)",
-    )
-    parser.add_argument(
-        "--render-latex",
-        dest="render_latex",
-        action="store_true",
-        default=True,
-        help="Render LaTeX formulas as image files. (Matplotlib required to convert.)",
-    )
-    parser.add_argument(
-        "--no-render-latex",
-        dest="render_latex",
-        action="store_false",
-        help="Inline LaTeX formulas in Confluence page. (Marketplace app required to display.)",
-    )
-    parser.add_argument(
-        "--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(
-        "--prefer-raster",
-        dest="prefer_raster",
-        action="store_true",
-        default=True,
-        help="Prefer PNG over SVG when both exist (default: enabled).",
-    )
-    parser.add_argument(
-        "--no-prefer-raster",
-        dest="prefer_raster",
-        action="store_false",
-        help="Use SVG files directly instead of preferring PNG equivalents.",
-    )
-    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(
-        "--no-heading-anchors",
-        action="store_false",
-        dest="heading_anchors",
-        help="Don't place an anchor at each section heading.",
-    )
-    parser.add_argument(
-        "--ignore-invalid-url",
-        action="store_true",
-        default=False,
-        help="Emit a warning but otherwise ignore relative URLs that point to ill-specified locations.",
-    )
-    parser.add_argument(
-        "--skip-title-heading",
-        action="store_true",
-        default=False,
-        help="Skip the first heading from document body when it is used as the page title (does not apply if title comes from front-matter).",
-    )
-    parser.add_argument(
-        "--no-skip-title-heading",
-        dest="skip_title_heading",
-        action="store_false",
-        help="Keep the first heading in document body even when used as page title (default).",
-    )
+    add_arguments(parser, ConverterOptions)
+    if sys.version_info >= (3, 13):
+        parser.add_argument(
+            "--ignore-invalid-url",
+            dest="force_valid_url",
+            action="store_false",
+            help="Emit a warning but otherwise ignore relative URLs that point to ill-specified locations.",
+            deprecated=True,
+        )
     parser.add_argument(
         "--title-prefix",
         default=None,
@@ -287,30 +174,11 @@ def get_parser() -> argparse.ArgumentParser:
         help="String to prepend to Confluence page title for each published page.",
     )
     parser.add_argument(
-        "--webui-links",
-        action="store_true",
-        default=False,
-        help="Enable Confluence Web UI links. (Typically required for on-prem versions of Confluence.)",
-    )
-    parser.add_argument(
-        "--alignment",
-        dest="alignment",
-        choices=["center", "left", "right"],
-        default="center",
-        help="Alignment for block-level images and formulas (default: 'center').",
-    )
-    parser.add_argument(
-        "--max-image-width",
-        dest="max_image_width",
-        type=int,
-        default=None,
-        help="Maximum display width for images [px]. Wider images are scaled down for page display. Original size kept for full-size viewing.",
-    )
-    parser.add_argument(
-        "--use-panel",
+        "--line-numbers",
+        dest="line_numbers",
         action="store_true",
         default=False,
-        help="Transform admonitions and alerts into a Confluence custom panel.",
+        help="Inject line numbers in Markdown source to help localize conversion errors.",
     )
     parser.add_argument(
         "--local",
@@ -353,7 +221,7 @@ def _exception_hook(exc_type: type[BaseException], exc_value: BaseException, tra
         ex = ex.__cause__
 
 
-sys.excepthook = _exception_hook
+sys.excepthook = _exception_hook  # spellchecker:disable-line
 
 
 def main() -> None:
@@ -372,25 +240,8 @@ def main() -> None:
         title_prefix=args.title_prefix,
         generated_by=args.generated_by,
         skip_update=args.skip_update,
-        converter=ConverterOptions(
-            heading_anchors=args.heading_anchors,
-            ignore_invalid_url=args.ignore_invalid_url,
-            skip_title_heading=args.skip_title_heading,
-            prefer_raster=args.prefer_raster,
-            render_drawio=args.render_drawio,
-            render_mermaid=args.render_mermaid,
-            render_plantuml=args.render_plantuml,
-            render_latex=args.render_latex,
-            diagram_output_format=args.diagram_output_format,
-            webui_links=args.webui_links,
-            use_panel=args.use_panel,
-            layout=LayoutOptions(
-                image=ImageLayoutOptions(
-                    alignment=args.alignment,
-                    max_width=args.max_image_width,
-                ),
-            ),
-        ),
+        converter=get_options(args, ConverterOptions),
+        line_numbers=args.line_numbers,
     )
     if args.local:
         from .local import LocalConverter