Renaissance Markdown → HTML
目标
- 输入:UTF-8 Markdown 字符串(或
.md文件路径)。 - 输出:完整 HTML 文档字符串(含
<!DOCTYPE html>、内联 CSS),正文包在<article class="wmr-renaissance">内。 - 样式来源:本 skill 内
assets/renaissance.css,与仓库src/themes.ts的renaissanceStyles对齐。 - 默认增强:自动将 Markdown 图片转为 base64 data URI,并在页面右上角注入“一键复制全文(富文本)”按钮。
必须执行的命令
在 skill 目录下执行(将 <SKILL_DIR> 换为本 skill 根路径,即含 SKILL.md 的目录):
cd <SKILL_DIR>
# 若首次使用:
npm install
从标准输入传入 Markdown:
printf '%s' "$MARKDOWN_STRING" | node scripts/md_to_renaissance_html.mjs --title "页面标题"
从文件读取:
node scripts/md_to_renaissance_html.mjs --input /path/to/article.md --title "页面标题"
脚本向 stdout 打印最终 HTML;将输出保存到变量或文件交给用户即可。
参数
| 参数 | 说明 |
|---|---|
--input <path> |
读取 Markdown 文件(与 stdin 二选一;若同时存在,以 --input 为准) |
--title <text> |
<title> 与浏览器标签页标题,默认 Document |
--no-embed-images |
关闭图片 base64 内嵌(默认开启) |
--no-copy-button |
关闭“一键复制全文(富文本)”按钮(默认开启) |
Agent 注意事项
- 始终通过脚本生成 HTML,不要凭记忆拼接样式;CSS 以
assets/renaissance.css为准。 - 若工作区即本仓库,skill 路径一般为:
.cursor/skills/renaissance-md-html/(相对仓库根目录)。 - 若
node_modules不存在,先在该目录执行npm install。 - 用户只要「片段」时,仍可先跑脚本得到完整文档,再按需截取
<article>...</article>或仅内部 HTML(需说明截取后无全局<style>时需保留内联或外链 CSS)。 - 默认输出为“图片已内嵌 + 复制按钮已注入”;如果用户明确不要,则追加
--no-embed-images或--no-copy-button。
依赖
- Node.js 18+
marked(见package.json,用于 GFM:表格、删除线等)