1# Article Posting (文章发表)
2 
3Post markdown articles to WeChat Official Account with full formatting support.
4 
5## Usage
6 
7```bash
8# Post markdown article
9${BUN_X} ./scripts/wechat-article.ts --markdown article.md
10 
11# With theme
12${BUN_X} ./scripts/wechat-article.ts --markdown article.md --theme grace
13 
14# Disable bottom citations for ordinary external links
15${BUN_X} ./scripts/wechat-article.ts --markdown article.md --no-cite
16 
17# With explicit options
18${BUN_X} ./scripts/wechat-article.ts --markdown article.md --author "作者名" --summary "摘要"
19```
20 
21## Parameters
22 
23| Parameter | Description |
24|-----------|-------------|
25| `--markdown <path>` | Markdown file to convert and post |
26| `--theme <name>` | Theme: default, grace, simple, modern |
27| `--no-cite` | Keep ordinary external links inline instead of converting them to bottom citations |
28| `--title <text>` | Override title (auto-extracted from markdown) |
29| `--author <name>` | Author name |
30| `--summary <text>` | Article summary |
31| `--html <path>` | Pre-rendered HTML file (alternative to markdown) |
32| `--profile <dir>` | Chrome profile directory |
33 
34## Markdown Format
35 
36```markdown
37---
38title: Article Title
39author: Author Name
40---
41 
42# Title (becomes article title)
43 
44Regular paragraph with **bold** and *italic*.
45 
46## Section Header
47 
48![Image description](./image.png)
49 
50- List item 1
51- List item 2
52 
53> Blockquote text
54 
55[Link text](https://example.com)
56```
57 
58Markdown mode converts ordinary external links into bottom citations by default for WeChat-friendly output. Use `--no-cite` to disable that behavior.
59 
60## Image Handling
61 
621. **Parse**: Images in markdown are replaced with `WECHATIMGPH_N`
632. **Render**: HTML is generated with placeholders in text
643. **Paste**: HTML content is pasted into WeChat editor
654. **Replace**: For each placeholder:
66   - Find and select the placeholder text
67   - Scroll into view
68   - Press Backspace to delete the placeholder
69   - Paste the image from clipboard
70 
71## Scripts
72 
73| Script | Purpose |
74|--------|---------|
75| `wechat-article.ts` | Main article publishing script |
76| `md-to-wechat.ts` | Markdown to HTML with placeholders |
77| `md/render.ts` | Markdown rendering with themes |
78 
79## Example Session
80 
81```
82User: /post-to-wechat --markdown ./article.md
83 
84Claude:
851. Parses markdown, finds 5 images
862. Generates HTML with placeholders
873. Opens Chrome, navigates to WeChat editor
884. Pastes HTML content
895. For each image:
90   - Selects WECHATIMGPH_1
91   - Scrolls into view
92   - Presses Backspace to delete
93   - Pastes image
946. Reports: "Article composed with 5 images."
95```
96