Markdown Mobile Export

把本地 Markdown 文件或粘贴文本渲染成移动端友好的长图（PNG/JPG），保持原文不改写；优先调用本地 Chromium 类浏览器整页截图，不可用时回退 Playwright Chromium，并保留 HTML 文件供检查。

linsuisheng034

热度 83.40

最近更新 2026-05-17 15:47:14

分类：效率依赖：代码执行 / 联网浏览搜索 / 读写文件应用场景：文件转换 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add markdown-mobile-export

Metadata

name: markdown-mobile-export
description: Use when a task needs a local Markdown file path or pasted Markdown text converted into a faithful mobile-friendly PNG/JPG long image for phone-readable articles, guides, notes, or reports, with HTML kept beside the image for inspection.
argument-hint: [--input-file path | --markdown-text text]
metadata: {"version":"0.1.0"}

Markdown Mobile Export

Faithful Markdown → mobile long image, no content rewriting.

When to Use

Local .md file → phone-friendly long image
Pasted Markdown text → PNG or JPG
Article-style faithful export (not poster or carousel redesign)
Intermediate HTML needed for inspection alongside image

Do Not Use

Poster redesigns where content should be rewritten into marketing blocks
Carousel slicing across multiple images
Rich web app UI design work
PDF output

Quick Start

# From file
python3 {baseDir}/scripts/markdown_to_long_image.py \
  --input-file /path/to/file.md

# From pasted text
python3 {baseDir}/scripts/markdown_to_long_image.py \
  --markdown-text "# Title\n\nBody"

# Custom output path and format
python3 {baseDir}/scripts/markdown_to_long_image.py \
  --input-file /path/to/file.md \
  --output-image /path/to/output.png \
  --format jpg

Defaults

Aspect	Default
Input	Markdown file path or pasted text
Output	PNG long image + HTML sidecar retained on disk
Style	Faithful conversion, mobile-first, zh-CN typography
Width	820px card layout with warm earth-tone theme
Browser	Local Chrome/Chromium/Edge/Brave → Playwright fallback

Workflow

Resolve input (--input-file or --markdown-text)
Normalize pasted text into a concrete .source.md file when needed
Render mobile-friendly HTML with embedded CSS
Detect local Chromium-family browser
Capture full-page screenshot (segmented stitch with overlap)
Fall back to Playwright Chromium if no local browser is usable
Print JSON result with output_html and output_image paths

Scripts

Script	Purpose
`scripts/markdown_to_long_image.py`	CLI entry point, orchestrates pipeline
`scripts/render_markdown_mobile_long_image.py`	Markdown → styled mobile HTML
`scripts/export_long_image.py`	Browser detection + screenshot export

References

Topic	File
Pipeline details	`references/workflow.md`
Common issues	`references/troubleshooting.md`

Validation

After generating output, verify:

HTML file exists at reported path
Image file exists and is non-zero bytes
Image is full-page capture (not single viewport crop)
Remote images loaded without broken placeholders