tomd-cli 0.1.0__py3-none-any.whl

tomd/__init__.py

@@ -0,0 +1,5 @@
+"""tomd-cli: Convert Office files to Markdown using MarkItDown."""
+
+from tomd.converter import convert_file, convert_dir, strip_base64_images
+
+__all__ = ["convert_file", "convert_dir", "strip_base64_images"]

tomd/cli.py

@@ -0,0 +1,55 @@
+"""Command-line interface for tomd."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+from tomd.converter import SUPPORTED_EXTENSIONS, convert_dir, convert_file
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="tomd",
+        description="Convert Office files to Markdown using MarkItDown.",
+    )
+    parser.add_argument(
+        "input",
+        help="file or directory to convert",
+    )
+    parser.add_argument(
+        "-o", "--output",
+        help="output file or directory path",
+    )
+    parser.add_argument(
+        "--dir",
+        action="store_true",
+        dest="is_dir",
+        help="treat input as a directory and convert all supported files",
+    )
+    fmt = ", ".join(sorted(SUPPORTED_EXTENSIONS))
+    parser.epilog = f"Supported formats: {fmt}"
+    return parser
+
+
+def main(argv: list[str] | None = None) -> None:
+    parser = _build_parser()
+    args = parser.parse_args(argv)
+
+    try:
+        if args.is_dir:
+            results = convert_dir(args.input, args.output)
+            if not results:
+                print(f"No convertible files found in {args.input}")
+            else:
+                for dest in results:
+                    print(f"Converted: {dest}")
+        else:
+            dest = convert_file(args.input, args.output)
+            print(f"Converted: {dest}")
+    except (FileNotFoundError, NotADirectoryError) as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)
+    except Exception as e:
+        print(f"Conversion failed: {e}", file=sys.stderr)
+        sys.exit(1)

tomd/converter.py

@@ -0,0 +1,76 @@
+"""Core conversion logic."""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+from markitdown import MarkItDown
+
+SUPPORTED_EXTENSIONS = {".pptx", ".docx", ".xlsx", ".pdf"}
+
+
+def strip_base64_images(text: str) -> str:
+    """Replace embedded base64 image data with a placeholder."""
+    return re.sub(
+        r'!\[([^\]]*)\]\(data:image/[^)]+\)',
+        lambda m: f'![{m.group(1)}]()',
+        text,
+    )
+
+
+def convert_file(
+    input_path: str | Path,
+    output_path: str | Path | None = None,
+) -> Path:
+    """Convert a single file to Markdown.
+
+    Returns the path to the generated Markdown file.
+    Raises FileNotFoundError if input does not exist.
+    """
+    src = Path(input_path).resolve()
+    if not src.is_file():
+        raise FileNotFoundError(f"File not found: {input_path}")
+
+    dest = Path(output_path).resolve() if output_path else src.with_suffix(".md")
+
+    md = MarkItDown()
+    result = md.convert(str(src))
+    content = strip_base64_images(result.text_content)
+
+    dest.parent.mkdir(parents=True, exist_ok=True)
+    dest.write_text(content, encoding="utf-8")
+    return dest
+
+
+def convert_dir(
+    input_dir: str | Path,
+    output_dir: str | Path | None = None,
+) -> list[Path]:
+    """Convert all supported files in a directory to Markdown.
+
+    Returns a list of generated Markdown file paths.
+    Raises NotADirectoryError if input is not a directory.
+    """
+    src_dir = Path(input_dir).resolve()
+    if not src_dir.is_dir():
+        raise NotADirectoryError(f"Directory not found: {input_dir}")
+
+    dest_dir = Path(output_dir).resolve() if output_dir else src_dir / "output"
+    dest_dir.mkdir(parents=True, exist_ok=True)
+
+    files = sorted(
+        f for f in src_dir.iterdir() if f.suffix.lower() in SUPPORTED_EXTENSIONS
+    )
+    if not files:
+        return []
+
+    md = MarkItDown()
+    results: list[Path] = []
+    for f in files:
+        dest = dest_dir / f.with_suffix(".md").name
+        result = md.convert(str(f))
+        dest.write_text(strip_base64_images(result.text_content), encoding="utf-8")
+        results.append(dest)
+
+    return results

tomd_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: tomd-cli
+Version: 0.1.0
+Summary: Convert Office files (.docx, .pptx, .xlsx, .pdf) to Markdown using MarkItDown
+Project-URL: Homepage, https://github.com/nakamurakohki/tomd-cli
+Project-URL: Repository, https://github.com/nakamurakohki/tomd-cli
+Project-URL: Issues, https://github.com/nakamurakohki/tomd-cli/issues
+Author: Kohki Nakamura
+License-Expression: MIT
+License-File: LICENSE
+Keywords: converter,docx,markdown,pdf,pptx,xlsx
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Text Processing :: Markup :: Markdown
+Requires-Python: >=3.10
+Requires-Dist: markitdown>=0.0.2
+Description-Content-Type: text/markdown
+
+# tomd-cli
+
+Convert Office files to Markdown using [MarkItDown](https://github.com/microsoft/markitdown).
+
+## Supported formats
+
+- `.docx` (Word)
+- `.pptx` (PowerPoint)
+- `.xlsx` (Excel)
+- `.pdf`
+
+## Installation
+
+```bash
+pip install tomd-cli
+```
+
+## Usage
+
+### CLI
+
+```bash
+# Convert a single file
+tomd document.docx
+
+# Specify output path
+tomd document.docx -o output.md
+
+# Convert all files in a directory
+tomd --dir ./documents/
+
+# Convert directory with custom output
+tomd --dir ./documents/ -o ./markdown/
+```
+
+### Python API
+
+```python
+from tomd import convert_file, convert_dir
+
+# Single file
+output_path = convert_file("document.docx")
+output_path = convert_file("document.docx", "output.md")
+
+# Directory
+output_paths = convert_dir("./documents/")
+output_paths = convert_dir("./documents/", "./markdown/")
+```
+
+## License
+
+MIT

tomd_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+tomd/__init__.py,sha256=Ac-PrtkEuP0iDn0JOW0p2hGoWkP-3Y2rouI18_zo7r4,208
+tomd/cli.py,sha256=tuBtF9xATgmb2yaL8ltV1Qg1KKDtH-kC4Qv7jWB_I9U,1602
+tomd/converter.py,sha256=E1k8H5Ts04BkZSW9d-Lu5Mn8WbnPYgXgUDw3gpaiwL8,2123
+tomd_cli-0.1.0.dist-info/METADATA,sha256=0wgheRF0k117esqNuLuMRzHQpoIbhzf2re5iWGVvV2E,1916
+tomd_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+tomd_cli-0.1.0.dist-info/entry_points.txt,sha256=SRsPlcMLYXLwyR7AtdVhClEpmcPCBa3eyeY869SmPrA,39
+tomd_cli-0.1.0.dist-info/licenses/LICENSE,sha256=oEfiqyCkmXNw2hNSHZIJzxCkZEc-9j8kJpU4s6AQTXk,1071
+tomd_cli-0.1.0.dist-info/RECORD,,

tomd_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

tomd_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tomd = tomd.cli:main

tomd_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kohki Nakamura
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.