有没有人觉得 markdown 并不适合拿来写文档？

11 天前
 wonderqs

如题，markdown 这种东西有很多问题，例如依赖的媒体资源（例如图片）只能作为零散的文件存在，不能像 word 一样打包到一起，这样在把文件发送给别人的时候很不方便。另外 markdown 文件一旦拷贝或移动过，那么依赖的媒体资源的路径就会破坏。

除了这些之外还有很多问题，例如无法插入音视频资源，无法构造复杂图表，对于数学公式的支持也是缺失的。

按我的理解 markdown 本身就只是在很朴素的纯文本基础上做了一些增强，它的目标场景也是取代一些原本使用纯文本的地方（例如代码的 readme 文件、部分 web 场景下的文本编辑功能等）。既然如此不适合，那么为什么还是有那么多人喜欢用 markdown 来写文档呢（包括写笔记）？

16309 次点击
所在节点    Markdown
167 条回复
hwdq0012
11 天前
@BenHunDun #35 md 编辑器有复制为 html 或 富文本的功能
hwdq0012
11 天前
@wonderqs #30 又能怎么样呢：可以用代码版本控制的方式管理起来
v3ct0r
11 天前
表：“markdown 不适合写文档”

里：“markdown 普及率不及 word”

提到的团队协作的问题，如果我没装 word 或不会用 word 又改如何呢
cnuser002
11 天前
markdown 顺应的是 web 时代一行行写东西的这种感觉，重内容，轻格式。
DOLLOR
11 天前
markdown 支持基本的排版格式（标题、链接、分割线），跟代码混排方便，能集成在网页里，能被 git 跟踪。
tairan2006
11 天前
md 可以写文档，但是输出给别人看，最好转成 pdf

另外，图片和流媒体，一般使用图床（如阿里云 oss ）存放

md 适合被 git 做版本管理，因为可以 diff
xubeiyou
11 天前
还挺好的 至于你说的图片等外部资源问题 这个没办法 不能既要又要的- -
v3ct0r
11 天前
换句话说
docx 格式是 xml 加上相关资源的打包。
那我也将 markdown 和相关资源一起打包，并取名为 mdx 格式，要用专业软件才能打开，那还有上述问题吗？
agentkw9
11 天前
我们内部文档用飞书维护，代码仓库里的说明使用 md ，和代码一起用 git 维护
DOLLOR
11 天前
@wonderqs

你用 word 了，还怎么 pull merge diff ？
“大家一起写”这个需求，反而更应该用 markdown 。
wonderqs
11 天前
@hwdq0012 哦，那我明白了，如果完全使用 git 这种工具去管理 markdown 就是一个还不错的方式了
wonderqs
11 天前
@DOLLOR 有道理
huangmingyou
11 天前
@lnbiuc tex
Greendays
11 天前
但是 Markdown 可以用 Git 来管理版本，这点比 Word 之类的强。Markdown 也方便在浏览器里显示。

功能确实还是 Word 更多的，有些文档就是得有截图，有视频，有附件，这个时候 MD 就不太方便了。
fano
11 天前
word 协同编辑会有合并冲突的问题。markdown 是纯文本，可以用 git 、outline 进行协同。
Sfilata
11 天前
我就很抵制 word ，能不用的时候就不用。至于你说图片等外部资源这样就可以了，然后一起打个包。我没觉得有啥麻烦的。

```markdown
# Test for the image

![image info](./WechatIMG16990.jpg)
```
wudaye
11 天前
其实看上面很多人的回答就知道，很多人尤其是程序员是很魔怔的，我是觉得 notion 或者飞书的智能文档是最好用的，只是没有像 markdown 一样开源格式出来，毕竟这些公司都是要赚钱的
SGL
11 天前
没有轻便简单的基于代码管理格式的替代。Latex 最近看到有 Typst 在替代。Markdown 则没有更好的替代。其实个人觉得 markdown 在表格形式上比较薄弱以外，图片等资源专门放到一个文件夹里面到也没有什么问题，反而比较直观。
Sfilata
11 天前
@Sfilata 而且像你说的图表啊，音视频啊这种需求都有 mermaid 类似的解决方案。如果要共享的话找个可以在线解析的平台就可以，比如 github 或者别的什么。
rossroma
11 天前
你的题目和你的补充本质上是两个问题。团队协作的问题不在 markdown 上面，它本身只代表一种语法，问题是在离线。你哪怕用离线的 word 、PDF ，我觉得都是不妥的。既然是团队协作，那优先肯定是在线协作文档，开源和收费的工具都很多。而这些在线文档工具，绝大多数也是 markdown 语法或者在 markdown 基础上进行扩充。所以我的结论是 markdown 适合写文档，而任何离线文档都不适合团队协作。

这是一个专为移动设备优化的页面（即为了让你能够在 Google 搜索结果里秒开这个页面），如果你希望参与 V2EX 社区的讨论，你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://ex.noerr.eu.org/t/1140628

V2EX 是创意工作者们的社区，是一个分享自己正在做的有趣事物、交流想法，可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX