给博客做了个 Markdown 写作器:全部组件一次看齐

作者头像
Lei
20小时前

全文约 1,296 字,读完约 4 分钟

最近把博客的写作流程换了一套:后台多了一个独立的 Markdown 写作页,左边写 Markdown,右边实时预览,保存的时候自动转成 HTML 存进文章。

对我这种「正文里经常要插提示框、按钮、折叠块」的写法,比在编辑器里一块块拖要顺手得多。这篇就把这套东西支持的组件全部过一遍,顺便当一份速查表,以后自己忘了也回来翻。

下面每一段都是真实渲染结果,不是截图。你在这页看到的样式,就是文章发出去之后的样子。

一、基础 Markdown 照常

平时怎么写还怎么写,没有额外负担:

  • 粗体、斜体、删除线、行内代码
  • 有序列表、无序列表
  • 引用、代码块、表格、分割线

引用块留给别人的话,或者一句想让人停下来的结论。

写法 效果
**文字** 文字
~~文字~~ 文字
`代码` | 代码
// 代码块标了语言就有高亮
function hello($name) {
    return 'hello, ' . $name;
}

二、提示类

标注

橙色标注,用来强调正文里最该被看见的那句话。

换成蓝色也没问题,color 里直接写十六进制色值就行。

提示条

操作成功,缓存已自动清理。
这套组件只在文章正文里生效。
改配置之前,先备份一次数据库。
接口返回 500,请稍后重试。

提醒框

蓝色提醒,右上角可以关掉。
红色提醒,适合放不可逆操作的说明。

三、进度与清单

进度条

72%

任务清单

打通后台保存接口

补齐暗色模式样式

写一份使用说明

时间轴

2026-10-01 立项,先把编辑器内核搬过来
2026-10-11 组件编译跑通,开始配前台样式
下一步:支持图床直传和草稿自动存

四、容器

折叠

点我展开:折叠里能放什么?

任何 Markdown 都能放——列表、代码块,甚至别的组件。编译是由内向外做的,所以嵌套多少层都不怕。

选项卡

工具栏点一下就插入一对标签,中间填内容。

纯 CSS 的 radio + label 方案,不依赖 JS,也没兼容性雷。

想加几个加几个,标签名写在 label 里。

卡片面板

卡片标题

把一段相对独立的内容包起来,视觉上和正文分开一档。

五、布局

宫格

宫格一
第一行说明

宫格二
第二行说明

宫格三
第三行说明

卡片列表

适合放并列的小条目
会跟着博客的暗色模式一起变

登录可见

该内容需要登录后查看 · 登录

六、装饰

按钮组

单个按钮也行:

绿色按钮

居中标题

装饰标题(带竖线)

七、内嵌

B站视频

直接粘视频地址就行,BV 号和分P会自动抠出来:

页面内嵌

需要把别的页面框进来的时候用它,高度可以直接写 360 或者 50vh:

八、实在不够用,还有原生 HTML

三个感叹号之间写什么都行,Markdown 解析器不会碰它:

—— 原生 HTML 块,写啥都得 ——

—

小结

100%

组件就这些。写的时候不用背语法,工具栏点一下就插入一对标签,中间填内容;保存时 Markdown 转成 HTML 存进文章,源文另外存一份,下次打开接着改,不用跟 HTML 打交道。

如果你也想在自己的博客上这么写,思路是通用的:编辑器负责产出 Markdown,服务端负责把标签编译成 HTML,两边分开,改哪边都不影响另一边。

在写这篇文章的时候,我已经把这个插件更新到了1.0.8最新版😏我太强了

收藏 0
打赏
遇上就已经很难了,来了就好好珍惜
上一篇
没有了
下一篇

发表评论

注册不是必须的

  1. 赞!

    • Lei UID:1

      谢谢๑•́₃•̀๑

  2. 倦意

    你好,我是倦意,在做一个小项目:博客汇(https://bkh.jyblog.com),一个通过 RSS 汇集独立博客文章的聚合站。

    我读了你的博客,觉得内容很好,已经先把你的博客收录进来了,展示页面在这里:https://bkh.jyblog.com/members/146

    网站只展示标题和摘要,读者点击会直接跳转到你的原博客。如果你不希望被收录,或者想调整展示的博客名称、头像等信息,可以进行博客认领自行修改,或者随时告诉我,我会立刻处理。

    冒昧打扰,希望没有给你造成困扰。也欢迎你看看网站,提提建议

今日时光
星期一
已过 12 天 剩余 19 天
39%
10月 共31天
未登录
登录后查看我的资料卡~
给博客做了个 Markdown 写作器:全部组件一次看齐
201 2 3

给博客做了个 Markdown 写作器:全部组件一次看齐

最近把博客的写作流程换了一套:后台多了一个独立的 Markdown 写作页,左边写 Markdown,右边实时预览,保存的时候自动转成 HTML 存进文章。 对我这种「正文里经常要插提示框、按钮、折叠块」的写法,比在编辑器里一块块拖要顺手得多。这篇就把这套东西支持的组件全部过一遍,顺便当一份速查表,以后自己忘了也回来翻。 下面每一段都是真实渲染结果,不是截图。你在这页看到的样式,就是文章发出去之后 […]
遇上就已经很难了,来了就好好珍惜
75 0 0

遇上就已经很难了,来了就好好珍惜

刷到过这样一句话: “遇上就已经很难了,当两个人能遇到并且同时相爱,并还愿意在一起的时候,就更更更难了,所以来了就好好珍惜。” 第一次看到的时候,没什么感觉。后来经历了一些人、一些事,再回头看这句话,忽然就懂了。 一、人这一辈子,会遇到多少人? 有人算过一笔账:一个人平均一生会遇到大约2920万人。 听起来很多。但在这2920万人里,你能叫得出名字的,可能不到500个;能说 […]
一篇文章带你听懂梁博《男孩》
66 0 1

一篇文章带你听懂梁博《男孩》

2017年3月25日,湖南卫视《歌手》舞台上,一个穿黑衬衫的男人抱着吉他坐下。前奏的钢琴声一响,全场安静。 他唱:”曾经以为我们会一起走完/就算有些事烦恼无助……” 这首歌叫《男孩》。它不是梁博最火的歌,但可能是最懂男人的那一首。 一、这首歌是怎么来的 很多人不知道,《男孩》是梁博大学时期写的歌,在《歌手2017》首演之前从未正式发布。 梁博后来在采访里说过,这首歌写的是他 […]
给博客接入百度 / 360 广告联盟:我写了 卡尼奶 广告位管理插件
211 0 0

给博客接入百度 / 360 广告联盟:我写了 卡尼奶 广告位管理插件

接入百度联盟 / 360联盟 的广告插件:八种投放位置(含首页信息流)、懒加载、设备/分类定向、展示统计与「广告」合规标识,专治 document.write 炸页面。

站点性能

运行正常
实时心跳-- ms
页面加载
-- 秒
SQL 查询
144 次
服务端响应
248 ms
峰值内存
16.4 MB
打赏收款二维码
扫描二维码
打赏二维码
扫描二维码
今日更新:0篇文章数目:48篇帖子数量:0篇评论数量:14条注册用户:3位运行时间:41天浏览次数:1.6万
开通会员
在手机上浏览此页面
蒙ICP备2026006345号-2