芯稿 MarkDeck在 HarmonyOS PC 上用 Markdown 生成可编辑 PPT欢迎加入开源鸿蒙 PC 社区https://harmonypc.csdn.net欢迎在 PC 社区平台申请新建项目https://atomgit.com/OpenHarmonyPCDeveloper摘要芯稿MarkDeck是一款面向 HarmonyOS PC / 2in1 的离线 Markdown 演示文稿工具应用标识为com.von.markdeck。它把本地 Markdown 当作内容源在桌面工作区里完成逐页编辑、实时预览和.pptx导出。1.0 不要求登录不提供云同步和在线 AIMarkdown 解析、图片处理、预览与 PPTX 生成均在本机完成。本文说明它的产品边界、主要能力、在鸿蒙电脑上的实际用法与已知限制。1. 为什么要做 Markdown 转 PPT技术分享、课程讲义和项目汇报通常已经有一份 Markdown 草稿。真正重复的工作发生在进入演示软件之后拆页、复制标题、重建列表、给代码加底色、调整图片尺寸再逐页检查文字有没有出界。更大的问题是部分在线转换工具会把整页渲染成图片导出后只能移动和缩放不能直接修改文字。文档内容需要上传分享前的修改又要回到原工具里完成。芯稿针对的是一条更窄的路径使用本地.md文件不建立专有笔记库用 Markdown 组织内容用单独一行---划分页面在 PC 工作区中实时查看 16:9 幻灯片导出标准 OOXML.pptx保留文本、列表、表格、图片和代码等可编辑对象不依赖网络完成解析、预览和导出。首版明确服务 HarmonyOS PC / 2in1。手机端体验、反向编辑已有 PPTX、云同步和在线 AI 不在 1.0 范围内。2. 产品形态项目1.0 选择平台HarmonyOS PC / 2in1最低窗口 720 × 520 vp应用名称芯稿应用标识com.von.markdeck文稿模型本地.md文件 相对资源目录页面比例16:9网络能力不要求账号不做云转换、云同步或在线 AI编辑内核ArkUI 桌面工作区解析链路Marked 18.0.9 lexer ArkTS Parser Adapter导出链路Deck AST → Slide Layout Model → OOXML → 标准.pptx预览与导出ArkUI 预览和 OOXML Renderer 共享同一布局模型它不是完整的 IDE也不是只负责 Markdown 阅读的文本编辑器。一个工作区里同时放下幻灯片大纲、Markdown 编辑器、实时预览和按需展开的检查器。宽窗保持多栏窄窗可在编辑与预览之间切换不退回手机式底部导航。左侧管理页面中间编辑 Markdown右侧同步显示当前幻灯片。导出使用品牌红色主操作其他工具面保持低干扰。3. 安装与权限目标设备为 HarmonyOS PC / 2in1。平板只作为应用声明的兼容设备类型不以手机端交互为目标。应用通过系统文件选择器打开 Markdown、保存文稿和导出 PPTX不申请广泛存储权限。拖入或粘贴图片时使用前台ohos.permission.READ_PASTEBOARD读取剪贴板。选择文稿目录后ohos.permission.FILE_ACCESS_PERSIST用于持续访问该文稿及其相对资源。Markdown 解析、图片处理和 PPTX 生成全部在本机完成。正式签名、真实 HarmonyOS PC / 2in1、WPS GUI 精确往返和 Microsoft PowerPoint 往返仍属于发布验收门禁。本文按当前 1.0.0 构建说明功能不把未完成的人工兼容性验证写成已通过。4. 基本使用路径4.1 新建与保存按CtrlN新建文稿或按CtrlO打开已有.md文件。在中间编辑器写内容未首次保存时恢复副本位于应用私有目录。按CtrlS保存。首次保存和另存为均使用系统文件选择器。正常保存后清理对应恢复副本发现外部修改时不静默覆盖原文件。4.2 用分页符组织演示文件开头可写一组 front matter它之后的单独一行---才表示新建一页。上一页内容到下一个分页符结束。--- title: 我的第一次分享 author: Lin theme: studio footer: 2026 / Internal pageNumbers: true --- # 想法应该直接成为演示 用 Markdown 写作用幻灯片表达。 --- # 第二页 - 先写内容 - 实时预览 - 导出可编辑 PPTXfront matter 支持标题、作者、主题、强调色、页脚、页码和 16:9 页面比例。主题可填studio、stage或code。4.3 浏览页面与调整顺序左侧大纲显示每页缩略图和页面标题可键盘选择、添加页面、切换当前页并拖动重排。中间编辑器和右侧预览跟随当前页更新。内容溢出不会静默裁掉。预览、缩略图与导出台账会显示对应页警告导出前可返回 Markdown 原文修改。4.4 调整主题与布局打开检查器可统一修改标题、作者、主题、强调色、页脚和页码也可覆盖当前页布局。检查器编辑的是 front matter 和当前页指令仍通过同一个 Markdown 缓冲区和撤销栈生效。不写指令时由芯稿自动选择版式。在目标页标题前加入 HTML 注释可显式指定页面布局!-- markdeck: layouttwo-column -- # 双栏页面 ## 左栏 左侧内容。 ## 右栏 右侧内容。可选布局包括auto、title、title-body、title-list和two-column。布局指令只作用于当前页。5. 功能怎么用编辑与富文本支持 H1-H3、段落、粗体、斜体、删除线和行内代码。支持安全外部链接导出时保留显示文本和超链接关系。支持最多三级有序/无序混合列表和任务列表。编辑器提供查找、撤销和重做常用操作可在命令栏或快捷键执行。引用、代码与表格引用块支持行内富文本和来源署名导出后正文与装饰形状仍为独立对象。围栏代码保留语言标记、换行、缩进和受控语法着色不把代码页面转成图片。GFM 表格导出为原生 DrawingML 表格表头、对齐和单元格富文本可继续编辑。const title 离线 可编辑; if (title.length 0) { console.info(title); }代码保留语言标记、换行与缩进。导出后页面仍是文本对象不依赖预览截图。本地图片支持文稿目录内的 PNG 和 JPEG。图片按相对路径解析并导出为独立 picture shape 和媒体关系。alt写入非可视属性caption 保持为独立文本框。默认contain在路径后添加#cover可让图片覆盖区域。推荐保持文稿与同名资源目录在一起产品分享.md 产品分享.assets/ architecture.png demo.jpgMarkdown 中这样引用拖入或粘贴图片时芯稿会复制到同名.assets目录并插入相对路径。为保持离线与可移植性远程图片、绝对路径和文稿目录外的资源不会加载。演讲者备注在页面内使用:::notes容器编写只给演讲者看的内容:::notes 先介绍背景这一页停留 60 秒。 :::备注导出到原生 PPTX notes page不显示在幻灯片画布上。每页备注块需要正确闭合。导出前检查点击“导出 PPTX”或按CtrlShiftE芯稿会先检查本地图片是否存在相对路径是否有效页面尺寸、必要部件和内部关系是否完整内容是否超出幻灯片安全区域导出目标是否能够安全写入。缺失资源或损坏包等阻断错误必须在落盘前处理溢出警告需要确认后才能继续。取消或失败的导出不会保留损坏目标文件和临时文件。导出完成后文本、列表、表格、图片、代码和形状仍是独立对象可在 WPS Office 或 Microsoft PowerPoint 中继续修改。最终分享前仍应检查字体替换、链接、备注和页面边界。表格在办公软件中仍可逐格选中和修改。此截图用于说明对象类型不替代最终发布前的人工往返验收。6. 快捷键命令默认快捷键新建文稿CtrlN打开 MarkdownCtrlO保存CtrlS另存为CtrlShiftS撤销 / 重做CtrlZ/CtrlShiftZ查找CtrlF导出 PPTXCtrlShiftE开始放映F5打开帮助F1上一页 / 下一页←/→演示和关闭未保存文稿也支持键盘操作弹窗中的主要按钮可聚焦并按回车执行。7. 已知边界1.0 只验证 HarmonyOS PC / 2in1 桌面工作流不维护手机端体验。页面比例固定为 16:94:3 属于后续扩展。不支持 Markdown 中的脚本、任意 HTML 或远程资源不执行不可信内容。不支持从已有 PPTX 反向导入编辑。不提供云同步、在线 AI、账号体系和网络备份。正式签名、真实 HarmonyOS PC / 2in1、WPS GUI 精确往返与 PowerPoint 往返仍需发布前人工验收。当前包验证覆盖必要 OOXML 结构、关系与原生对象不声称替代完整 ECMA-376 schema 校验。8. 结语芯稿的 1.0 目标很明确在鸿蒙电脑上把已经用 Markdown 写清楚的内容变成一份能实时预览、离线导出、进入办公软件后还能继续编辑的演示文稿。应用名称芯稿。应用标识com.von.markdeck。
