如何在PySide GUI中生成Jira工单Markdown预览PNG？

问题背景 #

我正在开发一款对接Jira的PySide GUI工具，希望在提交工单前给用户提供「工单预览」功能——既让用户提前看到工单的实际显示样式，也能提前排查可能导致Jira解析异常的语法错误。核心需求是把用户输入的Jira格式文本转换成PNG图片，但目前还没找到可行的实现方法，求具体方案建议。

示例需求 #

假设用户输入的Jira文本如下：

{panel:title=Test|borderStyle=none|titleBGColor=#f7d6c1|bgColor=#fdf4ee}
Hello, World!
{panel}

需要将这段文本渲染成和Jira原生显示一致的PNG：带有橙色标题栏、浅橙色背景的无框面板，内部显示"Hello, World!"。

已尝试但无效的方案 #

曾尝试用jira2markdown工具走「Jira格式 → 通用Markdown → Pygments → PNG」的流程，但转换时会丢失所有样式信息。比如上述示例转成通用Markdown后变成：

> **Test**
> Hello, World!

背景色、标题栏样式等关键信息全部丢失，完全达不到预览要求。

可行实现方案 #

方案1：无头浏览器渲染（精准还原首选） #

Jira的格式渲染依赖其官方CSS和前端逻辑，用无头浏览器模拟Jira的渲染环境是最能保证效果一致的方法：

• 工具选择：Playwright或Selenium（推荐Playwright，API更简洁，内置无头模式）
• 具体步骤：
  1. 提前获取Jira官方的渲染CSS（可直接从Jira页面抓取，或通过API获取）
  2. 用Playwright启动无头浏览器，构造包含Jira CSS的HTML页面，将用户输入的Jira文本转换成Jira对应的HTML结构（复杂场景可调用Jira的/rest/api/3/render接口直接获取官方渲染后的HTML）
  3. 将构造好的HTML加载到浏览器中，等待渲染完成后对目标区域截图
  4. 将截图保存为PNG文件
• 优势：1:1还原Jira的显示效果，支持所有Jira格式标签
• 注意：需处理Jira的登录权限（若调用官方API），并将渲染逻辑放到后台线程避免阻塞GUI

方案2：自定义解析+Pillow绘图（轻量化备选） #

如果不想依赖浏览器，可以自己解析常用的Jira标签，用Python绘图库手动绘制预览图：

• 工具选择：Pillow（Python Imaging Library）
• 具体步骤：
  1. 编写简单的解析器，提取Jira标签的关键属性（比如{panel}的title、bgColor、borderStyle等）
  2. 用Pillow创建画布，根据解析结果设置背景色、绘制标题栏（匹配对应背景色、字体样式）
  3. 添加文本内容，调整字体、行间距、对齐方式，尽量贴近Jira的默认样式
  4. 保存画布为PNG
• 优势：无需网络和浏览器依赖，轻量化，适合简单格式的预览
• 注意：仅能覆盖常用基础标签（panel、粗体、斜体等），复杂标签（表格、代码块、嵌套格式）的解析和绘制成本较高，效果可能和Jira有细微差距

方案3：调用Jira官方API获取渲染结果 #

直接利用Jira的服务器渲染能力，再转成图片：

• 具体步骤：
  1. 调用Jira REST API的/rest/api/3/render接口，传入用户输入的Jira文本，获取官方渲染后的HTML
  2. 将获取到的HTML加载到无头浏览器中截图，保存为PNG
• 优势：完全使用Jira官方的渲染逻辑，效果100%匹配
• 注意：需要用户提供Jira账号的API权限，网络请求会有一定延迟，需在GUI中处理加载状态

内容的提问来源于stack exchange，提问作者ColinKennedy