MarkView 是一个纯前端的本地 Markdown 实时预览工具https://markview.art左侧 CodeMirror 6 编辑右侧实时渲染所有数据保存在浏览器 IndexedDB 中无需任何后端。支持暗色/浅色主题、命令面板、URL 分享并可作为 PWA 离线安装甚至能注册为系统的.md文件处理器——双击本地文件直接用它打开。本文不逐个罗列功能而是聊聊它背后的架构取舍如何在一个没有后端、没有状态管理库的 Vue 3 项目里把编辑器、渲染、持久化、搜索、同步这些子系统组织得清晰可测。一、为什么是「纯前端」先说定位。市面上 Markdown 工具很多MarkView 选择了一条约束最强的路线零后端没有服务器、没有账号体系文档全部存在浏览器 IndexedDB零上传分享靠把文档压缩进 URL hash链接自包含离线可用PWA 预缓存构建产物断网也能正常编辑预览。这个约束反过来塑造了很多技术决策。比如图片没有后端就没有图床于是粘贴/拖拽的图片被压缩缩放 WebP 编码成 base64 直接内联进文档——图片随文档一起存本地分享和导出天然自包含。再比如 PDF 导出不引 html2pdf 这类庞大依赖直接调浏览器原生打印得到文字可选、体积小的矢量输出版式交给一份media print样式表。二、CodeMirror-First 分层架构项目最核心的设计是一套严格单向依赖的分层components哑组件inject 工作区直接消费 ↓ workspace响应式状态 横切编排 ↓ controllersEditorController / PreviewController命令式门面 ↓ core纯逻辑领域层零 Vue、零 DOMVitest 直测core零 Vue、零 DOM 的领域层最底层的core/是纯函数世界文档模型、IndexedDB 存储、保存状态机、Markdown 渲染与源行标注、跨文档搜索、滚动锚点表、分享链接编解码……全部不依赖 Vue 和 DOM。好处非常直接这一层可以被 Vitest 直测不需要挂载组件、不需要模拟浏览器环境。测试文件与被测模块同目录放置比如保存状态机的防抖、竞态、串行化逻辑都是纯逻辑单测// core/documents/persistenceScheduler.js// 保存状态机防抖调度 revision 防竞态 Promise 链串行化写入。// 存储实现save与快照来源getSnapshot以参数注入不依赖 Vue 与 DOM。exportconstcreatePersistenceScheduler({getSnapshot,save,canPersist,onStatus,}){// ...};依赖注入贯穿整层存储怎么写、快照怎么取都是参数。测试时换成内存实现即可。controllers命令式能力的唯一入口CodeMirror 6 和预览区 DOM 本质上是命令式的设光标、滚动到某行、高亮某段。这些能力被收进两个门面——EditorController与PreviewController它们是组件之下操作编辑器/预览的唯一入口。EditorController还承担多文档的EditorState缓存每个文档拥有独立的撤销历史切换文档时换 state 而不是重建编辑器。workspace响应式状态与横切编排workspace/持有全部响应式状态按职责拆成会话文档会话多文档 CRUD 持久化、搜索会话、布局会话分栏宽度/折叠/目录宽度、预览渲染会话等。跨子系统的流程——比如「搜索命中后定位到行并双侧高亮」「折叠编辑区时把按钮移入预览区头部」——集中在orchestrations.js不散落在组件里。createWorkspace.js负责把这一切组装起来通过provide下发。components只管 UI 的哑组件最上层的组件通过inject拿到工作区直接消费自身不含业务逻辑。工具栏、命令面板、目录、搜索面板……都只是状态的投影和动作的转发。这套分层的收益是变更有明确的落点。加一个「导出 HTML」功能纯逻辑进services/exporter.js动作挂到 workspace组件加个按钮三层各改一处互不渗透。三、几个关键子系统的取舍渲染进 Web WorkerMarkdown 渲染marked 解析 代码高亮 源行标注对长文档来说不便宜跑在主线程会卡输入。MarkView 把渲染整体搬进了 Web Worker// workspace/markdownRenderer.js// Markdown 渲染调度优先用 Web Worker渲染在后台线程主线程不卡顿// Worker 不可用时动态 import 同步渲染降级保持主 bundle 精简仅降级时才加载。// 用递增序号丢弃过期结果避免快速输入时旧结果覆盖新结果。三个细节值得注意降级路径Worker 不可用时动态import同步渲染模块——降级代码不进主 bundle只有真正降级时才加载序号防乱序快速输入时会有多个渲染请求在途用递增序号丢弃过期结果保证旧结果不会覆盖新结果渲染是纯函数renderMarkdown.js本身在 core 层Worker 只是它的一个宿主。滚动同步锚点表 单调插值编辑区和预览区的双向滚动同步是 Markdown 工具的经典难题——两侧内容高度不成线性比例一行 Markdown 可能渲染成一张大图。MarkView 的做法是渲染时给块级元素标注源码行号再据此构建锚点表// core/sync/anchorMap.js// 构建锚点表pairs 是若干对已对齐的滚动偏移 { editor, preview }。// 两端各加一个哨兵锚点把文档顶部与底部钉在一起使两侧能同时到达 0 和最大值。// 只保留严格落在两侧滚动范围内、且在两个轴上都严格递增的锚点// 以保证每一段插值都是单调的。锚点之间线性插值配合「滚动主控方」标记防止两侧互相触发形成回环。这套逻辑同样是纯函数边界情况锚点乱序、超出滚动范围全部有单测覆盖。URL 分享文档压缩进 hash没有后端分享怎么做答案是 lz-string// core/share/shareLink.jsexportconstencodeSharePayload({name,content,anchor}){constpayloadJSON.stringify({n:name||,c:content||,...(anchor?{a:anchor}:{}),});returncompressToEncodedURIComponent(payload);};文档名和内容 JSON 序列化后用 lz-string 的 URI 变体压缩直接放进 URL hash。链接自包含——打开即还原文档还可以携带标题锚点直达某一节。hash 不会发往服务器天然私密。PWA不止离线还是文件处理器除了常规的预缓存离线MarkView 在 manifest 里注册了file_handlersfile_handlers:[{action:base,accept:{text/markdown:[.md,.markdown]}}],launch_handler:{client_mode:[focus-existing,auto]}安装为 PWA 后它成为系统里.md/.markdown文件的处理器——双击文件操作系统唤起 MarkView 应用侧由launchQueue消费者接收文件句柄并导入为新文档。launch_handler设为优先复用已有窗口避免每次双击都新开实例。一个 Web 应用就这样长出了一点「桌面应用」的质感。四、工程化闭环最后是保证质量的一揽子配置一条命令跑完全部校验pnpmcheck# lint 格式检查 测试 构建ESLint--max-warnings0警告即失败Prettier 统一格式Vitest 直测 core 层与 workspace 编排逻辑最后跑一次生产构建确保产物健康。结语MarkView 的经验可以浓缩成三句话约束是设计的朋友——「零后端」逼出了图片内联、URL 分享、原生打印这些干净的方案纯逻辑下沉是可测试性的根基——core 层零 Vue 零 DOM测试成本低到没有借口不写命令式的世界要有门面——CodeMirror 和 DOM 的复杂性被 controller 挡住上层始终面对声明式接口。关于多标签页打开时文档状态如何实时同步、编辑中的内容如何保证不被覆盖展开来又是一套有意思的机制我写在了另一篇多标签页文档同步。
企业数字化 ERP 产品动态
相关推荐
Ubuntu 24.04下NVIDIA驱动与CUDA安装优化指南 1. Ubuntu 24.04下NVIDIA驱动与CUDA工具包安装指南 刚装完Ubuntu 24.04准备跑深度学习时,最头疼的就是显卡驱动和CUDA环境配置。上周给实验室三台工作站装机时,就遇到NVIDIA-SMI报错"couldnt communicate with the NVIDIA driver"的经典问题。… · 2026/10/31 19:12:43
LuckFox Pico Plus串口开发实战指南 1. LuckFox Pico Plus开发板串口应用开发概述作为一款基于RV1103处理器的嵌入式开发板,LuckFox Pico Plus凭借其紧凑的尺寸和丰富的接口资源,在物联网边缘计算领域展现出独特优势。串口通信作为嵌入式系统中最基础也最可靠的通信方式之一,在设… · 2026/11/21 4:16:10
WSL2开发环境配置与性能优化实战指南 1. WSL2:Windows与Linux开发环境无缝融合作为一名在跨平台开发领域摸爬滚打多年的老手,我至今记得第一次在Windows上成功运行原生Linux命令时的震撼。WSL2(Windows Subsystem for Linux 2)彻底改变了游戏规则——它不再是简单的命… · 2026/11/21 14:24:11
工地太忙根本没时间复习考试?考电工证交社保合适吗怎么报名全攻略 工地太忙根本没时间复习考试?考电工证交社保合适吗怎么报名全攻略 工地太忙根本没时间复习考试,这是很多一线工人心里的无奈。特别是像三门峡这样的工程类毕业生,刚出校门就投身工地,一边要跟上施工节奏,一边还要抽空准备电工证考试,简直是两头难。更让… · 2026/11/23 1:23:07
济宁邹城电工证怎么考网上查询全攻略别怕考不过白交培训费 济宁邹城电工证怎么考网上查询全攻略别怕考不过白交培训费 怕考不过白交培训费?现在网上查询济宁邹城电工证怎么考的小伙伴越来越多,尤其是打算从事电气相关工作的朋友,但很多人第一次接触特种作业证报考,对流程、要求、通过率都一知半解,生怕钱花了事没… · 2026/11/23 1:23:07
电工证培训哪家专业怎么考 良心建议来了怕考不过白交培训费 电工证培训哪家专业怎么考 良心建议来了怕考不过白交培训费 怕考不过白交培训费?你不是一个人。现在电工证培训市场鱼龙混杂,很多工人花了几千块报名,结果考试挂了、复审没通过、甚至证书被注销,钱打了水漂。这事儿不是个例,而是很多人都踩过的坑。如果… · 2026/11/23 1:23:07
哪种电工证被社会认可 电子证书怎么考才靠谱 哪种电工证被社会认可 电子证书怎么考才靠谱 你是不是也在为不知道去哪报名、怕被中介坑而发愁?别急,我这有真实经验,讲的是焦作市政公用工程从业者的实际操作,不绕弯子,直接上干货。现在考电工证, 电子证书… · 2026/11/23 1:23:07
邯郸电工证哪里考网上查询太慢?工地太忙根本没时间复习考试 邯郸电工证哪里考网上查询太慢?工地太忙根本没时间复习考试 工地太忙根本没时间复习考试,这几乎是每个特种作业人员的共同痛点。尤其是像电工证这类在建筑、电力行业必不可少的证件,没有它就无法上岗,但复习时间又极度有限,考试难度却不低,让人头疼。别… · 2026/11/23 1:23:07
江阴电工证去哪里报名网上查询怕考不过白交培训费怎么解决 江阴电工证去哪里报名网上查询怕考不过白交培训费怎么解决 怕考不过白交培训费?这事儿真不少见,我见过太多人拿着钱去报名,结果考试一塌糊涂,培训费打水漂,连个证书都没拿到。其实你去【网上查询】一下,很多正规机构的报名流程、培训内容、考试难度都写… · 2026/11/23 1:22:07
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42
麻阳考电工证在哪里考内部消息你知道吗 麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43
工地太忙根本没时间复习考试?泗阳电工证快速办理内部消息全在这了 工地太忙根本没时间复习考试?泗阳电工证快速办理内部消息全在这了 工地太忙根本没时间复习考试,尤其是像你这样在信阳水利工程一线打拼的老电工,天天跟钢筋水泥打交道,哪还有空去背那些考试题?更别提现在办证流程越来越复杂,稍有不慎就可能耽误项目进度… · 2026/11/23 0:00:44
低压电工证复证材料千万别踩坑!这些材料你准备好了吗? 低压电工证复证材料千万别踩坑!这些材料你准备好了吗? 证书过期了不知道怎么复审延期?你不是一个人!现在不少电工朋友都在为低压电工证复证材料发愁,怕流程复杂、怕材料不全、怕耽误工作。其实,只要准备充分,复审一点都不难。今天就来带你一步步搞清楚… · 2026/11/23 0:00:44
上海哪里考电工证便宜真实经历分享:实操考试心里没底怕挂科 上海哪里考电工证便宜真实经历分享:实操考试心里没底怕挂科 实操考试心里没底怕挂科,这是很多准备考电工证的朋友的共同心声。尤其是在上海这样的大城市,报考渠道多、价格不一,很多人在报名前都会犹豫到底该去哪家机构,费用多少才算合理。我自己在驻马店… · 2026/11/23 0:00:44
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/22 20:41:13
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:30
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/22 23:39:58