芯稿 MarkDeck：在 HarmonyOS PC 上用 Markdown 生成可编辑 PPT

芯稿 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 不要求登录，不提供云同步和在线 AI；Markdown 解析、图片处理、预览与 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 新建与保存

• 按 Ctrl+N 新建文稿，或按 Ctrl+O 打开已有 .md 文件。
• 在中间编辑器写内容；未首次保存时，恢复副本位于应用私有目录。
• 按 Ctrl+S 保存。首次保存和另存为均使用系统文件选择器。
• 正常保存后清理对应恢复副本；发现外部修改时，不静默覆盖原文件。

4.2 用分页符组织演示

文件开头可写一组 front matter；它之后的单独一行 --- 才表示新建一页。上一页内容到下一个分页符结束。

---
title: 我的第一次分享
author: Lin
theme: studio
footer: 2026 / Internal
pageNumbers: true
---

# 想法，应该直接成为演示

用 Markdown 写作，用幻灯片表达。

---

# 第二页

- 先写内容
- 实时预览
- 导出可编辑 PPTX

front matter 支持标题、作者、主题、强调色、页脚、页码和 16:9 页面比例。主题可填 studio、stage 或 code。

4.3 浏览页面与调整顺序

左侧大纲显示每页缩略图和页面标题，可键盘选择、添加页面、切换当前页并拖动重排。中间编辑器和右侧预览跟随当前页更新。

内容溢出不会静默裁掉。预览、缩略图与导出台账会显示对应页警告；导出前可返回 Markdown 原文修改。

4.4 调整主题与布局

打开检查器，可统一修改标题、作者、主题、强调色、页脚和页码，也可覆盖当前页布局。

检查器编辑的是 front matter 和当前页指令，仍通过同一个 Markdown 缓冲区和撤销栈生效。

不写指令时由芯稿自动选择版式。在目标页标题前加入 HTML 注释，可显式指定页面布局：

<!-- markdeck: layout=two-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.jpg

Markdown 中这样引用：

![系统架构](产品分享.assets/architecture.png "架构说明")

拖入或粘贴图片时，芯稿会复制到同名 .assets 目录并插入相对路径。为保持离线与可移植性，远程图片、绝对路径和文稿目录外的资源不会加载。

演讲者备注

在页面内使用 :::notes 容器编写只给演讲者看的内容：

:::notes
先介绍背景，这一页停留 60 秒。
:::

备注导出到原生 PPTX notes page，不显示在幻灯片画布上。每页备注块需要正确闭合。

导出前检查

点击"导出 PPTX"或按 Ctrl+Shift+E，芯稿会先检查：

• 本地图片是否存在，相对路径是否有效；
• 页面尺寸、必要部件和内部关系是否完整；
• 内容是否超出幻灯片安全区域；
• 导出目标是否能够安全写入。

缺失资源或损坏包等阻断错误必须在落盘前处理；溢出警告需要确认后才能继续。取消或失败的导出不会保留损坏目标文件和临时文件。

导出完成后，文本、列表、表格、图片、代码和形状仍是独立对象，可在 WPS Office 或 Microsoft PowerPoint 中继续修改。最终分享前仍应检查字体替换、链接、备注和页面边界。

表格在办公软件中仍可逐格选中和修改。此截图用于说明对象类型，不替代最终发布前的人工往返验收。

6. 快捷键

命令	默认快捷键
新建文稿	Ctrl+N
打开 Markdown	Ctrl+O
保存	Ctrl+S
另存为	Ctrl+Shift+S
撤销 / 重做	Ctrl+Z / Ctrl+Shift+Z
查找	Ctrl+F
导出 PPTX	Ctrl+Shift+E
开始放映	F5
打开帮助	F1
上一页 / 下一页	← / →

演示和关闭未保存文稿也支持键盘操作；弹窗中的主要按钮可聚焦并按回车执行。

7. 已知边界

• 1.0 只验证 HarmonyOS PC / 2in1 桌面工作流，不维护手机端体验。
• 页面比例固定为 16:9，4:3 属于后续扩展。
• 不支持 Markdown 中的脚本、任意 HTML 或远程资源，不执行不可信内容。
• 不支持从已有 PPTX 反向导入编辑。
• 不提供云同步、在线 AI、账号体系和网络备份。
• 正式签名、真实 HarmonyOS PC / 2in1、WPS GUI 精确往返与 PowerPoint 往返仍需发布前人工验收。
• 当前包验证覆盖必要 OOXML 结构、关系与原生对象，不声称替代完整 ECMA-376 schema 校验。

8. 结语

芯稿的 1.0 目标很明确：在鸿蒙电脑上，把已经用 Markdown 写清楚的内容变成一份能实时预览、离线导出、进入办公软件后还能继续编辑的演示文稿。

应用名称：芯稿。应用标识：com.von.markdeck。