agent-markdown-pdf 0.2.0__tar.gz → 0.2.2__tar.gz

{agent_markdown_pdf-0.2.0 → agent_markdown_pdf-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-markdown-pdf
-Version: 0.2.0
+Version: 0.2.2
 Summary: Agent-friendly Markdown-to-PDF CLI with HTML preview and JSON diagnostics
 Author: rainp
 License-Expression: MIT
@@ -323,31 +323,40 @@ rendering is available.
 WeasyPrint also needs native libraries such as Pango, GLib, and Cairo. Linux
 and macOS package managers usually provide them through system packages.
 
-The default theme names `Microsoft YaHei` first in its CSS on every platform,
-including Linux. If that font is installed in the environment, WeasyPrint will
-use it. If it is missing, the theme falls back to `PingFang SC`,
-`Noto Sans SC`, `Noto Sans CJK SC`, `Source Han Sans SC`, and other available
-CJK fonts.
+The default theme uses a PDFium-safe Latin-first font stack. Latin fonts are
+listed before CJK fonts so ASCII digits, dates, versions, and page numbers are
+not embedded into CJK font subsets that some Chrome/PDFium renderers handle
+poorly. Chinese text still falls back to the CJK side of the stack.
 
-For stable CJK output in Linux containers or agent sandboxes where Microsoft
-YaHei is not installed, install the CJK font you want to use. Noto CJK is a
-practical fallback on Debian or Ubuntu:
-
-Emoji are rendered through the system emoji font. The default theme prefers
-`Segoe UI Emoji` for emoji spans on every platform, including Linux. Windows
-usually provides it; Linux containers only get the same glyphs if the runtime
-provides that font. If Segoe UI Emoji is not available, the theme falls back to
-`Apple Color Emoji`, `Noto Emoji`, `Noto Color Emoji`, and other installed emoji
-fonts. Whether the final PDF keeps color emoji still depends on WeasyPrint,
-Pango/Cairo, and the PDF viewer.
-
-On Debian or Ubuntu, this is a practical open-font fallback baseline:
+For Linux containers or agent sandboxes, use open fonts that can be installed
+from the distribution package manager. The recommended baseline is:
 
 ```shell
-sudo apt-get install -y fonts-noto-cjk fonts-noto-color-emoji fonts-stix fonts-dejavu-core
+sudo apt-get install -y --no-install-recommends \
+  fontconfig \
+  fonts-liberation \
+  fonts-dejavu-core \
+  fonts-noto-cjk \
+  fonts-stix
 fc-cache -f
 ```
 
+With that setup, Linux output uses `Liberation Sans` / `DejaVu Sans` for Latin
+text and digits, `Noto Sans CJK SC` for Chinese, and STIX for math fallback.
+Microsoft YaHei and Segoe UI Emoji are not Linux runtime requirements and are
+not installed or distributed by `mdtopdf`.
+
+Code blocks prefer `Cascadia Mono` / `Cascadia Code`, then `Consolas`,
+`Noto Sans Mono CJK SC`, `Liberation Mono`, and `DejaVu Sans Mono`. On Debian,
+`fonts-cascadia-code` provides Cascadia fonts; on other Linux images, provide
+Cascadia Code yourself or let the theme fall back to the installed monospace
+fonts.
+
+Emoji are rendered through the system emoji font. On Linux, prefer monochrome
+`Noto Emoji` for stable PDF layout. `Noto Color Emoji` is easier to install from
+many distro package managers and is safe to use as a fallback, but color emoji
+often render too small or misaligned in WeasyPrint/Pango/Cairo/PDFium output.
+
 On Windows, install the native libraries separately. A common MSYS2 setup is:
 
 ```powershell
@@ -368,7 +377,7 @@ setx WEASYPRINT_DLL_DIRECTORIES "C:\msys64\mingw64\bin"
 ```
 
 Run this after installation. The JSON output also reports whether recommended
-CJK, emoji, monospace, and math fallback fonts are present:
+Latin, CJK, emoji, monospace, and math fallback fonts are present:
 
 ```shell
 mdtopdf doctor --json
@@ -396,6 +405,8 @@ MIT. Bundled KaTeX assets are also distributed under the MIT license; see
 `mdtopdf/vendor/katex/LICENSE`.
 
 `mdtopdf` does not bundle CJK body fonts, emoji fonts, or proprietary system
-fonts. The default theme references local system fonts such as Microsoft YaHei,
-PingFang SC, Segoe UI, Segoe UI Emoji, Noto Emoji, Noto Color Emoji, and Consolas, but
-those font files come from the user's operating system or runtime environment.
+fonts. The default theme references local system fonts such as Segoe UI,
+Microsoft YaHei, PingFang SC, Segoe UI Emoji, Noto Sans CJK SC,
+Noto Emoji, Noto Color Emoji, Cascadia Code, and Consolas, but those font files come from
+the user's operating system or runtime environment. Public Linux images should
+prefer the open-font baseline above.

{agent_markdown_pdf-0.2.0 → agent_markdown_pdf-0.2.2}/README.md

@@ -282,31 +282,40 @@ rendering is available.
 WeasyPrint also needs native libraries such as Pango, GLib, and Cairo. Linux
 and macOS package managers usually provide them through system packages.
 
-The default theme names `Microsoft YaHei` first in its CSS on every platform,
-including Linux. If that font is installed in the environment, WeasyPrint will
-use it. If it is missing, the theme falls back to `PingFang SC`,
-`Noto Sans SC`, `Noto Sans CJK SC`, `Source Han Sans SC`, and other available
-CJK fonts.
-
-For stable CJK output in Linux containers or agent sandboxes where Microsoft
-YaHei is not installed, install the CJK font you want to use. Noto CJK is a
-practical fallback on Debian or Ubuntu:
-
-Emoji are rendered through the system emoji font. The default theme prefers
-`Segoe UI Emoji` for emoji spans on every platform, including Linux. Windows
-usually provides it; Linux containers only get the same glyphs if the runtime
-provides that font. If Segoe UI Emoji is not available, the theme falls back to
-`Apple Color Emoji`, `Noto Emoji`, `Noto Color Emoji`, and other installed emoji
-fonts. Whether the final PDF keeps color emoji still depends on WeasyPrint,
-Pango/Cairo, and the PDF viewer.
-
-On Debian or Ubuntu, this is a practical open-font fallback baseline:
+The default theme uses a PDFium-safe Latin-first font stack. Latin fonts are
+listed before CJK fonts so ASCII digits, dates, versions, and page numbers are
+not embedded into CJK font subsets that some Chrome/PDFium renderers handle
+poorly. Chinese text still falls back to the CJK side of the stack.
+
+For Linux containers or agent sandboxes, use open fonts that can be installed
+from the distribution package manager. The recommended baseline is:
 
 ```shell
-sudo apt-get install -y fonts-noto-cjk fonts-noto-color-emoji fonts-stix fonts-dejavu-core
+sudo apt-get install -y --no-install-recommends \
+  fontconfig \
+  fonts-liberation \
+  fonts-dejavu-core \
+  fonts-noto-cjk \
+  fonts-stix
 fc-cache -f
 ```
 
+With that setup, Linux output uses `Liberation Sans` / `DejaVu Sans` for Latin
+text and digits, `Noto Sans CJK SC` for Chinese, and STIX for math fallback.
+Microsoft YaHei and Segoe UI Emoji are not Linux runtime requirements and are
+not installed or distributed by `mdtopdf`.
+
+Code blocks prefer `Cascadia Mono` / `Cascadia Code`, then `Consolas`,
+`Noto Sans Mono CJK SC`, `Liberation Mono`, and `DejaVu Sans Mono`. On Debian,
+`fonts-cascadia-code` provides Cascadia fonts; on other Linux images, provide
+Cascadia Code yourself or let the theme fall back to the installed monospace
+fonts.
+
+Emoji are rendered through the system emoji font. On Linux, prefer monochrome
+`Noto Emoji` for stable PDF layout. `Noto Color Emoji` is easier to install from
+many distro package managers and is safe to use as a fallback, but color emoji
+often render too small or misaligned in WeasyPrint/Pango/Cairo/PDFium output.
+
 On Windows, install the native libraries separately. A common MSYS2 setup is:
 
 ```powershell
@@ -327,7 +336,7 @@ setx WEASYPRINT_DLL_DIRECTORIES "C:\msys64\mingw64\bin"
 ```
 
 Run this after installation. The JSON output also reports whether recommended
-CJK, emoji, monospace, and math fallback fonts are present:
+Latin, CJK, emoji, monospace, and math fallback fonts are present:
 
 ```shell
 mdtopdf doctor --json
@@ -355,6 +364,8 @@ MIT. Bundled KaTeX assets are also distributed under the MIT license; see
 `mdtopdf/vendor/katex/LICENSE`.
 
 `mdtopdf` does not bundle CJK body fonts, emoji fonts, or proprietary system
-fonts. The default theme references local system fonts such as Microsoft YaHei,
-PingFang SC, Segoe UI, Segoe UI Emoji, Noto Emoji, Noto Color Emoji, and Consolas, but
-those font files come from the user's operating system or runtime environment.
+fonts. The default theme references local system fonts such as Segoe UI,
+Microsoft YaHei, PingFang SC, Segoe UI Emoji, Noto Sans CJK SC,
+Noto Emoji, Noto Color Emoji, Cascadia Code, and Consolas, but those font files come from
+the user's operating system or runtime environment. Public Linux images should
+prefer the open-font baseline above.

{agent_markdown_pdf-0.2.0 → agent_markdown_pdf-0.2.2}/agent_markdown_pdf.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-markdown-pdf
-Version: 0.2.0
+Version: 0.2.2
 Summary: Agent-friendly Markdown-to-PDF CLI with HTML preview and JSON diagnostics
 Author: rainp
 License-Expression: MIT
@@ -323,31 +323,40 @@ rendering is available.
 WeasyPrint also needs native libraries such as Pango, GLib, and Cairo. Linux
 and macOS package managers usually provide them through system packages.
 
-The default theme names `Microsoft YaHei` first in its CSS on every platform,
-including Linux. If that font is installed in the environment, WeasyPrint will
-use it. If it is missing, the theme falls back to `PingFang SC`,
-`Noto Sans SC`, `Noto Sans CJK SC`, `Source Han Sans SC`, and other available
-CJK fonts.
+The default theme uses a PDFium-safe Latin-first font stack. Latin fonts are
+listed before CJK fonts so ASCII digits, dates, versions, and page numbers are
+not embedded into CJK font subsets that some Chrome/PDFium renderers handle
+poorly. Chinese text still falls back to the CJK side of the stack.
 
-For stable CJK output in Linux containers or agent sandboxes where Microsoft
-YaHei is not installed, install the CJK font you want to use. Noto CJK is a
-practical fallback on Debian or Ubuntu:
-
-Emoji are rendered through the system emoji font. The default theme prefers
-`Segoe UI Emoji` for emoji spans on every platform, including Linux. Windows
-usually provides it; Linux containers only get the same glyphs if the runtime
-provides that font. If Segoe UI Emoji is not available, the theme falls back to
-`Apple Color Emoji`, `Noto Emoji`, `Noto Color Emoji`, and other installed emoji
-fonts. Whether the final PDF keeps color emoji still depends on WeasyPrint,
-Pango/Cairo, and the PDF viewer.
-
-On Debian or Ubuntu, this is a practical open-font fallback baseline:
+For Linux containers or agent sandboxes, use open fonts that can be installed
+from the distribution package manager. The recommended baseline is:
 
 ```shell
-sudo apt-get install -y fonts-noto-cjk fonts-noto-color-emoji fonts-stix fonts-dejavu-core
+sudo apt-get install -y --no-install-recommends \
+  fontconfig \
+  fonts-liberation \
+  fonts-dejavu-core \
+  fonts-noto-cjk \
+  fonts-stix
 fc-cache -f
 ```
 
+With that setup, Linux output uses `Liberation Sans` / `DejaVu Sans` for Latin
+text and digits, `Noto Sans CJK SC` for Chinese, and STIX for math fallback.
+Microsoft YaHei and Segoe UI Emoji are not Linux runtime requirements and are
+not installed or distributed by `mdtopdf`.
+
+Code blocks prefer `Cascadia Mono` / `Cascadia Code`, then `Consolas`,
+`Noto Sans Mono CJK SC`, `Liberation Mono`, and `DejaVu Sans Mono`. On Debian,
+`fonts-cascadia-code` provides Cascadia fonts; on other Linux images, provide
+Cascadia Code yourself or let the theme fall back to the installed monospace
+fonts.
+
+Emoji are rendered through the system emoji font. On Linux, prefer monochrome
+`Noto Emoji` for stable PDF layout. `Noto Color Emoji` is easier to install from
+many distro package managers and is safe to use as a fallback, but color emoji
+often render too small or misaligned in WeasyPrint/Pango/Cairo/PDFium output.
+
 On Windows, install the native libraries separately. A common MSYS2 setup is:
 
 ```powershell
@@ -368,7 +377,7 @@ setx WEASYPRINT_DLL_DIRECTORIES "C:\msys64\mingw64\bin"
 ```
 
 Run this after installation. The JSON output also reports whether recommended
-CJK, emoji, monospace, and math fallback fonts are present:
+Latin, CJK, emoji, monospace, and math fallback fonts are present:
 
 ```shell
 mdtopdf doctor --json
@@ -396,6 +405,8 @@ MIT. Bundled KaTeX assets are also distributed under the MIT license; see
 `mdtopdf/vendor/katex/LICENSE`.
 
 `mdtopdf` does not bundle CJK body fonts, emoji fonts, or proprietary system
-fonts. The default theme references local system fonts such as Microsoft YaHei,
-PingFang SC, Segoe UI, Segoe UI Emoji, Noto Emoji, Noto Color Emoji, and Consolas, but
-those font files come from the user's operating system or runtime environment.
+fonts. The default theme references local system fonts such as Segoe UI,
+Microsoft YaHei, PingFang SC, Segoe UI Emoji, Noto Sans CJK SC,
+Noto Emoji, Noto Color Emoji, Cascadia Code, and Consolas, but those font files come from
+the user's operating system or runtime environment. Public Linux images should
+prefer the open-font baseline above.

{agent_markdown_pdf-0.2.0 → agent_markdown_pdf-0.2.2}/mdtopdf/core/doctor.py

@@ -4,6 +4,8 @@ import ctypes
 import importlib
 import os
 import platform
+import shutil
+import subprocess
 import sys
 from pathlib import Path
 from typing import Any
@@ -50,10 +52,11 @@ def run_doctor() -> dict[str, Any]:
 
     add_weasyprint_dll_directories()
 
+    platform_system = platform.system()
     result: dict[str, Any] = {
         "ok": False,
         "platform": {
-            "system": platform.system(),
+            "system": platform_system,
             "release": platform.release(),
             "machine": platform.machine(),
         },
@@ -67,7 +70,7 @@ def run_doctor() -> dict[str, Any]:
         "packages": {},
         "tools": {},
         "native_libraries": _inspect_native_libraries(),
-        "fonts": _inspect_fonts(),
+        "fonts": _inspect_fonts(platform_system),
         "recommendations": [],
     }
 
@@ -76,6 +79,8 @@ def run_doctor() -> dict[str, Any]:
     result["packages"]["latex2mathml"] = _check_python_package("latex2mathml")
     result["packages"]["matplotlib"] = _check_python_package("matplotlib")
     result["tools"]["mermaid"] = inspect_mermaid_backend()
+    if result["platform"]["system"] == "Linux":
+        result["tools"]["fontconfig"] = _inspect_fontconfig()
     result["ok"] = all(info["ok"] for info in result["packages"].values())
     result["recommendations"] = _recommendations(result)
     return result
@@ -207,12 +212,42 @@ def _env_dll_directories() -> list[str]:
     return [part.strip() for part in raw.split(os.pathsep) if part.strip()]
 
 
-def _inspect_fonts() -> dict[str, Any]:
-    return inspect_recommended_font_groups()
+def _inspect_fonts(platform_system: str | None = None) -> dict[str, Any]:
+    return inspect_recommended_font_groups(platform_system)
+
+
+def _inspect_fontconfig() -> dict[str, Any]:
+    executable = shutil.which("fc-match")
+    result: dict[str, Any] = {
+        "ok": False,
+        "executable": executable,
+        "sample": None,
+        "error": None,
+    }
+    if not executable:
+        result["error"] = "fc-match was not found on PATH."
+        return result
+
+    try:
+        proc = subprocess.run(
+            [executable, "-f", "%{family}\n", "sans-serif"],
+            check=True,
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+    except Exception as exc:
+        result["error"] = f"{type(exc).__name__}: {exc}"
+        return result
+
+    result["sample"] = proc.stdout.strip() or None
+    result["ok"] = True
+    return result
 
 
 def _recommendations(result: dict[str, Any]) -> list[str]:
     recommendations: list[str] = []
+    is_linux = result.get("platform", {}).get("system") == "Linux"
     package_info = result.get("packages", {}).get("weasyprint", {})
     if not package_info.get("ok"):
         recommendations.append("Install Python dependencies with: python -m pip install agent-markdown-pdf")
@@ -232,30 +267,80 @@ def _recommendations(result: dict[str, Any]) -> list[str]:
             "Optional: install Mermaid rendering support with Node.js plus: "
             "npm install -g @mermaid-js/mermaid-cli"
         )
+    fontconfig_info = result.get("tools", {}).get("fontconfig")
+    if is_linux and fontconfig_info and not fontconfig_info.get("ok"):
+        recommendations.append(
+            "Install fontconfig so WeasyPrint/Pango can resolve system fonts, for example: "
+            "sudo apt-get install fontconfig"
+        )
 
     font_info = result.get("fonts", {})
     font_groups = font_info.get("groups", {})
     if font_info.get("error"):
         recommendations.append("Font inspection failed; run conversion once and verify CJK text visually.")
-    if font_groups.get("cjk_sans") and not font_groups["cjk_sans"].get("ok"):
+    if font_groups.get("latin_sans") and not font_groups["latin_sans"].get("ok"):
         recommendations.append(
-            "Install Microsoft YaHei when you want the default theme to match its first-choice CJK font. "
-            "On Debian or Ubuntu, Noto CJK is a practical fallback: sudo apt-get install fonts-noto-cjk"
+            "Install a Latin sans font so digits, dates, versions, and page counters avoid CJK font subsets. "
+            "On Debian or Ubuntu, use: sudo apt-get install fonts-liberation fonts-dejavu-core"
         )
+    if font_groups.get("cjk_sans") and not font_groups["cjk_sans"].get("ok"):
+        if is_linux:
+            recommendations.append(
+                "Install Noto CJK for Chinese text on Linux: sudo apt-get install fonts-noto-cjk"
+            )
+        else:
+            recommendations.append(
+                "Install or enable a CJK sans font for Chinese text, such as Microsoft YaHei, "
+                "PingFang SC, Noto Sans CJK SC, or Source Han Sans SC."
+            )
     if font_groups.get("monospace") and not font_groups["monospace"].get("ok"):
         recommendations.append(
-            "Optional: install a monospace font such as Cascadia Code or Liberation Mono for stable code blocks."
+            "Install a monospace font for code blocks. On Debian or Ubuntu, use: "
+            "sudo apt-get install fonts-cascadia-code if that package is available; "
+            "otherwise provide Cascadia Code in the runtime."
+        )
+    elif (
+        is_linux
+        and font_groups.get("monospace")
+        and "Cascadia Mono" in font_groups["monospace"].get("missing", [])
+        and "Cascadia Code" in font_groups["monospace"].get("missing", [])
+    ):
+        recommendations.append(
+            "Optional: install Cascadia Code on Linux for default-theme code blocks: "
+            "sudo apt-get install fonts-cascadia-code if that package is available, "
+            "or provide Cascadia Code in the runtime."
         )
     if font_groups.get("math") and not font_groups["math"].get("ok"):
         recommendations.append(
             "Optional: install STIX fonts for math fallback, for example: sudo apt-get install fonts-stix"
         )
     if font_groups.get("emoji") and not font_groups["emoji"].get("ok"):
+        if is_linux:
+            recommendations.append(
+                "Provide a monochrome emoji font such as Noto Emoji for stable PDF output on Linux. "
+                "Noto Color Emoji is widely packaged, but PDF viewers can render color emoji too small "
+                "or misaligned."
+            )
+        else:
+            recommendations.append(
+                "Install or enable a system emoji font such as Segoe UI Emoji, Apple Color Emoji, "
+                "Noto Color Emoji, or Twemoji Mozilla."
+            )
+    elif (
+        is_linux
+        and font_groups.get("emoji")
+        and "Noto Emoji" in font_groups["emoji"].get("missing", [])
+        and "Noto Color Emoji" in font_groups["emoji"].get("found", [])
+    ):
         recommendations.append(
-            "Provide Segoe UI Emoji in the runtime if you want the default theme's first-choice "
-            "emoji glyphs. If that is not available, install another emoji font and run fc-cache -f."
+            "Noto Color Emoji was found. It provides glyph coverage, but color emoji can render too small "
+            "or misaligned in WeasyPrint/PDFium output. Prefer monochrome Noto Emoji if emoji layout matters."
         )
-    elif font_groups.get("emoji") and "Segoe UI Emoji" in font_groups["emoji"].get("missing", []):
+    elif (
+        not is_linux
+        and font_groups.get("emoji")
+        and "Segoe UI Emoji" in font_groups["emoji"].get("missing", [])
+    ):
         recommendations.append(
             "Optional: provide Segoe UI Emoji if you want the default theme's preferred emoji glyphs. "
             "Existing emoji fallback fonts will still be used."

{agent_markdown_pdf-0.2.0 → agent_markdown_pdf-0.2.2}/mdtopdf/core/fonts.py

@@ -33,8 +33,19 @@ GENERIC_FONT_FAMILIES = {
 }
 
 RECOMMENDED_FONT_GROUPS = {
+    "latin_sans": {
+        "description": "Latin body text and digits",
+        "preferred": ("Segoe UI", "Arial", "Liberation Sans", "DejaVu Sans"),
+        "families": (
+            "Segoe UI",
+            "Arial",
+            "Liberation Sans",
+            "DejaVu Sans",
+        ),
+    },
     "cjk_sans": {
         "description": "CJK body text",
+        "preferred": ("Microsoft YaHei",),
         "families": (
             "Microsoft YaHei",
             "PingFang SC",
@@ -47,6 +58,7 @@ RECOMMENDED_FONT_GROUPS = {
     },
     "monospace": {
         "description": "Code blocks",
+        "preferred": ("Cascadia Mono", "Cascadia Code"),
         "families": (
             "Cascadia Mono",
             "Cascadia Code",
@@ -58,6 +70,7 @@ RECOMMENDED_FONT_GROUPS = {
     },
     "math": {
         "description": "Math fallback",
+        "preferred": ("Cambria Math",),
         "families": (
             "Cambria Math",
             "STIX Two Math",
@@ -67,6 +80,7 @@ RECOMMENDED_FONT_GROUPS = {
     },
     "emoji": {
         "description": "Emoji glyphs",
+        "preferred": ("Segoe UI Emoji",),
         "families": (
             "Segoe UI Emoji",
             "Apple Color Emoji",
@@ -77,6 +91,14 @@ RECOMMENDED_FONT_GROUPS = {
         ),
     },
 }
+PLATFORM_PREFERRED_FONT_GROUPS = {
+    "Linux": {
+        "latin_sans": ("Liberation Sans", "DejaVu Sans"),
+        "cjk_sans": ("Noto Sans CJK SC", "Noto Sans SC"),
+        "math": ("STIXGeneral", "STIX Two Math"),
+        "emoji": ("Noto Emoji",),
+    },
+}
 CJK_CAPABLE_FONT_FAMILIES = (
     "Noto Sans SC",
     "Noto Sans CJK SC",
@@ -115,12 +137,14 @@ def match_font_name(family: str, available: set[str]) -> str | None:
     target = family.lower()
     for name in sorted(available):
         current = name.lower()
+        if "emoji" not in target and " emoji" in current:
+            continue
         if current == target or current.startswith(target + " "):
             return name
     return None
 
 
-def inspect_recommended_font_groups() -> dict[str, Any]:
+def inspect_recommended_font_groups(platform_system: str | None = None) -> dict[str, Any]:
     result: dict[str, Any] = {
         "ok": False,
         "backend": "matplotlib.font_manager",
@@ -137,6 +161,7 @@ def inspect_recommended_font_groups() -> dict[str, Any]:
     fontconfig_emoji = _fontconfig_emoji_match()
     for group_name, group in RECOMMENDED_FONT_GROUPS.items():
         recommended = list(group["families"])
+        preferred = list(_preferred_families(group_name, group, platform_system))
         found = []
         for family in recommended:
             match = match_font_name(family, available)
@@ -146,12 +171,15 @@ def inspect_recommended_font_groups() -> dict[str, Any]:
             for family in fontconfig_emoji.get("families", []):
                 if family not in found:
                     found.append(family)
+        missing = [family for family in recommended if not match_font_name(family, available)]
         result["groups"][group_name] = {
             "ok": bool(found),
             "description": group["description"],
+            "preferred": preferred,
+            "preferred_found": any(family not in missing for family in preferred),
             "recommended": recommended,
             "found": found,
-            "missing": [family for family in recommended if not match_font_name(family, available)],
+            "missing": missing,
         }
         if group_name == "emoji":
             result["groups"][group_name]["fontconfig"] = fontconfig_emoji
@@ -160,6 +188,17 @@ def inspect_recommended_font_groups() -> dict[str, Any]:
     return result
 
 
+def _preferred_families(
+    group_name: str,
+    group: dict[str, Any],
+    platform_system: str | None,
+) -> tuple[str, ...]:
+    platform_preferred = PLATFORM_PREFERRED_FONT_GROUPS.get(platform_system or "", {})
+    if isinstance(platform_preferred, dict) and group_name in platform_preferred:
+        return platform_preferred[group_name]
+    return group.get("preferred", group["families"][:1])
+
+
 def inspect_css_font_usage(css: str, *, document_text: str | None = None) -> dict[str, Any]:
     result: dict[str, Any] = {
         "ok": True,

{agent_markdown_pdf-0.2.0 → agent_markdown_pdf-0.2.2}/mdtopdf/core/markdown.py

@@ -43,6 +43,11 @@ from mdtopdf.core.obsidian import (
 
 DEFAULT_THEME = "default"
 SUPPORTED_THEMES = (DEFAULT_THEME,)
+PAGE_MARGIN_FONT_FAMILY = (
+    '"Segoe UI", Arial, "Liberation Sans", "DejaVu Sans", '
+    '"Microsoft YaHei", "PingFang SC", "Hiragino Sans GB", '
+    '"Noto Sans SC", "Noto Sans CJK SC", "Source Han Sans SC", sans-serif'
+)
 
 
 @dataclass(frozen=True)
@@ -990,6 +995,7 @@ def _page_margin_css(page_header: str | None, page_footer: str | None, page_numb
                 "  @top-center {",
                 f"    content: {_css_string(page_header)};",
                 '    color: #6b7280;',
+                f"    font-family: {PAGE_MARGIN_FONT_FAMILY};",
                 '    font-size: 8.5pt;',
                 '    vertical-align: middle;',
                 "  }",
@@ -1003,6 +1009,7 @@ def _page_margin_css(page_header: str | None, page_footer: str | None, page_numb
                 "  @bottom-center {",
                 f"    content: {footer_content};",
                 '    color: #6b7280;',
+                f"    font-family: {PAGE_MARGIN_FONT_FAMILY};",
                 '    font-size: 8.5pt;',
                 '    vertical-align: middle;',
                 "  }",

{agent_markdown_pdf-0.2.0 → agent_markdown_pdf-0.2.2}/mdtopdf/core/mermaid.py

@@ -120,7 +120,7 @@ def _replace_foreign_object_labels(svg: str) -> str:
         return (
             f'{match.group(1)}<text x="{width / 2:.3f}" y="{height / 2:.3f}" '
             'text-anchor="middle" dominant-baseline="central" '
-            'font-family="Microsoft YaHei, PingFang SC, Hiragino Sans GB, Noto Sans SC, Noto Sans CJK SC, Arial, sans-serif" '
+            'font-family="Segoe UI, Arial, Liberation Sans, DejaVu Sans, Microsoft YaHei, PingFang SC, Hiragino Sans GB, Noto Sans SC, Noto Sans CJK SC, Source Han Sans SC, sans-serif" '
             'font-size="16" fill="#333">'
             f"{escape(text)}"
             "</text></g>"