这是一个创建于 1407 天前的主题，其中的信息可能已经有所发展或是发生改变。
项目开发完了，免不了要写文档，例如开发文档，或者软件使用说明书。常用的基本都是 word 文档，但是如果要展示复杂的效果。
例如与图相关效果展示，如点击文档中的一个图片，进行缩放，播放文档中的一个 gif 。如果文档内容展示模型图，比如流程图，思维导图，用例图，还能折叠展开。word 文档怎么做到这一点？能做到么？
如果要实现如上复杂效果展示的话，有哪些软件能做到？当然 word 文档，可以超链接，但是客户端没有那些模型图软件怎么办？
或者考虑用 html 来写文档？可 html 手写有点麻烦，如果要展示比较复杂的效果，只能考虑 js 插件。这个有比较好的 html 文档编写软件么，能像 markdown 一样编写 html，又能插入特效 html，js 代码？
第 1 条附言 · 2020-06-16 13:30:44 +08:00
支持 html，pdf 导出
第 2 条附言 · 2020-06-17 08:37:47 +08:00
有人说过 ppt，ppt 可以的确可以，但是 ppt 有个问题，就是它的目录分类不如 word，也就是所谓的左侧菜单栏，ppt 的目录分类的左侧菜单只有 1 一级，没有两级，而且目录项似乎只能是图片
 |
1
tlxxzj 2020-06-16 11:47:31 +08:00
confluence 了解一下
|
 |
2
anofac 2020-06-16 11:51:18 +08:00  3
语雀
|
 |
5
raaaaaar 2020-06-16 13:44:28 +08:00 via Android
为什么不用 markdown
|
 |
6
tctc4869 OP @raaaaaar 如果要展示 gif 动态图片，静态图片缩放，还有模型图，例如用例图，思维导图，流程图，以及展开折叠功能，这个有哪个 markdown 能做到么。
最后还得导出 html，或者 pdf，因为有些文档可能要给上级或用户看。上级或用户不一定会装这些软件 |
 |
7
afirefish 2020-06-16 13:51:21 +08:00
showdoc
|
 |
8
raysmond 2020-06-16 13:55:03 +08:00
markdown 里也能写 html
|
 |
9
cmdOptionKana 2020-06-16 13:55:47 +08:00 1
我觉得你把两种文档混合在一起了，所以觉得很难实现。
1. 介绍概念，了解大致框架、流程，简单介绍主要特点文档 2. 包含全部细节的详细文档 这两种分开做，思路就清晰很多。 |
 |
10
yuchenyang1994 2020-06-16 14:35:59 +08:00
latex ？
|
 |
11
AreYou0k 2020-06-16 14:38:00 +08:00
PPT
|
 |
12
annielong 2020-06-16 15:00:55 +08:00
ppt，epub，要么就手写 html 放网上，直接打开看，
|
|
13
raaaaaar 2020-06-16 15:46:52 +08:00 via Android
接口文档还要画思维导图什么的，应该分开吧，后者更像设计文档啊
|
|
14
tctc4869 OP @annielong 手写 html 太慢了，有便捷的方法么？如果要说是 markdown，写完导出 html，那有绘图有功能的 markdown 软件么？绘制流程图，思维导图的。
|
|
15
tctc4869 OP |
 |
16
momocraft 2020-06-16 16:54:58 +08:00
用 gatsby （有 mdx，足够可定制）之类东西，当 demo site 做
pdf 只放静态内容，加个网站链接 |
 |
17
PbCopy111 2020-06-16 16:59:36 +08:00
这个东西。。。ppt 就解决了吧。。如果不成，就 keynote 。。。
|
 |
18
sardine 2020-06-16 17:24:39 +08:00
ppt
|
 |
19
jaggerjiang 2020-06-16 18:50:02 +08:00
你这个情况 ppt 肯定最适合
|
|
20
tctc4869 OP @AreYou0k
@PbCopy111 @sardine @jaggerjiang ppt 有个问题，就是他的目录分类不如 word，很多现在很多网站 api 使用说明也没，都直接使用侧边栏菜单，有些还带展开折叠分类的 |
 |
21
EEEcho 2020-06-16 21:15:55 +08:00
|
 |
22
clf 2020-06-16 21:21:21 +08:00
一般情况下，软件项目文档就两种，一种是技术类文档，一种是操作说明。
技术类文档不需要花里胡哨的，图文足够了，markdown 最好。 而操作说明，图文结合+视频演示也就足够了。通过这两个都弄不懂怎么操作的软件，说明软件交互设计很垃圾，用户体验极差，无法低学习成本上手。 |
 |
23
jim1002 2020-06-16 23:21:43 +08:00
notion ？
|
 |
25
freezhan 2020-06-17 00:10:54 +08:00
notion + 1 虽然我试用了下放弃了，但是感觉很符合你的需求
|
 |
27
lululau 2020-06-17 07:35:31 +08:00 via iPhone
markdown 本身就是 HTML 的超集
|
|
28
tctc4869 OP mermeit 是什么？
|
 |
29
yoonper 2020-06-17 08:30:09 +08:00 via Android
|
 |
30
BingZ 2020-06-17 08:59:52 +08:00
同意 9 楼的，你把两种不同需求混一起了。
你需要一份 PTT，仅做演示和宣讲。而产品文档就应该是静态的，不要花里胡哨，向字典看齐，事无巨细，方便查找。 |
|
31
tctc4869 OP @BingZ 你也和 9 楼一样先入为主了。开头我就写了，“例如开发文档，或者软件使用说明书”，这句话已经表达了，我已经分清楚要写多个文档了。
ppt 的主要用途是用去讲台上讲解的，写产品操作说明书，word 比 ppt 更合适，ppt 没有 word 那样详细的目录菜单分类功能，也就是左侧菜单，ppt 的左侧菜单只有 1 级，而且还全是图片，没有文字，哪像菜鸟教程，一些 api 网页使用说明演示，都会提供带有分类分组的左侧菜单，用 ppt，我还不如直接用 word+超链接都比 ppt 好。 |
 |
32
JerryCha 2020-06-17 11:33:01 +08:00
flash
|
|
33
BingZ 2020-06-17 11:51:09 +08:00
@tctc4869 好吧，从你的描述看，很多人都被引导到 PTT 去了，你不觉得自己的文字表述有些模糊么？
另外，你所指出的“不支持”的功能，仔细看看都是些“可实时互动”的动态效果。 回到常规意义的文档本身来说，为什么需要那么多的互动？这些互动能被打印到纸上么？能转成 pdf ？在静态展示为主的传统文档里，平铺展开就足够了，快速跳转交给目录和索引去完成。动画展示的内容一律通过截图来说明。除了动画和声音外，文字和图片已经足够表达了。不需要额外软体和设备的支持。 当然，“文档”可以包括视频资料和多媒体的互动资料。要实现这些，建议采用 html 或者 markdown 来完成。但这样的展示需要特定的软体支持，使用者才能看到效果，这是有成本的。可能做成网站形式，对用户来说使用负担最小，也较易被接受。markdown 还是太不成熟了。 |
 |
34
boyuanhao 2020-06-17 14:29:35 +08:00
目前在用语雀
|
 |
35
hyperbin 2020-06-17 15:20:07 +08:00 via Android
图文排版是天坑，找不到现成的千万别自己开发
|
 |
36
Elissa 2020-06-17 17:19:07 +08:00 via Android
媒体（图片，动图，各种各样的图）和文字分开编写，最后一起放在 markdown 里，随便导出
|
 |
37
shuangya 2020-06-17 17:42:56 +08:00
你要的东西太多了，现阶段，完全满足的是手写 HTML，或者 PPT 。
但你又嫌麻烦了，想了一下只有语雀满足。 语雀可以导出 PDF，不能导出 HTML 。 另外语雀的在线管理和演示功能其实都还不错，所以一般情况下也不太用得上导出。 |
 |
38
myCupOfTea 2020-06-17 18:20:49 +08:00 via Android
markdown 就行了，至于流程图啥的，vscode 的 markdown preview 插件支持这些，写完了也可以导出成图片，pdf 或者 html
|
 |
39
xingyuc 2020-06-17 18:23:24 +08:00
你要的不就是 gitlab gitbook 这类文档工具吗
|
|
40
myCupOfTea 2020-06-17 18:57:28 +08:00
|
Select Language