Skip to content

topmindspace/topmind-writing-skills / topmind-x-article

topmind-x-article

Verified

创作或整理 X Article 深度长文,支持论点推进、工具/插件介绍、产品实测评测与多源研究;按需导出可复制 HTML、纯文本、封面与发布清单。普通短帖用 topmind-briefs 或 topmind-viral-posts,纯格式化用 topmind-format。

FileKindSize
.gitignoreother31 B
README.en.mdmarkdown1.7 KB
README.mdmarkdown2.0 KB
SKILL.mdskill md4.6 KB
examples/01-长文-慢慢写.mdmarkdown1.8 KB
examples/02-长文-周末短途.mdmarkdown1.4 KB
examples/README.mdmarkdown716 B
knowledge/README.mdmarkdown9.4 KB
knowledge/cards/atlas-local-fix.mdmarkdown781 B
knowledge/cards/brief-news-to-post.mdmarkdown3.0 KB
knowledge/cards/brief-news.mdmarkdown916 B
knowledge/cards/brief-paper.mdmarkdown760 B
knowledge/cards/brief-tools.mdmarkdown617 B
knowledge/cards/brief-value-first.mdmarkdown3.1 KB
knowledge/cards/cover-abstract.mdmarkdown1.3 KB
knowledge/cards/cover-brief.mdmarkdown1.3 KB
knowledge/cards/cover-collage.mdmarkdown1.3 KB
knowledge/cards/cover-color.mdmarkdown1.2 KB
knowledge/cards/cover-culture.mdmarkdown1013 B
knowledge/cards/cover-editorial.mdmarkdown1.2 KB
knowledge/cards/cover-material.mdmarkdown1.3 KB
knowledge/cards/cover-photo.mdmarkdown1.1 KB
knowledge/cards/cover-playful.mdmarkdown1.0 KB
knowledge/cards/cover-scene.mdmarkdown962 B
knowledge/cards/cover-series.mdmarkdown1017 B
knowledge/cards/cover-typography.mdmarkdown1.3 KB
knowledge/cards/creative-choice.mdmarkdown807 B
knowledge/cards/crop-independent.mdmarkdown719 B
knowledge/cards/de-ai-mechanisms.mdmarkdown3.6 KB
knowledge/cards/experience-loop.mdmarkdown801 B
knowledge/cards/format-fidelity.mdmarkdown501 B
knowledge/cards/format-layouts.mdmarkdown502 B
knowledge/cards/poster-paging.mdmarkdown726 B
knowledge/cards/poster-structure.mdmarkdown646 B
knowledge/cards/poster-voices.mdmarkdown530 B
knowledge/cards/reference-reading.mdmarkdown857 B
knowledge/cards/revise-depth.mdmarkdown677 B
knowledge/cards/revise-feedback.mdmarkdown609 B
knowledge/cards/revise-learn-from-edits.mdmarkdown3.1 KB
knowledge/cards/revise-preserve.mdmarkdown788 B
knowledge/cards/viral-mechanisms.mdmarkdown535 B
knowledge/cards/viral-observation.mdmarkdown544 B
knowledge/cards/viral-play-dumb.mdmarkdown2.8 KB
knowledge/cards/viral-replies.mdmarkdown722 B
knowledge/cards/visual-density-and-evidence.mdmarkdown2.8 KB
knowledge/cards/voice-peer-stance.mdmarkdown2.7 KB
knowledge/cards/wechat-decide.mdmarkdown746 B
knowledge/cards/wechat-explain.mdmarkdown820 B
knowledge/cards/wechat-plugin-and-review.mdmarkdown2.5 KB
knowledge/cards/wechat-story.mdmarkdown798 B
knowledge/cards/x-adapt.mdmarkdown643 B
knowledge/cards/x-argument.mdmarkdown770 B
knowledge/cards/x-evidence.mdmarkdown608 B
knowledge/index.jsonconfig39.9 KB
package.jsonmanifest445 B
references/core-voice.mdmarkdown9.9 KB
references/creative-practice.mdmarkdown5.0 KB
references/de-ai-rules.mdmarkdown17.9 KB
references/image-sourcing.mdmarkdown2.7 KB
references/information-design.mdmarkdown5.0 KB
references/knowledge-library.mdmarkdown5.5 KB
references/platform-cover-specs.mdmarkdown7.4 KB
references/platform-operations.mdmarkdown2.5 KB
references/publish-checklist.mdmarkdown2.2 KB
references/research-mode.mdmarkdown1.6 KB
references/revision-workflow.mdmarkdown5.9 KB
references/social-writing-principles.mdmarkdown7.7 KB
references/workspace.mdmarkdown2.3 KB
references/x-delivery-contract.mdmarkdown3.6 KB
references/x-format.mdmarkdown3.5 KB
references/x-html-format.mdmarkdown6.8 KB
references/x-post-format.mdmarkdown2.5 KB
scripts/article_scaffold.pyscript5.6 KB
scripts/audit-provenance.pyscript14.9 KB
scripts/audit_css.pyscript1.1 KB
scripts/audit_docs.pyscript3.1 KB
scripts/audit_skill.pyscript3.1 KB
scripts/audit_styles.pyscript1.6 KB
scripts/check_article.pyscript13.9 KB
scripts/count_words.pyscript3.0 KB
scripts/de_ai_lint.pyscript41.5 KB
scripts/info_design_hints.pyscript14.2 KB
scripts/knowledge.pyscript11.8 KB
scripts/lint_x_post.pyscript20.0 KB
scripts/md2x-html.pyscript39.8 KB
scripts/md2x.pyscript15.4 KB
scripts/negative_tests.pyscript10.5 KB
scripts/package_skill.pyscript6.6 KB
scripts/revise_check.pyscript15.2 KB

scripts/md2x.py

View on GitHub
#!/usr/bin/env python3
"""md → X 长文可粘贴纯文本。

把 Markdown 原稿转成可直接粘贴进 X Article 编辑器的纯文本:
标题/正文保留,排版标记剥离,图片转为 [图N] 占位。

用法:
    python3 md2x.py <文章名>/<文章名>.md [--out <输出/X发布稿.txt>] [--list-style plain|emoji|keep]

--out 缺省 <md 所在目录>/out/X发布稿.txt。

列表:X 纯文本不渲染 Markdown 列表。默认 plain:`- ` → 「· 」,`1. ` → 「1)」,
二级条目缩进两格;--list-style emoji 用 🔹 / ▫️ / 1️⃣(旧默认,emoji 可选不强制);
--list-style keep 保留原符号。

HTML 注释(<!-- 写作提示 -->,可跨行)整段去掉;代码块和行内代码里的原样保留。

规则见 references/x-format.md。
"""
import argparse
import re
import sys
from pathlib import Path

# --- 行内规则 ---------------------------------------------------------------

# markdown 转义:反斜杠 + ASCII 标点 → 标点本身(先占位保护,避免被 emphasis 误配对)
_UNESCAPE_RE = re.compile(r"\\([!\"#$%&'()*+,\-./:;<=>?@\[\\\]^_`{|}~])")
_PUA0, _PUA1 = "\ue000", "\ue001"

HR_RE = re.compile(r"^(\*(\s*\*){2,}|-(\s*-){2,}|_(\s*_){2,})\s*$")
HEADING_RE = re.compile(r"^(#{1,6})\s+(.*)$")
SETEXT_RE = re.compile(r"^=+\s*$")
TABLE_SEP_RE = re.compile(r"^:?-+:?$")
# 引用式定义:[label]: url "可选 title"(行首至多 3 空格)
REFDEF_RE = re.compile(r"^\s{0,3}\[([^\]]+)\]:\s*(\S+)(?:\s+[\"'(].*[\"')])?\s*$")


def _protect_escapes(s):
    """把反斜杠转义换成私有用区占位符,返回 (新串, 还原表)。"""
    store = []

    def repl(m):
        store.append(m.group(1))
        return f"{_PUA0}{len(store) - 1}{_PUA1}"

    return _UNESCAPE_RE.sub(repl, s), store


def _restore_escapes(s, store):
    def repl(m):
        return store[int(m.group(1))]

    return re.sub(f"{_PUA0}(\\d+){_PUA1}", repl, s)


def _parse_paren(s, j):
    """s[j] == '(' 时,找与之匹配的 ')'(括号可嵌套)。

    返回 (括号内文本, 右括号之后的位置);括号不平衡返回 None。
    """
    depth = 0
    k, n = j, len(s)
    while k < n:
        c = s[k]
        if c == "(":
            depth += 1
        elif c == ")":
            depth -= 1
            if depth == 0:
                return s[j + 1:k], k + 1
        k += 1
    return None


def _split_url_title(inner):
    """把 `(url "title")` 括号内文本拆出 url(title 丢弃)。"""
    inner = inner.strip()
    m = re.match(r"^(\S+?)(?:\s+(?:\"[^\"]*\"|'[^']*'|\([^)]*\)))?$", inner)
    return m.group(1) if m else inner


def _replace_images(s, images, defs):
    """![alt](url) / ![alt][ref] → [图N](alt 记入 images)。"""
    res = []
    i, n = 0, len(s)
    while i < n:
        if s.startswith("![", i):
            k = s.find("]", i + 2)
            if k == -1 or "]" in s[i + 2:k]:
                res.append(s[i])
                i += 1
                continue
            alt = s[i + 2:k]
            j = k + 1
            if j < n and s[j] == "(":
                parsed = _parse_paren(s, j)
                if not parsed:
                    res.append(s[i])
                    i += 1
                    continue
                j = parsed[1]  # url 允许为空;图片占位不依赖 url
            elif j < n and s[j] == "[":
                k2 = s.find("]", j + 1)
                if k2 == -1:
                    res.append(s[i])
                    i += 1
                    continue
                label = s[j + 1:k2] or alt  # [alt][] 省略式:label 取 alt
                if label.strip().lower() not in defs:
                    res.append(s[i])
                    i += 1
                    continue
                j = k2 + 1
            else:
                res.append(s[i])
                i += 1
                continue
            images.append(alt.strip())
            res.append(f"[图{len(images)}]")
            i = j
        else:
            res.append(s[i])
            i += 1
    return "".join(res)


def _replace_links(s, defs):
    """[文字](url) / [文字][ref] / [文字][] / [文字] → 文字(url)。"""
    # 1) 行内式:url 括号可嵌套
    res = []
    i, n = 0, len(s)
    while i < n:
        if s[i] == "[" and not (i > 0 and s[i - 1] == "!"):
            k = s.find("](", i + 1)
            if k != -1 and "]" not in s[i + 1:k]:
                parsed = _parse_paren(s, k + 1)
                if parsed:
                    url = _split_url_title(parsed[0])
                    if url:
                        res.append(f"{s[i + 1:k]}({url})")
                        i = parsed[1]
                        continue
        res.append(s[i])
        i += 1
    s = "".join(res)

    # 2) 引用式 [文字][label] / [文字][]((?<!\!) 避免误伤残留的坏图片写法)
    def _ref(m):
        label = (m.group(2) or m.group(1)).strip().lower()
        url = defs.get(label)
        return f"{m.group(1)}({url})" if url else m.group(0)

    s = _INLINE_REF2_RE.sub(_ref, s)

    # 3) 快捷引用 [文字](仅当 label 有定义时才转,避免误伤普通方括号)
    def _shortcut(m):
        url = defs.get(m.group(1).strip().lower())
        return f"{m.group(1)}({url})" if url else m.group(0)

    return _INLINE_REF1_RE.sub(_shortcut, s)


# _inline() 的行内模式:预编译在模块级,避免每行重复走 re 缓存查找
_INLINE_BI_RE = re.compile(r"\*\*\*(.+?)\*\*\*")   # 粗斜体
_INLINE_B_RE = re.compile(r"\*\*(.+?)\*\*")         # 加粗
_INLINE_BU_RE = re.compile(r"__(.+?)__")
_INLINE_I_RE = re.compile(r"\*(.+?)\*")            # 斜体
_INLINE_CODE_RE = re.compile(r"`(.+?)`")           # 行内代码
_INLINE_DEL_RE = re.compile(r"~~(.+?)~~")           # 删除线
_INLINE_TASK0_RE = re.compile(r"^(\s*)- \[ \]\s+")
_INLINE_TASK1_RE = re.compile(r"^(\s*)- \[x\]\s+", re.I)
_INLINE_REF2_RE = re.compile(r"(?<!\!)\[([^\]]+)\]\[([^\]]*)\]")
_INLINE_REF1_RE = re.compile(r"(?<!\!)\[([^\]]+)\]")


def _inline(s, defs):
    """行内标记剥离(用于正文行、标题文本、表格单元格)。"""
    s = _INLINE_BI_RE.sub(r"\1", s)  # 粗斜体
    s = _INLINE_B_RE.sub(r"\1", s)    # 加粗
    s = _INLINE_BU_RE.sub(r"\1", s)
    s = _INLINE_I_RE.sub(r"\1", s)    # 斜体
    s = _INLINE_CODE_RE.sub(r"\1", s)  # 行内代码
    s = _INLINE_DEL_RE.sub(r"\1", s)  # 删除线
    s = _replace_links(s, defs)       # 链接(行内式/引用式)
    s = _INLINE_TASK0_RE.sub(r"\1- ", s)  # 任务列表
    s = _INLINE_TASK1_RE.sub(r"\1- ", s)
    return s


_FENCE_OPEN_RE = re.compile(r"^\s{0,3}(`{3,}|~{3,})")


def strip_html_comments(text):
    """去掉正文里的 HTML 注释(<!-- … -->,可跨行):写作提示、骨架备注不进渲染产物。
    围栏代码块和行内代码里的 <!-- 原样保留;整行只有注释的行直接删掉。"""
    out, fence, in_c = [], None, False
    for line in text.split("\n"):
        if not in_c:
            m = _FENCE_OPEN_RE.match(line)
            if fence is None and m:
                fence = m.group(1)
                out.append(line)
                continue
            if fence is not None:
                if m and m.group(1)[0] == fence[0] and len(m.group(1)) >= len(fence) \
                        and not line.strip()[len(m.group(1)):].strip():
                    fence = None
                out.append(line)
                continue
        res, rest = "", line
        while rest:
            if in_c:
                j = rest.find("-->")
                if j < 0:
                    rest = ""
                    break
                rest, in_c = rest[j + 3:], False
                if res.endswith(" ") and rest.startswith(" "):
                    rest = rest.lstrip(" ")
            else:
                j = rest.find("<!--")
                if j < 0:
                    res += rest
                    break
                if (res + rest[:j]).count("`") % 2 == 1:  # 行内代码里的 <!-- 不算注释
                    res, rest = res + rest[:j + 4], rest[j + 4:]
                    continue
                res, rest, in_c = res + rest[:j], rest[j + 4:], True
        if res == line:
            out.append(line)
        elif res.strip():
            out.append(res.rstrip())
    return "\n".join(out)


def _strip_frontmatter(md):
    """去掉文首 frontmatter 块。块内非空行必须都含 ':',否则视为正文(如文首分割线)。"""
    m = re.match(r"^---[ \t]*\r?\n(.*?)\r?\n---[ \t]*(\r?\n|$)", md, flags=re.S)
    if m and all(not ln.strip() or ":" in ln for ln in m.group(1).splitlines()):
        return md[m.end():]
    return md


# --- 列表 → emoji 项目符号 ---------------------------------------------------
_UL_RE = re.compile(r"^(\s*)[-*+]\s+(?:\[[ xX]\]\s+)?(\S.*)$")
_OL_RE = re.compile(r"^(\s*)(\d{1,3})[.)]\s+(\S.*)$")
_KEYCAPS = ["0️⃣", "1️⃣", "2️⃣", "3️⃣", "4️⃣", "5️⃣", "6️⃣", "7️⃣", "8️⃣", "9️⃣"]
_CIRCLED = "①②③④⑤⑥⑦⑧⑨⑩⑪⑫⑬⑭⑮⑯⑰⑱⑲⑳"


def _number_symbol(n):
    """序号符号:0–9 用 keycap,10 用 🔟,11–20 用带圈数字,更大的退回「N)」。"""
    if 0 <= n <= 9:
        return _KEYCAPS[n]
    if n == 10:
        return "🔟"
    if 11 <= n <= 20:
        return _CIRCLED[n - 1]
    return f"{n})"


def _indent_level(prefix):
    width = len(prefix.replace("\t", "    "))
    return 0 if width == 0 else 1  # 最多两层:更深的嵌套压成二级


def _emoji_list(line):
    """Markdown 列表行 → (前缀, 正文);不是列表行返回 None。"""
    m = _UL_RE.match(line)
    if m:
        level = _indent_level(m.group(1))
        return ("  " * level) + ("🔹 " if level == 0 else "▫️ "), m.group(2)
    m = _OL_RE.match(line)
    if m:
        level = _indent_level(m.group(1))
        return ("  " * level) + _number_symbol(int(m.group(2))) + " ", m.group(3)
    return None


def _plain_list(line):
    """Markdown 列表行 → (前缀, 正文):「· 」/「1)」,二级缩进两格;不是列表行返回 None。"""
    m = _UL_RE.match(line)
    if m:
        level = _indent_level(m.group(1))
        return ("  " * level) + "· ", m.group(2)
    m = _OL_RE.match(line)
    if m:
        level = _indent_level(m.group(1))
        return ("  " * level) + f"{int(m.group(2))})", m.group(3)
    return None


def convert(md: str, list_style: str = "plain"):
    images = []
    defs = {}
    out_lines = []
    in_code = False
    fence_len = 0

    md, esc_store = _protect_escapes(md)
    md = strip_html_comments(_strip_frontmatter(md))

    # 先收集引用式定义([label]: url),定义行不进正文
    body = []
    for raw in md.splitlines():
        m = REFDEF_RE.match(raw)
        if m:
            defs[m.group(1).strip().lower()] = m.group(2)
        else:
            body.append(raw)

    for raw in body:
        line = raw.rstrip()

        # 代码块:先处理围栏,块内行原样缩进(分割线规则不进代码块)。
        # 围栏反引号数 >= 3:```` 开栏只能由 >= 4 反引号闭合(CommonMark),
        # 否则 markdown 示例里的内层 ``` 会把外层栏提前"闭合",造成静默错排。
        stripped = line.strip()
        if stripped.startswith("```"):
            k = 0
            while k < len(stripped) and stripped[k] == "`":
                k += 1
            if not in_code:
                in_code = True
                fence_len = k
            elif k >= fence_len and not stripped[k:].strip():
                in_code = False
                fence_len = 0
            else:
                # 栏内误写的短栏 / 带信息串的栏是代码内容,不是闭合栏
                out_lines.append("    " + line)
            continue
        if in_code:
            out_lines.append("    " + line)
            continue

        # 图片占位(行内式/引用式)
        line = _replace_images(line, images, defs)

        # 引用:剥掉所有层级的 >(放标题识别之前,引用内标题也能转)
        line = re.sub(r"^(>\s?)+", "", line)

        # 标题 → 纯文本行(标题内行文标记同样剥离)
        m = HEADING_RE.match(line)
        if m:
            out_lines.append("")
            out_lines.append(_inline(m.group(2).strip(), defs))
            out_lines.append("")
            continue

        # Setext 一级标题:上一行是正文则转为标题
        if SETEXT_RE.match(line):
            if out_lines and out_lines[-1].strip():
                text = out_lines.pop()
                out_lines.append("")
                out_lines.append(text)
                out_lines.append("")
            else:
                out_lines.append("")
            continue

        # 分割线(* * * / - - - / _ _ _ 允许空格)→ 空行
        if HR_RE.match(line):
            out_lines.append("")
            continue

        # 表格行 → "项:值" 列表(单元格内行文标记同样剥离)
        if "|" in line and line.strip().startswith("|"):
            raw_cells = [c.strip() for c in line.strip().strip("|").split("|")]
            if all(TABLE_SEP_RE.match(c) for c in raw_cells):
                continue
            cells = [_inline(c, defs) for c in raw_cells]
            label = cells[0]
            rest = ",".join(c for c in cells[1:] if c)
            out_lines.append(f"{label}:{rest}" if rest else label)
            continue

        if list_style in ("emoji", "plain"):
            li = _emoji_list(line) if list_style == "emoji" else _plain_list(line)
            if li:
                out_lines.append(li[0] + _inline(li[1], defs))
                continue

        out_lines.append(_inline(line, defs))

    # 压缩 3+ 空行为 2 个;去首尾空行(只 strip 换行,保留首行缩进——文档可能以代码块开头)
    text = "\n".join(out_lines)
    text = re.sub(r"\n{3,}", "\n\n", text).lstrip("\n").rstrip() + "\n"

    # 文末附图注清单
    if images:
        text += "\n—— 配图清单 ——\n"
        for i, alt in enumerate(images, 1):
            text += f"[图{i}] {alt or '(未写图注)'}\n"

    return _restore_escapes(text, esc_store), images


def main() -> None:
    ap = argparse.ArgumentParser()
    ap.add_argument("input", help="输入 Markdown")
    ap.add_argument("--out", default=None, help="输出 X发布稿.txt(缺省 <md 所在目录>/out/X发布稿.txt)")
    ap.add_argument("--list-style", choices=["plain", "emoji", "keep"], default="plain",
                    help="列表写法:plain(默认,「· 」/「1)」)、emoji(🔹/▫️/1️⃣)或 keep(保留 - / 1.)")
    args = ap.parse_args()

    inp = Path(args.input)
    if not inp.is_file():
        if inp.is_dir():
            sys.exit(f"错误:输入是目录不是文件 {inp}")
        sys.exit(f"错误:找不到输入文件 {inp}")
    try:
        md = inp.read_text(encoding="utf-8-sig")
    except UnicodeDecodeError:
        sys.exit(f"错误:输入文件不是有效的 UTF-8 编码 {inp}")
    except OSError as e:
        sys.exit(f"错误:无法读取输入文件 {inp}({e})")
    text, images = convert(md, args.list_style)

    out = Path(args.out) if args.out else inp.resolve().parent / "out" / "X发布稿.txt"
    try:
        out.parent.mkdir(parents=True, exist_ok=True)
        out.write_text(text, encoding="utf-8")
    except OSError as e:
        sys.exit(f"错误:无法写入输出文件 {out}({e})")

    chars = len(text.replace("\n", ""))
    print(f"OK {out}")
    print(f"正文约 {chars} 字,配图 {len(images)} 张")


if __name__ == "__main__":
    main()
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall