synthkit 0.1.0__py3-none-any.whl

synthkit/__init__.py

@@ -0,0 +1,3 @@
+"""Synthkit: Convert AI-generated Markdown into production-ready documents."""
+
+__version__ = "0.1.0"

synthkit/base.py

@@ -0,0 +1,89 @@
+"""Base converter with shared logic for all Synthkit converters."""
+
+import subprocess
+import sys
+from collections.abc import Callable
+from pathlib import Path
+
+import pypandoc
+
+BASE_FORMAT = "markdown+lists_without_preceding_blankline"
+
+
+def build_format(hard_breaks: bool = False) -> str:
+    fmt = BASE_FORMAT
+    if hard_breaks:
+        fmt += "+hard_line_breaks"
+    return fmt
+
+
+def config_path(tool_name: str, filename: str) -> Path | None:
+    p = Path.home() / ".config" / tool_name / filename
+    return p if p.is_file() else None
+
+
+def bundled_style_css() -> Path:
+    return Path(__file__).parent.parent.parent / "style.css"
+
+
+def cleanup_mermaid_err() -> None:
+    err = Path("mermaid-filter.err")
+    if err.is_file() and err.stat().st_size == 0:
+        err.unlink()
+
+
+def get_pandoc_bin() -> str:
+    return str(pypandoc.get_pandoc_path())
+
+
+def run_pandoc(
+    args: list[str], env: dict[str, str] | None = None
+) -> subprocess.CompletedProcess[bytes]:
+    return subprocess.run([get_pandoc_bin(), *args], capture_output=False, env=env)
+
+
+def mermaid_args(mermaid: bool) -> list[str]:
+    if mermaid:
+        return ["--filter", "mermaid-filter"]
+    return []
+
+
+def batch_convert(
+    files: tuple[str, ...],
+    hard_breaks: bool,
+    mermaid: bool,
+    convert_one: Callable[[Path, bool, bool], None],
+) -> None:
+    if not files:
+        print("No input files provided.", file=sys.stderr)
+        sys.exit(1)
+
+    success = 0
+    fail = 0
+
+    for filepath in files:
+        path = Path(filepath)
+        if path.suffix != ".md":
+            print(f"Skipping non-markdown file: {filepath}")
+            continue
+        if not path.is_file():
+            print(f"Warning: File '{filepath}' not found, skipping.")
+            fail += 1
+            continue
+
+        try:
+            convert_one(path, hard_breaks, mermaid)
+            success += 1
+        except ConversionError as e:
+            print(f"Error: {e}")
+            fail += 1
+
+    if mermaid:
+        cleanup_mermaid_err()
+    print(f"\nDone: {success} succeeded, {fail} failed.")
+    if fail > 0:
+        sys.exit(1)
+
+
+class ConversionError(Exception):
+    pass

synthkit/cli.py

@@ -0,0 +1,106 @@
+"""Click CLI for Synthkit."""
+
+from pathlib import Path
+
+import click
+
+from . import doc, email, html, pdf
+from .base import batch_convert
+
+_MERMAID_HELP = "Enable Mermaid diagram rendering (requires mermaid-filter)."
+
+
+@click.group()
+def main() -> None:
+    """Synthkit: Convert AI-generated Markdown into production-ready documents."""
+
+
+@main.command("doc")
+@click.option("--hard-breaks", is_flag=True, help="Preserve line breaks in source.")
+@click.option("--mermaid", is_flag=True, help=_MERMAID_HELP)
+@click.argument("files", nargs=-1, type=click.Path())
+def doc_subcmd(hard_breaks: bool, mermaid: bool, files: tuple[str, ...]) -> None:
+    """Convert Markdown to Word (.docx)."""
+    batch_convert(files, hard_breaks, mermaid, doc.convert)
+
+
+@main.command("email")
+@click.option("--hard-breaks", is_flag=True, help="Preserve line breaks in source.")
+@click.option("--mermaid", is_flag=True, help=_MERMAID_HELP)
+@click.argument("file", type=click.Path())
+def email_subcmd(hard_breaks: bool, mermaid: bool, file: str) -> None:
+    """Convert Markdown to clipboard-ready email."""
+    email.convert(Path(file), hard_breaks, mermaid)
+
+
+@main.command("html")
+@click.option("--hard-breaks", is_flag=True, help="Preserve line breaks in source.")
+@click.option("--mermaid", is_flag=True, help=_MERMAID_HELP)
+@click.argument("files", nargs=-1, type=click.Path())
+def html_subcmd(hard_breaks: bool, mermaid: bool, files: tuple[str, ...]) -> None:
+    """Convert Markdown to HTML."""
+    batch_convert(files, hard_breaks, mermaid, html.convert)
+
+
+@main.command("pdf")
+@click.option("--hard-breaks", is_flag=True, help="Preserve line breaks in source.")
+@click.option("--mermaid", is_flag=True, help=_MERMAID_HELP)
+@click.argument("files", nargs=-1, type=click.Path())
+def pdf_subcmd(hard_breaks: bool, mermaid: bool, files: tuple[str, ...]) -> None:
+    """Convert Markdown to PDF."""
+    batch_convert(files, hard_breaks, mermaid, pdf.convert)
+
+
+# Backward-compatible standalone entry points
+
+
+def md2doc_cmd() -> None:
+    """Standalone md2doc entry point."""
+
+    @click.command()
+    @click.option("--hard-breaks", is_flag=True, help="Preserve line breaks in source.")
+    @click.option("--mermaid", is_flag=True, help=_MERMAID_HELP)
+    @click.argument("files", nargs=-1, type=click.Path())
+    def _cmd(hard_breaks: bool, mermaid: bool, files: tuple[str, ...]) -> None:
+        batch_convert(files, hard_breaks, mermaid, doc.convert)
+
+    _cmd()
+
+
+def md2email_cmd() -> None:
+    """Standalone md2email entry point."""
+
+    @click.command()
+    @click.option("--hard-breaks", is_flag=True, help="Preserve line breaks in source.")
+    @click.option("--mermaid", is_flag=True, help=_MERMAID_HELP)
+    @click.argument("file", type=click.Path())
+    def _cmd(hard_breaks: bool, mermaid: bool, file: str) -> None:
+        email.convert(Path(file), hard_breaks, mermaid)
+
+    _cmd()
+
+
+def md2html_cmd() -> None:
+    """Standalone md2html entry point."""
+
+    @click.command()
+    @click.option("--hard-breaks", is_flag=True, help="Preserve line breaks in source.")
+    @click.option("--mermaid", is_flag=True, help=_MERMAID_HELP)
+    @click.argument("files", nargs=-1, type=click.Path())
+    def _cmd(hard_breaks: bool, mermaid: bool, files: tuple[str, ...]) -> None:
+        batch_convert(files, hard_breaks, mermaid, html.convert)
+
+    _cmd()
+
+
+def md2pdf_cmd() -> None:
+    """Standalone md2pdf entry point."""
+
+    @click.command()
+    @click.option("--hard-breaks", is_flag=True, help="Preserve line breaks in source.")
+    @click.option("--mermaid", is_flag=True, help=_MERMAID_HELP)
+    @click.argument("files", nargs=-1, type=click.Path())
+    def _cmd(hard_breaks: bool, mermaid: bool, files: tuple[str, ...]) -> None:
+        batch_convert(files, hard_breaks, mermaid, pdf.convert)
+
+    _cmd()

synthkit/doc.py

@@ -0,0 +1,24 @@
+"""Markdown to Word (.docx) conversion."""
+
+from pathlib import Path
+
+from .base import ConversionError, build_format, config_path, mermaid_args, run_pandoc
+
+
+def convert(path: Path, hard_breaks: bool = False, mermaid: bool = False) -> None:
+    output = path.with_suffix(".docx").name
+    fmt = build_format(hard_breaks)
+
+    args = [str(path), "-f", fmt, "-t", "docx", *mermaid_args(mermaid)]
+
+    ref = config_path("md2doc", "reference.docx")
+    if ref:
+        args += [f"--reference-doc={ref}"]
+
+    args += ["-o", output]
+
+    print(f"Converting {path} to {output}...")
+    result = run_pandoc(args)
+    if result.returncode != 0:
+        raise ConversionError(f"Pandoc failed to generate {output}")
+    print(f"Successfully created: {output}")

synthkit/email.py

@@ -0,0 +1,77 @@
+"""Markdown to clipboard email conversion."""
+
+import platform
+import subprocess
+import sys
+from pathlib import Path
+
+import pyperclip
+
+from .base import (
+    build_format,
+    cleanup_mermaid_err,
+    config_path,
+    get_pandoc_bin,
+    mermaid_args,
+)
+
+
+def convert(path: Path, hard_breaks: bool = False, mermaid: bool = False) -> None:
+    # Smart file finding: accept with or without .md extension
+    if not path.is_file() and path.with_suffix(".md").is_file():
+        path = path.with_suffix(".md")
+
+    if not path.is_file():
+        print(f"Error: Could not find file '{path}' or '{path.with_suffix('.md')}'")
+        sys.exit(1)
+
+    fmt = build_format(hard_breaks)
+
+    args = [
+        get_pandoc_bin(),
+        str(path),
+        "-f",
+        fmt,
+        "-t",
+        "html",
+        "-s",
+        "--self-contained",
+        *mermaid_args(mermaid),
+    ]
+
+    style = config_path("md2email", "style.css")
+    if style:
+        args += [f"--css={style}"]
+
+    print(f"Converting {path} to clipboard...")
+    result = subprocess.run(args, capture_output=True, text=True)
+    if result.returncode != 0:
+        print(f"Error: Pandoc failed to convert {path}")
+        if result.stderr:
+            print(result.stderr, file=sys.stderr)
+        sys.exit(1)
+
+    html = result.stdout
+
+    # On macOS, convert to RTF via textutil for richer paste support
+    if platform.system() == "Darwin":
+        try:
+            rtf_result = subprocess.run(
+                ["textutil", "-stdin", "-format", "html", "-convert", "rtf", "-stdout"],
+                input=html,
+                capture_output=True,
+                text=True,
+            )
+            if rtf_result.returncode == 0:
+                subprocess.run(["pbcopy"], input=rtf_result.stdout, text=True, check=True)
+                print("Success! Formatted text copied to clipboard.")
+                if mermaid:
+                    cleanup_mermaid_err()
+                return
+        except FileNotFoundError:
+            pass  # Fall through to pyperclip
+
+    pyperclip.copy(html)
+    print("Success! HTML copied to clipboard.")
+    if mermaid:
+        cleanup_mermaid_err()

synthkit/html.py

@@ -0,0 +1,24 @@
+"""Markdown to HTML conversion."""
+
+from pathlib import Path
+
+from .base import ConversionError, build_format, config_path, mermaid_args, run_pandoc
+
+
+def convert(path: Path, hard_breaks: bool = False, mermaid: bool = False) -> None:
+    output = path.with_suffix(".html").name
+    fmt = build_format(hard_breaks)
+
+    args = [str(path), "-f", fmt, "-t", "html", "-s", *mermaid_args(mermaid)]
+
+    style = config_path("md2html", "style.css")
+    if style:
+        args += [f"--css={style}", "--self-contained"]
+
+    args += ["-o", output]
+
+    print(f"Converting {path} to {output}...")
+    result = run_pandoc(args)
+    if result.returncode != 0:
+        raise ConversionError(f"Pandoc failed to generate {output}")
+    print(f"Successfully created: {output}")

synthkit/pdf.py

@@ -0,0 +1,134 @@
+"""Markdown to PDF conversion via weasyprint."""
+
+import os
+import platform
+import shutil
+import subprocess
+from pathlib import Path
+
+from .base import ConversionError, build_format, config_path, mermaid_args, run_pandoc
+
+_INSTALL_HELP = {
+    "Darwin": ("On macOS, install them with:\n  brew install pango"),
+    "Linux": (
+        "On Ubuntu/Debian, install them with:\n"
+        "  sudo apt install libpango1.0-dev libcairo2-dev libgdk-pixbuf2.0-dev\n"
+        "On Fedora/RHEL:\n"
+        "  sudo dnf install pango-devel cairo-devel gdk-pixbuf2-devel"
+    ),
+}
+
+_WEASYPRINT_DOCS = "https://doc.courtbouillon.org/weasyprint/stable/first_steps.html#installation"
+
+
+def _brew_lib_path() -> str | None:
+    """Return Homebrew lib directory if available."""
+    try:
+        result = subprocess.run(["brew", "--prefix"], capture_output=True, timeout=5)
+        if result.returncode == 0:
+            prefix = result.stdout.decode().strip()
+            lib_dir = os.path.join(prefix, "lib")
+            if os.path.isdir(lib_dir):
+                return lib_dir
+    except (FileNotFoundError, subprocess.TimeoutExpired):
+        pass
+    return None
+
+
+def _weasyprint_env() -> dict[str, str] | None:
+    """Build environment with library paths for weasyprint on macOS."""
+    if platform.system() != "Darwin":
+        return None
+    brew_lib = _brew_lib_path()
+    if not brew_lib:
+        return None
+    env = os.environ.copy()
+    existing = env.get("DYLD_FALLBACK_LIBRARY_PATH", "")
+    if brew_lib not in existing:
+        env["DYLD_FALLBACK_LIBRARY_PATH"] = f"{brew_lib}:{existing}" if existing else brew_lib
+    return env
+
+
+def _check_weasyprint_deps() -> dict[str, str] | None:
+    """Verify weasyprint's system deps are available. Returns env dict if needed."""
+    env = None
+    try:
+        result = subprocess.run(
+            ["weasyprint", "--info"],
+            capture_output=True,
+            timeout=10,
+        )
+        if result.returncode != 0:
+            stderr = result.stderr.decode(errors="replace")
+            if "gobject" in stderr or "pango" in stderr or "cairo" in stderr:
+                # Try again with Homebrew library path on macOS
+                env = _weasyprint_env()
+                if env:
+                    retry = subprocess.run(
+                        ["weasyprint", "--info"],
+                        capture_output=True,
+                        timeout=10,
+                        env=env,
+                    )
+                    if retry.returncode == 0:
+                        return env  # libs found with env fix
+
+                # Still broken — report helpful error
+                system = platform.system()
+                hint = _INSTALL_HELP.get(system, "")
+                msg = (
+                    "weasyprint is installed but cannot find its system libraries "
+                    "(pango, cairo, gobject).\n"
+                )
+                if hint:
+                    msg += f"\n{hint}\n"
+                msg += f"\nFor full details see: {_WEASYPRINT_DOCS}"
+                raise ConversionError(msg)
+    except FileNotFoundError:
+        pass  # handled by the shutil.which check below
+    except subprocess.TimeoutExpired:
+        pass  # let pandoc attempt it
+    return env
+
+
+def convert(path: Path, hard_breaks: bool = False, mermaid: bool = False) -> None:
+    output = path.with_suffix(".pdf").name
+    fmt = build_format(hard_breaks)
+
+    if not shutil.which("weasyprint"):
+        raise ConversionError(
+            "weasyprint not found on PATH. Install it with: pip install weasyprint"
+        )
+
+    env = _check_weasyprint_deps()
+
+    args = [
+        str(path),
+        "-f",
+        fmt,
+        "-t",
+        "html",
+        "--pdf-engine=weasyprint",
+        *mermaid_args(mermaid),
+    ]
+
+    style = config_path("md2pdf", "style.css")
+    if style:
+        args += [f"--css={style}"]
+
+    args += ["-o", output]
+
+    print(f"Converting {path} to {output}...")
+    result = run_pandoc(args, env=env)
+    if result.returncode != 0:
+        system = platform.system()
+        hint = _INSTALL_HELP.get(system, "")
+        msg = f"Pandoc failed to generate {output}"
+        if hint:
+            msg += (
+                "\n\nThis may be caused by missing system dependencies for weasyprint.\n"
+                f"{hint}\n"
+                f"\nFor full details see: {_WEASYPRINT_DOCS}"
+            )
+        raise ConversionError(msg)
+    print(f"Successfully created: {output}")

synthkit-0.1.0.dist-info/METADATA

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: synthkit
+Version: 0.1.0
+Summary: Convert AI-generated Markdown into production-ready documents
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: click
+Requires-Dist: pypandoc-binary
+Requires-Dist: pyperclip
+Requires-Dist: weasyprint
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Synthkit
+
+[![PyPI](https://img.shields.io/pypi/v/synthkit.svg)](https://pypi.org/project/synthkit/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://github.com/rappdw/synthkit/actions/workflows/tests.yml/badge.svg)](https://github.com/rappdw/synthkit/actions/workflows/tests.yml)
+[![Coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/rappdw/02d0a91962d09fd9473da34fccd76237/raw/synthkit-coverage.json)](https://github.com/rappdw/synthkit/actions/workflows/tests.yml)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)
+
+A "last-mile" toolkit for working with generative AI. Synthkit bridges the gap between raw LLM output and production-ready deliverables through:
+
+- **Document conversion** — Transform AI-generated Markdown into Word, HTML, PDF, or clipboard-ready email
+- **Prompt templates** — Curated templates for structured AI interactions (reports, emails, analysis)
+- **Guidelines** — Reference standards and style guides to steer AI output quality
+
+## Document Conversion
+
+### Installation
+
+```bash
+# Run directly with uvx (no install needed)
+uvx synthkit html document.md
+
+# Or install globally
+uv tool install synthkit
+
+# Or install with pip
+pip install synthkit
+```
+
+Pandoc is bundled automatically via [`pypandoc_binary`](https://pypi.org/project/pypandoc-binary/) — no separate install needed.
+
+#### System dependencies for PDF
+
+PDF conversion uses [WeasyPrint](https://weasyprint.org/), which requires system libraries:
+
+| Platform | Install command |
+|----------|----------------|
+| **macOS** | `brew install pango` |
+| **Ubuntu/Debian** | `apt install libpango1.0-dev libcairo2-dev libgdk-pixbuf2.0-dev` |
+| **Windows** | See [WeasyPrint docs](https://doc.courtbouillon.org/weasyprint/stable/first_steps.html#windows) |
+
+`doc`, `html`, and `email` commands work without these.
+
+### Usage
+
+#### Unified CLI
+
+```bash
+synthkit doc report.md           # → report.docx
+synthkit html report.md          # → report.html
+synthkit pdf report.md           # → report.pdf
+synthkit email report.md         # → clipboard
+
+# Batch processing
+synthkit doc *.md
+synthkit html *.md --hard-breaks
+
+# Mermaid diagrams (requires mermaid-filter)
+synthkit html report.md --mermaid
+```
+
+#### Backward-compatible commands
+
+```bash
+md2doc report.md
+md2html report.md
+md2pdf report.md
+md2email report.md
+```
+
+#### Options
+
+| Flag | Description |
+|------|-------------|
+| `--hard-breaks` | Preserve line breaks from source markdown |
+| `--mermaid` | Enable Mermaid diagram rendering (requires [`mermaid-filter`](https://github.com/raghur/mermaid-filter)) |
+
+### Configuration
+
+Each converter looks for optional config files under `~/.config/<toolname>/`:
+
+| Converter | Config Files |
+|-----------|-------------|
+| `doc` | `~/.config/md2doc/reference.docx` |
+| `email` | `~/.config/md2email/style.css` |
+| `html` | `~/.config/md2html/style.css` |
+| `pdf` | `~/.config/md2pdf/style.css` |
+
+## Prompt Templates
+
+The `prompt-templates/` directory contains curated prompt templates for structured AI interactions. These are optimized for Markdown-first responses to ensure compatibility with the document conversion tools.
+
+Copy the contents of any template into your LLM of choice (Claude, Gemini, ChatGPT, etc.) to get consistently structured output ready for conversion.
+
+## Guidelines
+
+The `guidelines/` directory contains reference standards and style guides that can be provided as context to AI models to steer output quality and consistency.
+
+## Testing
+
+```bash
+# Run tests
+uv run --extra dev pytest
+
+# With coverage
+uv run --extra dev pytest --cov=synthkit --cov-report=term-missing
+```
+
+Tests run automatically on push/PR to `main` across Python 3.10-3.13 on Linux, macOS, and Windows.
+
+## Repository Structure
+
+```
+├── .github/workflows/
+│   ├── tests.yml          # CI: test on push/PR to main
+│   └── publish.yml        # CD: publish to PyPI on release
+├── pyproject.toml
+├── src/synthkit/          # Python package
+│   ├── cli.py             # Click CLI with subcommands
+│   ├── base.py            # Shared conversion logic
+│   ├── doc.py             # Word conversion
+│   ├── email.py           # Email clipboard conversion
+│   ├── html.py            # HTML conversion
+│   └── pdf.py             # PDF conversion (via WeasyPrint)
+├── tests/                 # Test suite (pytest)
+│   ├── conftest.py        # Shared fixtures
+│   ├── test_base.py       # Base module tests
+│   ├── test_cli.py        # CLI + integration tests
+│   ├── test_doc.py        # Word converter tests
+│   ├── test_email.py      # Email converter tests
+│   ├── test_html.py       # HTML converter tests
+│   └── test_pdf.py        # PDF converter tests
+├── style.css              # Default stylesheet
+├── prompt-templates/      # AI interaction prompt templates
+└── guidelines/            # Reference guidelines
+```
+
+## Dependencies
+
+| Package | Purpose | Bundled? |
+|---------|---------|----------|
+| [`click`](https://click.palletsprojects.com/) | CLI framework | pip |
+| [`pypandoc_binary`](https://pypi.org/project/pypandoc-binary/) | Pandoc document converter | pip (includes binary) |
+| [`pyperclip`](https://pypi.org/project/pyperclip/) | Cross-platform clipboard | pip |
+| [`weasyprint`](https://weasyprint.org/) | PDF engine | pip (needs system libs) |
+| [`mermaid-filter`](https://github.com/raghur/mermaid-filter) | Mermaid diagrams | Optional, external |

synthkit-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+synthkit/__init__.py,sha256=MdHu9RiZYInmSDUdVZAKcZDCixIcdsM49x5cJgwHqIk,102
+synthkit/base.py,sha256=rjcpiCTepgizEs2ygNxTIR3ZHBBA8Z8a7fKwbwx0_dI,2147
+synthkit/cli.py,sha256=YYAEKZ1PxvZVdhIHv-4xjjAYb_bf34HDHoB48WCDGoo,3800
+synthkit/doc.py,sha256=eSL6lHbC_bPblMY2MDU3LIN5xC4GpedKm9wOuRivzg0,752
+synthkit/email.py,sha256=WfjrYAewg_qYFz6LW6CtQwLdfGnAAYyTLRq6xB_KQlo,2152
+synthkit/html.py,sha256=BABUCG_gX-WWrfrOo4a_AmAtdfevtmxXRLJaxVwTpWk,762
+synthkit/pdf.py,sha256=UpGQSRlFxxYTDJCN6HqfoOpN5pbcNtdSWTHguhnWbtI,4468
+synthkit-0.1.0.dist-info/METADATA,sha256=sqU82aulOLONJ9Zei-xrBqZA9M24VuJK7-k6SByQ8aI,6422
+synthkit-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+synthkit-0.1.0.dist-info/entry_points.txt,sha256=zB7h-Oabqqkac6L2XPCF-JWDp3IAPy-_7S-1Qe9BN6A,185
+synthkit-0.1.0.dist-info/RECORD,,

synthkit-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

synthkit-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,6 @@
+[console_scripts]
+md2doc = synthkit.cli:md2doc_cmd
+md2email = synthkit.cli:md2email_cmd
+md2html = synthkit.cli:md2html_cmd
+md2pdf = synthkit.cli:md2pdf_cmd
+synthkit = synthkit.cli:main