本文系统展示并自检 ModernBlog 可视化编辑器内置的全部 31 种模块化组件——涵盖基础排版、提示高亮、结构布局、技术学术与媒体资源五大分类,同时支持在后台可视化编辑器中 100% 无损二次编辑。
31 种创作者模块Apple HIG 扁平美学KaTeX 数学公式Mermaid 流程图定制音频播放器零渐变设计
一、基础排版(7 种)¶
正文段落支持完整的行内富文本语法:加粗强调、斜体语气、删除线修订、下划线标注、荧光高亮、inline_code()、按键组合 Ctrl + S、行内公式 $E = mc^2$ 与 $\alpha + \beta = \gamma$,以及 ModernBlog 开源仓库 行内超链接。
- 无序列表:适合快速罗列要点与灵感
- 支持多行自由编辑,自动生成语义化列表
- 清晰紧凑的行距与左侧对齐
- 打开 ModernBlog 后台可视化编辑器
- 按分类挑选所需模块并拖拽排序
- 一键构建静态站点并预览最终效果
- 完成 31 种可视化创作者模块与 5 大分类标签页
- 修复块级与行内 KaTeX 数学公式、删除线、高亮与下划线渲染
- 修复折叠面板内边距、松散列表待办复选框与多行模块往返解析
- 继续创作更多高质量原创内容
好的工具应当隐于内容之后,让创作者专注于表达本身,而不是与排版和样式搏斗。
二、提示高亮(5 种)¶
[!TIP]
提示框(Callout)支持 NOTE、TIP、IMPORTANT、WARNING、CAUTION 五种语义类型,适合在技术教程或评测中突出关键注意事项。
点击展开折叠面板(Details)— 查看排版细节
折叠面板展开后会自动将正文包裹进 .details-body 容器并保持舒适的四周内边距,适合收纳长段补充说明、更新日志或附录配置。剧透内容 · 点击查看
防剧透遮罩(Spoiler):默认模糊隐藏,点击即可清晰展开或再次收起,适合影评、游戏剧情分析与谜题答案。
三、结构布局(7 种)¶
| 模块分类 | 模块数量 | 典型应用场景 | 渲染引擎 |
|---|---|---|---|
| 基础排版 | 7 种 | 标题、导语、富文本、列表、待办、引用 | Python-Markdown + GFM |
| 提示高亮 | 5 种 | 提示框、横幅、折叠面板、防剧透、徽章 | 语义容器 + JS 交互 |
| 结构布局 | 7 种 | 表格、双栏、卡片、时间轴、步骤、参数、优缺点 | CSS Grid 自适应 |
| 技术学术 | 6 种 | 代码、终端、Diff、LaTeX 公式、Mermaid、快捷键 | Pygments + KaTeX + Mermaid |
| 媒体资源 | 6 种 | 单图灯箱、画廊、音视频、书签、附件、HTML | 定制播放器 + 灯箱 |
左栏 · 极致静态性能
纯静态 HTML/CSS/JS 产物,零数据库与后端开销,支持任意 CDN 边缘缓存与毫秒级首屏渲染。
纯静态 HTML/CSS/JS 产物,零数据库与后端开销,支持任意 CDN 边缘缓存与毫秒级首屏渲染。
右栏 · 现代创作体验
31 种模块自由拼装与拖拽排序,可视化编辑与纯 Markdown 源码模式一键无损互转。
31 种模块自由拼装与拖拽排序,可视化编辑与纯 Markdown 源码模式一键无损互转。
零渐变克制美学
通篇采用 Apple HIG 扁平材质与精细高光边框,彻底告别廉价渐变与视觉噪音。
全端响应式布局
桌面端宽屏阅读与移动端单列自适应无缝衔接,双栏与对比模块自动堆叠。
开箱即用容灾
KaTeX 与 Mermaid 均内置多 CDN 自动回退加载,复杂技术文章稳定呈现。
Phase 1
静态生成器与暗色主题
确立零依赖静态构建流程与 Apple HIG 视觉基调。
Phase 2
正文媒体与交互增强
上线定制音频卡片、全屏图片灯箱、代码语言徽章与一键复制。
Phase 3
31 模块创作者工作台
可视化编辑器扩充至 31 种模块并完成全量浏览器端到端验证。
1
启动管理面板
在项目根目录运行 python main.py,浏览器打开 http://127.0.0.1:32323。
2
模块化编排内容
在可视化编辑器中按需插入标题、公式、图表、画廊或定制音频播放器。
3
一键构建并部署
点击「立即构建」生成 public/ 静态产物,推送到 GitHub Pages、Cloudflare Pages 或任意服务器。
静态构建引擎Python 3 + Markdown + Jinja2
数学公式引擎KaTeX 0.16(多 CDN 容灾)
图表渲染引擎Mermaid 11(暗色 SVG 自适应)
可视化模块总数31 种(5 大分类,支持无损往返)
优点
- 纯静态部署成本几乎为零
- 31 种内容模块覆盖绝大多数创作场景
- 可视化编辑与 Markdown 源码随时切换
不足
- 需要本地或 CI 环境执行静态构建
- 互动评论需额外接入第三方评论组件
四、技术学术(6 种)¶
def quick_sort(nums: list[int]) -> list[int]:
if len(nums) <= 1:
return nums
pivot = nums[len(nums) // 2]
left = [x for x in nums if x < pivot]
mid = [x for x in nums if x == pivot]
right = [x for x in nums if x > pivot]
return quick_sort(left) + mid + quick_sort(right)
TERMINAL
python builder.py && python -m http.server 8090 --directory public
[OK] 构建完成!40 篇文章,耗时 2.18s
Serving HTTP on :: port 8090 (http://[::]:8090/) ...
def render_markdown(raw_text: str) -> str:
- return markdown.markdown(raw_text)
+ normalized = raw_text.replace("\r\n", "\n")
+ return render_with_katex_and_gfm(normalized)
$$
f(x) = \int_{-\infty}^{\infty} \hat{f}(\xi)\,e^{2\pi i \xi x}\,d\xi \quad\Longrightarrow\quad \sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
$$
flowchart LR
A[可视化编辑器 31 模块] --> B[Markdown 语义序列化]
B --> C[builder.py 静态构建]
C --> D[浏览器 KaTeX / Mermaid / 交互增强]
Ctrl + Shift + S在编辑器中快速保存当前文章草稿
五、媒体资源(6 种)¶



附件:ZeroTermux Android 安装包 (APK 附件下载卡片)
自定义 HTML 嵌入块:当 30 种标准模块之外仍有特殊排版需求时,可直接嵌入任意原生 HTML 片段。