🚀 一键把 Markdown 转成优雅 HTML,我做了个小工具,效率飙升 10 倍!
你是不是也有以下烦恼?
- 写好的 Markdown,粘贴到 优快云 或公众号,一下子全乱了……
- 代码块样式土得掉渣,还不能切换主题?
- 想加点 Mermaid 图表、数学公式,却没地方处理?
😓 我的经历
做自动化自媒体的时候,我习惯用 Markdown 写文章进行排版,然后通过selenium访问 在线 Markdown 转换工具
- 粘贴 Markdown;
- 调整样式;
- 下载 HTML;
- 再复制粘贴……
用多了真的 又慢又蠢又容易出错。
于是我干脆写了个自己的服务 —— Media Assistant API,轻量部署 + 高度自定义,一键搞定:
- 🎨 自定义样式
- 📊 Mermaid 图表渲染
- ✍️ KaTeX 数学公式支持
- 💫 Mac 风格代码块高亮
- 🔗 脚注 + 引用链接支持
- 📱 响应式,适配移动端
- 🚀 可以通过参数传递,服务端实时渲染html并返回
✅ 项目地址(求个 Star ❤️)
👉 GitHub - media-assistant-api
开箱即用,Node 写的,非常轻量,前后端都能接。
✨ 能做什么?
🎨 自定义主题样式
不再被平台样式限制!你可以自由配置:
- 字体大小/颜色/行距
- 暗黑模式
- 自定义 CSS 文件覆盖全局(直接使用css链接即可)
- 可以自定义默认配置
- 几乎所有配置都能通过参数自定义
📊 Mermaid 图表
支持流程图、时序图、甘特图、类图等,写文档就像画画一样爽。
✍️ 数学公式 KaTeX
支持所有常见数学符号与公式排版,非常适合技术文章和教学内容。
E = mc^2
💫 Mac 风格代码块
仿 VSCode 风格,支持语言标识、复制按钮、高亮与行号。
🛠 API 使用示例
Markdown 转 HTML
POST /api/markdown/html
Content-Type: application/json
{
"data": "# 你的 Markdown 内容",
"isMacCodeBlock": true,
"fontSize": "20px",
"primaryColor": "#FA5151"
// 其他可定制化参数见项目
}
响应结果为 HTML 字符串,复制即用!
效果预览
支持直接预览参数效果,满意了再进行使用
http://127.0.0.1:8080/api/markdown/preview?isMacCodeBlock=true&fontSize=20px&primaryColor=%23FA5151
🚀 如何使用?
# 克隆项目
git clone git@github.com:code-innovator-zyx/media-assistant-api.git
cd media-assistant-api
# 安装依赖
pnpm install
# 启动开发服务
pnpm dev
🎯 适合哪些人?
- 自媒体作者、技术博主
- 想提高写作效率的 Markdown 用户
- 构建知识库、文档平台的开发者
❤️ 写在最后
写这个工具其实是因为自己用得太烦了,如果你也正好有类似的痛点,希望它能帮到你。
欢迎 Star、PR、提 issue,我们一起让 Markdown 更有力量!
👉 项目地址再次送上:https://github.com/code-innovator-zyx/media-assistant-api