欢迎加入开源鸿蒙PC社区 https://harmonypc.csdn.net欢迎在PC社区平台申请新建项目https://atomgit.com/OpenHarmonyPCDeveloper摘要芯笺 Markdown 是一款面向 HarmonyOS PC / 2in1 的本地 Markdown 编辑器现已上架。它不以笔记库或云同步为中心而是把用户自己的.md/.txt当作唯一事实来源。1.0 不申请ohos.permission.INTERNET不要求登录不上传文档。本文说明它的产品边界、核心能力以及在鸿蒙电脑上的实际用法。1. 为什么先做鸿蒙电脑现有鸿蒙 Markdown 产品更常见于手机或平板形态。电脑端真正缺的是键鼠、多窗口、命令面板、右键菜单打开本地文件和文件夹而不是先建知识库源码保真未编辑内容保存后字节级一致公式、图表、代码的离线预览崩溃恢复和外部修改冲突而不是静默覆盖芯笺把这些作为 1.0 范围。平板、手机、云同步、AI 明确不做。也不把「鸿蒙第一个 PC Markdown」当作宣传点因为这个结论没有完整市场清查支撑。2. 产品形态项目1.0 选择平台仅 HarmonyOS PC / 2in1包名com.von.ohmarkdown应用市场名称芯笺 Markdown存储模型本地文件 文件夹工作区网络不申请 INTERNET权限PRINT以及前台READ_PASTEBOARD编辑内核ArkUI 工作台 ArkWeb 内嵌 CodeMirror 6渲染CommonMark / GFM离线 KaTeX / Mermaid / 代码高亮它不是 IDE也不是 Obsidian 式数据库。一个窗口里是文件树、标签、编辑区和预览。文档路径对用户可见备份和迁移用系统文件管理器即可完成。空状态只有三个动作新建、打开文件、打开文件夹。新建后是空白文档左侧随时能切回这两个入口。源码工作台保持 PC 文件语义左侧目录中间正文标签对应真实文件。3. 安装与权限在华为应用市场搜索「芯笺 Markdown」。确认设备是鸿蒙电脑或二合一不要按平板安装预期来用。首次粘贴系统剪贴板内容时允许读取剪贴板。该权限只在前台编辑时使用不后台监听。打印或保存 PDF 时走系统打印框架。隐私政策里应出现READ_PASTEBOARD。没有定位、通讯录、相机、麦克风、网络权限。4. 基本使用路径4.1 单文件CtrlN新建或CtrlO打开已有 Markdown / TXT。在源码或分栏中编辑。CtrlS保存。首次保存使用系统文档选择器。另存为不会覆盖原文件。支持的扩展名.md、.markdown、.mdown、.mkd、.txt。UTF-8 BOM、LF / CRLF / 混合换行在未改写时会保留。4.2 文件夹工作区选择「打开文件夹」并授权本地目录。文件树按需展开不在启动时扫描整个仓库。点击文件在标签中打开右键可折叠目录或在工作区中查找该文件。CtrlP按文件名模糊打开CtrlShiftF做全文搜索。工作区授权在强杀后可能丢失需要重新授权。这是当前实现边界不是云同步失败。4.3 四种视图快捷键模式行为Ctrl1源码只显示 Markdown 源码Ctrl2分栏源码与预览并排可同步滚动Ctrl3预览全页阅读渲染结果Ctrl4即时同一EditorState上的可见范围渲染光标进入结构后显示必要标记四种模式共享同一文本缓冲区。切换视图不会把 Markdown 转成富文本再导回。大文件会进入保护模式优先保证源码可编辑必要时降级预览。分栏用于边写边核对渲染公式走离线 KaTeX不请求外网阅读态使用纯预览即时模式仍然编辑同一份 Markdown 源码5. 功能怎么用编辑列表延续、Tab / ShiftTab 调整层级可持久化自动配对如[]表格行、列的插入和删除走单次事务一次撤销即可回到原状当前文档查找替换CtrlF支持大小写、整词、正则导航大纲面板按标题跳转CtrlK插入相对路径或#标题锚点CtrlShiftK离线校验本地链接越界路径会被拒绝预览里的本地链接可点击打开对应文档命令面板覆盖新建、打开、导出和查找避免把菜单点一遍图片与资源剪贴板图片、拖入图片会先写入资源目录成功后插入相对链接默认目录是「当前文档.assets」可改为共享 assets拖入策略默认复制可改为移动混合非图片批次会被整体拒绝外部网络图片不会在离线预览里加载专业预览GFM 表格、任务列表、删除线KaTeX 公式错误定位到行严格模式 Mermaid非法图表只隔离当前块代码高亮仅允许已知语言结果再净化注意预览任务 checkbox 是只读展示点击不会改源码。完成状态仍以 Markdown 源码为准。导出设置面板提供导出 HTML自包含、带 CSPscript-src为 none导出预览 PNG打印 / 保存 PDF系统打印预览选择 PDF 打印机分享 Markdown系统分享面板发送当前缓冲区可靠性自动保存策略关闭保存、延迟保存、失焦保存未保存关闭三态取消 / 丢弃 / 保存版本历史有界快照比较后恢复到未保存缓冲区不直接覆盖磁盘外部冲突指纹检测后给出保留本地、使用磁盘、三方比较多窗口每个系统窗口独立会话强杀后可恢复脏稿窗口6. 快捷键命令默认新建文档CtrlN打开文档CtrlO保存CtrlS当前文档查找CtrlF工作区搜索CtrlShiftF快速打开CtrlP插入链接CtrlK校验链接CtrlShiftK源码Ctrl1分栏Ctrl2预览Ctrl3即时Ctrl4命令面板CtrlShiftP快捷键可在设置中改绑。CtrlC / X / V / Z仍由系统剪贴板和撤销栈处理。7. 已知边界文件管理器双击.md可能进入系统文本编辑器而不是芯笺。这是 1.0.1 优先项不应当成已完成能力来写。上架检测不允许普通 Ability 声明datasharescheme因此文件关联目前只保留file协议。强杀后工作区授权可能丢失需要用户再次选择文件夹。没有互联网权限因此没有在线更新、云同步、远程图床和 AI。1.0 不适配平板和手机。8. 结语芯笺 Markdown 的 1.0 目标很窄在鸿蒙电脑上提供一个可靠、离线、源码保真的 Markdown 工作台。如果你的工作流是「文件在自己手里用电脑键盘写完再导出」它就是按这个路径设计的。应用市场名称芯笺 Markdown。包名com.von.ohmarkdown。