md2wx-cli 0.2.0__py3-none-any.whl

md2wx/containers.py

@@ -0,0 +1,177 @@
+"""Container and rich syntax pre-processors for md2wx (Clean, minimal styling)."""
+
+import re
+from typing import Optional
+
+_INLINE_CODE_RE = re.compile(r"`([^`\n]+?)`")
+_INLINE_BOLD_RE = re.compile(r"\*\*(.+?)\*\*")
+_INLINE_EM_RE = re.compile(r"(?<!\*)\*([^*\n]+?)\*(?!\*)")
+
+
+def inline_md(text: str) -> str:
+    """Render inline Markdown (code/bold/em/links) inside custom container blocks."""
+    text = _INLINE_CODE_RE.sub(
+        r'<code style="background: rgba(0,0,0,0.06); padding: 2px 6px; border-radius: 4px; font-size: 0.9em">\1</code>',
+        text,
+    )
+    text = _INLINE_BOLD_RE.sub(r'<strong style="font-weight: 600;">\1</strong>', text)
+    text = _INLINE_EM_RE.sub(r"<em>\1</em>", text)
+    text = re.sub(r"\[([^\]]+)\]\((https?://[^\s)]+)\)", r'<a href="\2" style="color: #2563eb; text-decoration: underline;">\1</a>', text)
+    text = re.sub(r'(?<!href=")(https?://[^\s<"]+)', r'<span style="color: #64748b; font-size: 13px; word-break: break-all;">\1</span>', text)
+    return text
+
+
+def process_containers(text: str, primary_color: str = "#2563eb") -> str:
+    """Pre-process rich Markdown extensions into clean, styled HTML."""
+    text = _process_banner_container(text, primary_color)
+    text = _process_github_alerts(text, primary_color)
+    text = _process_admonitions(text, primary_color)
+    text = _process_card_container(text, primary_color)
+    text = _process_center_container(text, primary_color)
+    text = _process_callout(text)
+    return text
+
+
+def _process_banner_container(text: str, primary: str) -> str:
+    """Parse ::: banner [title] (solid primary background, pure white text, centered)."""
+    pattern = re.compile(r":::\s*(?:banner|cta|action)(?:\s+([^\n]+))?\n(.*?)\n:::", re.DOTALL | re.I)
+
+    def repl(m):
+        title = (m.group(1) or "").strip()
+        body = m.group(2).strip()
+        lines = body.split("\n")
+
+        title_html = f'<p style="font-size: 15px; color: #ffffff !important; font-weight: 600; line-height: 1.9; margin: 0 0 8px; text-align: center;">{inline_md(title)}</p>' if title else ""
+        clean_lines = []
+        for l in lines:
+            if not l.strip():
+                continue
+            l_html = inline_md(l).replace("color: #64748b;", "color: #ffffff;").replace("color: #2563eb;", "color: #ffffff;")
+            clean_lines.append(l_html)
+
+        body_html = "<br/>".join(clean_lines)
+        return (
+            f'\n<section style="background: {primary}; border-radius: 10px; padding: 20px; margin: 24px 0;">'
+            f"{title_html}"
+            f'<section style="text-align: center; color: #ffffff !important; font-size: 13px; line-height: 1.8;">{body_html}</section>'
+            f"</section>\n"
+        )
+
+    return pattern.sub(repl, text)
+
+
+def _process_github_alerts(text: str, primary: str) -> str:
+    """Parse GitHub Alerts syntax without injecting artificial icons or extra headers."""
+    alert_config = {
+        "NOTE": ("#2563eb", "#eff6ff"),
+        "TIP": ("#2563eb", "#eff6ff"),
+        "IMPORTANT": ("#7c3aed", "#f5f3ff"),
+        "WARNING": ("#d97706", "#fffbeb"),
+        "CAUTION": ("#dc2626", "#fef2f2"),
+    }
+    pattern = re.compile(r"^>\s*\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\s*\n((?:^>.*$\n?)+)", re.MULTILINE | re.IGNORECASE)
+
+    def repl(m):
+        atype = m.group(1).upper()
+        content = m.group(2)
+        color, bg = alert_config.get(atype, ("#2563eb", "#eff6ff"))
+        cleaned_lines = []
+        for line in content.split("\n"):
+            line = re.sub(r"^>\s?", "", line).strip()
+            if line:
+                cleaned_lines.append(line)
+        body_text = "<br/>".join(inline_md(l) for l in cleaned_lines)
+        return (
+            f'\n<section style="background: {bg}; border-radius: 8px; padding: 16px 20px; margin: 20px 0;">'
+            f'<p style="font-size: 15px; color: {color}; font-weight: 600; line-height: 1.9; margin: 0; text-align: center">{body_text}</p>'
+            f"</section>\n"
+        )
+
+    return pattern.sub(repl, text)
+
+
+def _process_admonitions(text: str, primary: str) -> str:
+    """Parse MkDocs style admonition syntax."""
+    types = {
+        "tip": ("#2563eb", "#eff6ff"),
+        "note": ("#2563eb", "#eff6ff"),
+        "info": ("#2563eb", "#eff6ff"),
+        "warning": ("#d97706", "#fffbeb"),
+        "danger": ("#dc2626", "#fef2f2"),
+    }
+    pattern = re.compile(r"^!!!\s*(tip|note|info|warning|danger)(?:\s+\"([^\"]+)\")?\s*\n((?:^(?:    |\t).*$\n?)+)", re.MULTILINE | re.IGNORECASE)
+
+    def repl(m):
+        atype = m.group(1).lower()
+        title = m.group(2) or ""
+        content = m.group(3)
+        color, bg = types.get(atype, ("#2563eb", "#eff6ff"))
+        cleaned_lines = [re.sub(r"^(?:    |\t)", "", l).strip() for l in content.split("\n") if l.strip()]
+        body_text = "<br/>".join(inline_md(l) for l in cleaned_lines)
+        title_html = f'<p style="font-size: 15px; color: {color}; font-weight: 600; margin: 0 0 6px 0; text-align: center;">{inline_md(title)}</p>' if title else ""
+        return (
+            f'\n<section style="background: {bg}; border-radius: 8px; padding: 16px 20px; margin: 20px 0;">'
+            f"{title_html}"
+            f'<p style="font-size: 15px; color: {color}; font-weight: 500; line-height: 1.8; margin: 0; text-align: center">{body_text}</p>'
+            f"</section>\n"
+        )
+
+    return pattern.sub(repl, text)
+
+
+def _process_card_container(text: str, primary: str) -> str:
+    """Parse ::: card [title] (white background, 1px primary border, centered link)."""
+    pattern = re.compile(r":::\s*card(?:\s+([^\n]+))?\n(.*?)\n:::", re.DOTALL)
+
+    def repl(m):
+        title = (m.group(1) or "").strip()
+        body = m.group(2).strip()
+        lines = [inline_md(l) for l in body.split("\n") if l.strip()]
+        title_html = f'<p style="font-family: \'Noto Serif SC\', \'Songti SC\', STSong, Georgia, serif; font-size: 19px; color: #0f172a; font-weight: 700; line-height: 1.5; margin: 0 0 10px; text-align: center">{inline_md(title)}</p>' if title else ""
+        body_html = "<br/>".join(lines)
+        return (
+            f'\n<section style="background: #ffffff; border: 1px solid {primary}; border-radius: 10px; padding: 20px; margin: 24px 0; box-shadow: 0 4px 16px rgba(15,23,42,0.06);">'
+            f"{title_html}"
+            f'<section style="text-align: center; color: #475569; font-size: 14px; line-height: 1.8;">{body_html}</section>'
+            f"</section>\n"
+        )
+
+    return pattern.sub(repl, text)
+
+
+def _process_center_container(text: str, primary: str) -> str:
+    """Parse ::: center block."""
+    pattern = re.compile(r":::\s*center\n(.*?)\n:::", re.DOTALL)
+
+    def repl(m):
+        body = m.group(1).strip()
+        lines = [inline_md(l) for l in body.split("\n") if l.strip()]
+        body_html = "<br/>".join(lines)
+        return (
+            f'\n<section style="background: #eff6ff; border-radius: 8px; padding: 16px 20px; margin: 20px 0; text-align: center;">'
+            f'<p style="font-size: 15px; color: {primary}; font-weight: 600; line-height: 1.9; margin: 0; text-align: center;">{body_html}</p>'
+            f"</section>\n"
+        )
+
+    return pattern.sub(repl, text)
+
+
+def _process_callout(text: str) -> str:
+    """Parse ::: tip/warning/info/danger block."""
+    colors_map = {
+        "tip": ("#2563eb", "#eff6ff"),
+        "warning": ("#d97706", "#fffbeb"),
+        "info": ("#2563eb", "#eff6ff"),
+        "danger": ("#dc2626", "#fef2f2"),
+    }
+
+    def repl(m):
+        ctype = m.group(1).strip().lower()
+        content = m.group(2).strip()
+        color, bg = colors_map.get(ctype, colors_map["info"])
+        return (
+            f'\n<section style="background: {bg}; border-radius: 8px; padding: 16px 20px; margin: 18px 0; font-size: 15px; line-height: 1.8; text-align: center; color: {color}; font-weight: 600;">'
+            f"{inline_md(content)}</section>\n"
+        )
+
+    return re.sub(r":::(?:callout\s+)?(tip|warning|info|danger)\n(.*?)\n:::", repl, text, flags=re.DOTALL | re.I)

md2wx/converter.py

@@ -0,0 +1,206 @@
+"""Markdown to WeChat-compatible HTML converter pipeline."""
+
+import re
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Optional, Tuple
+
+import markdown
+from bs4 import BeautifulSoup
+
+from .containers import process_containers
+from .styler import (
+    apply_inline_styles,
+    apply_wechat_fixes,
+    convert_links_to_footnotes,
+    convert_lists_to_sections,
+    inject_darkmode,
+    make_paste_safe,
+    preserve_code_block_newlines,
+    sanitize_for_wechat,
+)
+from .theme import Theme, get_inline_css_rules, load_theme
+
+
+@dataclass
+class ConvertResult:
+    html: str
+    title: str
+    digest: str
+    images: list[str] = field(default_factory=list)
+
+
+class WeChatConverter:
+    """Convert Markdown to WeChat-compatible inline-style HTML."""
+
+    def __init__(self, theme: Optional[Theme] = None, theme_name: str = "default"):
+        self._theme = theme if theme is not None else load_theme(theme_name)
+        self._css_rules = get_inline_css_rules(self._theme)
+
+    def convert(self, markdown_text: str, base_dir: Optional[Path] = None) -> ConvertResult:
+        title = self._extract_title(markdown_text)
+        markdown_text = self._strip_h1(markdown_text)
+        accent = self._theme.colors.get("secondary") or self._theme.colors.get("primary", "#2563eb")
+        text_color = self._theme.colors.get("text", "#475569")
+        primary = self._theme.colors.get("primary", "#2563eb")
+
+        # 1. 扩展容器语法与中英文空格预处理
+        markdown_text = process_containers(markdown_text, accent)
+        markdown_text = self._fix_cjk_spacing(markdown_text)
+
+        # 2. 基础 Markdown → HTML 解析
+        raw_html = self._markdown_to_html(markdown_text)
+        soup = BeautifulSoup(raw_html, "html.parser")
+
+        # 3. 本地图片路径转换与外框样式
+        images = self._process_images(soup, base_dir)
+
+        # 4. 原生列表转为稳定的 Section Flex 容器
+        convert_lists_to_sections(soup, text_color, primary)
+
+        # 5. 外链转为文末上标脚注
+        convert_links_to_footnotes(soup, primary)
+
+        # 6. 内联 CSS 样式编译与组件强化
+        apply_inline_styles(soup, self._theme, self._css_rules)
+
+        # 7. 代码块换行保障与微信平台特性修复
+        preserve_code_block_newlines(soup)
+        apply_wechat_fixes(soup, text_color)
+        sanitize_for_wechat(soup)
+        inject_darkmode(soup, self._theme.colors.get("darkmode", {}))
+
+        final_html = self._fix_cjk_bold_punctuation(str(soup))
+        digest = self._generate_digest(final_html)
+        return ConvertResult(html=final_html, title=title, digest=digest, images=images)
+
+    def _extract_and_strip_frontmatter(self, text: str) -> Tuple[str, str]:
+        m = re.match(r"^---\r?\n(.*?)\r?\n---\r?\n", text, flags=re.DOTALL)
+        if not m:
+            return "", text
+        frontmatter = m.group(1)
+        title = ""
+        try:
+            import yaml
+            data = yaml.safe_load(frontmatter)
+            if isinstance(data, dict) and data.get("title"):
+                title = str(data["title"]).strip().strip("\"'")
+        except Exception:
+            pass
+        if not title:
+            for line in frontmatter.split("\n"):
+                if line.strip().lower().startswith("title:"):
+                    cand = line.split(":", 1)[1].strip().strip("\"'")
+                    if not cand.startswith(("[", "{")):
+                        title = cand
+                    break
+        return title, text[m.end():]
+
+    def _extract_title(self, text: str) -> str:
+        fm_title, body = self._extract_and_strip_frontmatter(text)
+        if fm_title:
+            return fm_title
+        in_code = False
+        for line in body.split("\n"):
+            s = line.strip()
+            if s.startswith("```"):
+                in_code = not in_code
+                continue
+            if not in_code and s.startswith("# ") and not s.startswith("## "):
+                return s[2:].strip()
+        return ""
+
+    def _strip_h1(self, text: str) -> str:
+        _, body = self._extract_and_strip_frontmatter(text)
+        lines, in_code = [], False
+        for line in body.split("\n"):
+            s = line.strip()
+            if s.startswith("```"):
+                in_code = not in_code
+                lines.append(line)
+                continue
+            if not in_code and s.startswith("# ") and not s.startswith("## "):
+                continue
+            lines.append(line)
+        return "\n".join(lines)
+
+    def _markdown_to_html(self, text: str) -> str:
+        exts = [
+            "markdown.extensions.fenced_code",
+            "markdown.extensions.tables",
+            "markdown.extensions.nl2br",
+            "markdown.extensions.sane_lists",
+            "markdown.extensions.codehilite",
+        ]
+        configs = {"codehilite": {"linenums": False, "guess_lang": True, "noclasses": True}}
+        return markdown.Markdown(extensions=exts, extension_configs=configs).convert(text)
+
+    def _process_images(self, soup: BeautifulSoup, base_dir: Optional[Path]) -> list[str]:
+        images = []
+        for img in soup.find_all("img"):
+            src = img.get("src", "")
+            if src:
+                if base_dir and not src.startswith(("http://", "https://", "data:")):
+                    local_p = (base_dir / src).resolve()
+                    if local_p.exists():
+                        src = str(local_p).replace("\\", "/")
+                        img["src"] = src
+                images.append(src)
+            existing = img.get("style", "")
+            if "max-width" not in existing:
+                img["style"] = f"{existing}; max-width: 100%; height: auto; display: block; margin: 24px auto" if existing else "max-width: 100%; height: auto; display: block; margin: 24px auto"
+        return images
+
+    def _fix_cjk_spacing(self, text: str) -> str:
+        cjk, latin = r"[\u4e00-\u9fff\u3400-\u4dbf\u3000-\u303f\uff00-\uffef]", r"[A-Za-z0-9]"
+        lines, in_code = [], False
+        for line in text.split("\n"):
+            if line.strip().startswith("```"):
+                in_code = not in_code
+                lines.append(line)
+                continue
+            if in_code:
+                lines.append(line)
+                continue
+            tokens = []
+
+            def mask_inline(m):
+                tokens.append(m.group(0))
+                return f"\x00TK{len(tokens)-1}\x00"
+
+            masked = re.sub(r"`[^`\n]+?`|https?://[^\s)\]]+", mask_inline, line)
+            masked = re.sub(f"({cjk})({latin})", r"\1 \2", masked)
+            masked = re.sub(f"({latin})({cjk})", r"\1 \2", masked)
+            for idx, tok in enumerate(tokens):
+                masked = masked.replace(f"\x00TK{idx}\x00", tok)
+            lines.append(masked)
+        return "\n".join(lines)
+
+    def _fix_cjk_bold_punctuation(self, html: str) -> str:
+        return re.sub(r"(<strong>)(.*?)([，。！？；：、]+)(</strong>)", r"\1\2\4\3", html)
+
+    def _generate_digest(self, html: str, max_bytes: int = 120) -> str:
+        soup = BeautifulSoup(html, "html.parser")
+        text = re.sub(r"\s+", " ", soup.get_text(separator=" ", strip=True)).strip()
+        encoded = text.encode("utf-8")
+        if len(encoded) <= max_bytes:
+            return text
+        return encoded[: max_bytes - 3].decode("utf-8", errors="ignore").rstrip() + "..."
+
+
+def preview_html(body_html: str, theme: Theme) -> str:
+    """生成完整 HTML5 预览页面骨架。"""
+    return f"""<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Preview</title>
+    <style>
+{theme.base_css}
+    </style>
+</head>
+<body>
+    {body_html}
+</body>
+</html>"""

md2wx/fetcher.py

@@ -0,0 +1,211 @@
+"""WeChat article fetcher and Markdown generator for md2wx."""
+
+import os
+import re
+import urllib.parse
+import urllib.request
+from pathlib import Path
+from typing import Optional, Tuple
+
+from bs4 import BeautifulSoup, NavigableString
+
+
+def fetch_and_convert_article(url: str, output_file: Optional[Path] = None) -> Tuple[Path, str]:
+    """Fetch a WeChat article, download its assets, and convert it to clean Markdown."""
+    req = urllib.request.Request(
+        url,
+        headers={
+            "User-Agent": (
+                "Mozilla/5.0 (iPhone; CPU iPhone OS 16_6 like Mac OS X) "
+                "AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 "
+                "MicroMessenger/8.0.38(0x1800262c) NetType/WIFI Language/zh_CN"
+            ),
+            "Referer": "https://mp.weixin.qq.com",
+        },
+    )
+    with urllib.request.urlopen(req, timeout=15) as resp:
+        content_bytes = resp.read()
+        try:
+            html_raw = content_bytes.decode("utf-8")
+        except UnicodeDecodeError:
+            html_raw = content_bytes.decode("gbk", errors="ignore")
+
+    soup = BeautifulSoup(html_raw, "html.parser")
+
+    # 1. 提取元数据
+    title_el = soup.find(id="activity-name") or soup.find("h1") or soup.find("title")
+    title = title_el.get_text(strip=True) if title_el else "wechat_article"
+    title = re.sub(r'[\/:*?"<>|]', "_", title)
+
+    author_el = soup.find(id="js_name") or soup.find(class_="rich_media_meta_text")
+    author = author_el.get_text(strip=True) if author_el else ""
+
+    # 2. 提取正文容器 #js_content
+    content_el = soup.find(id="js_content")
+    if not content_el:
+        raise ValueError("未能解析到文章正文容器 (#js_content)，可能链接失效或触发了微信反爬验证。")
+
+    # 确定输出路径与资源目录
+    if output_file is None:
+        target_md = Path(f"{title}.md")
+    else:
+        target_md = output_file
+
+    assets_dir = target_md.parent / f"{target_md.stem}-assets"
+    assets_dir.mkdir(parents=True, exist_ok=True)
+
+    # 3. 下载图片并替换为本地相对路径
+    img_counter = 0
+    for img in content_el.find_all("img"):
+        src = img.get("data-src") or img.get("src")
+        if not src or not src.startswith("http"):
+            continue
+        img_counter += 1
+        fmt = img.get("data-type", "png")
+        if fmt not in ("png", "jpg", "jpeg", "gif", "webp"):
+            fmt = "png"
+        img_name = f"fig-{img_counter:02d}.{fmt}"
+        local_img_path = assets_dir / img_name
+        try:
+            img_req = urllib.request.Request(src, headers={"User-Agent": "Mozilla/5.0", "Referer": "https://mp.weixin.qq.com"})
+            with urllib.request.urlopen(img_req, timeout=10) as r:
+                local_img_path.write_bytes(r.read())
+            img["src"] = f"{target_md.stem}-assets/{img_name}"
+        except Exception:
+            img["src"] = src
+
+    # 4. 转换 DOM 为 Markdown
+    md_body = _html_node_to_markdown(content_el)
+
+    frontmatter = f"""---
+title: "{title}"
+author: "{author}"
+source_url: "{url}"
+---
+
+# {title}
+
+"""
+    final_md = frontmatter + md_body.strip() + "\n"
+    target_md.write_text(final_md, encoding="utf-8")
+    return target_md, final_md
+
+
+def _html_node_to_markdown(node) -> str:
+    """将 HTML DOM 节点树递归转换为干净的结构化 Markdown（支持智能卡片识别）。"""
+    pieces = []
+    for child in node.children:
+        if isinstance(child, NavigableString):
+            txt = str(child).strip()
+            if txt:
+                pieces.append(txt)
+            continue
+
+        name = child.name.lower() if child.name else ""
+
+        if name in ("h1", "h2", "h3", "h4", "h5", "h6"):
+            level = int(name[1])
+            pieces.append(f"\n{'#' * level} {child.get_text(strip=True)}\n")
+        elif name == "p":
+            p_txt = _render_inline(child).strip()
+            if p_txt:
+                pieces.append(f"\n{p_txt}\n")
+        elif name == "pre":
+            code = child.find("code")
+            code_txt = code.get_text() if code else child.get_text()
+            pieces.append(f"\n```\n{code_txt.strip()}\n```\n")
+        elif name == "blockquote":
+            b_txt = _render_inline(child).strip()
+            if b_txt:
+                quoted = "\n".join(f"> {line}" for line in b_txt.split("\n"))
+                pieces.append(f"\n{quoted}\n")
+        elif name in ("ul", "ol"):
+            for idx, li in enumerate(child.find_all("li", recursive=False), 1):
+                li_txt = _render_inline(li).strip()
+                if name == "ul":
+                    pieces.append(f"- {li_txt}")
+                else:
+                    pieces.append(f"{idx}. {li_txt}")
+            pieces.append("")
+        elif name == "img":
+            alt = child.get("alt", "") or "文章配图"
+            src = child.get("src", "")
+            if src:
+                pieces.append(f"\n![{alt}]({src})\n")
+        elif name in ("section", "div"):
+            st_raw = child.get("style", "")
+            st_dict = {}
+            for item in st_raw.split(";"):
+                if ":" in item:
+                    k, v = item.split(":", 1)
+                    st_dict[k.strip().lower()] = v.strip().lower()
+
+            bg_val = st_dict.get("background", "") or st_dict.get("background-color", "")
+            border_val = st_dict.get("border", "") or st_dict.get("border-color", "")
+
+            # 1. 纯色实心横幅 (背景为深蓝实心 #2563eb / rgb(37, 99, 235))
+            if bg_val and any(c in bg_val for c in ("#2563eb", "rgb(37, 99, 235)", "rgb(37,99,235)")):
+                p_nodes = child.find_all(["p", "section"])
+                lines = [_render_inline(p).strip() for p in p_nodes if _render_inline(p).strip()]
+                if lines:
+                    title_line = lines[0]
+                    body_lines = "\n".join(lines[1:]) if len(lines) > 1 else ""
+                    banner_md = f"::: banner {title_line}\n{body_lines}\n:::" if body_lines else f"::: banner\n{title_line}\n:::"
+                    pieces.append(f"\n{banner_md}\n")
+                    continue
+
+            # 2. 浅色高亮居中框 (背景为浅蓝 #eff6ff)
+            if bg_val and any(c in bg_val for c in ("#eff6ff", "rgb(239, 246, 255)", "rgb(239,246,255)")):
+                inner_txt = _render_inline(child).strip()
+                if inner_txt:
+                    quoted = "\n".join(f"> {line}" for line in inner_txt.split("\n") if line.strip())
+                    pieces.append(f"\n{quoted}\n")
+                    continue
+
+            # 3. 白底描边外框卡片 (border 为 1px solid ...)
+            if border_val and "solid" in border_val:
+                p_nodes = child.find_all(["p", "section"])
+                lines = [_render_inline(p).strip() for p in p_nodes if _render_inline(p).strip()]
+                if lines:
+                    title_line = lines[0]
+                    body_lines = "\n".join(lines[1:]) if len(lines) > 1 else ""
+                    card_md = f"::: card {title_line}\n{body_lines}\n:::" if body_lines else f"::: card\n{title_line}\n:::"
+                    pieces.append(f"\n{card_md}\n")
+                    continue
+
+            inner = _html_node_to_markdown(child).strip()
+            if inner:
+                pieces.append(inner)
+        else:
+            txt = _render_inline(child).strip()
+            if txt:
+                pieces.append(txt)
+
+    return "\n\n".join(p for p in pieces if p)
+
+
+def _render_inline(node) -> str:
+    res = []
+    for child in node.children:
+        if isinstance(child, NavigableString):
+            res.append(str(child))
+            continue
+        cname = child.name.lower() if child.name else ""
+        if cname in ("strong", "b"):
+            res.append(f"**{child.get_text()}**")
+        elif cname in ("em", "i"):
+            res.append(f"*{child.get_text()}*")
+        elif cname == "code":
+            res.append(f"`{child.get_text()}`")
+        elif cname == "a":
+            href = child.get("href", "")
+            res.append(f"[{child.get_text()}]({href})")
+        elif cname == "img":
+            src = child.get("src", "")
+            alt = child.get("alt", "") or "文章配图"
+            res.append(f"![{alt}]({src})")
+        elif cname == "br":
+            res.append("\n")
+        else:
+            res.append(_render_inline(child))
+    return "".join(res)