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

[wonderqs]

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

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

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

我本意不是想在这里讨论 markdown 的优劣势，因为这些东西本质上没有什么争议。我讲的这种问题是限定在“使用离线的 markdown 来写工作文档，并且使用这种方式进行团队协作”这件事情上。因为我有遇到不少人在实际工作中这么干，我是觉得这样做是不妥的，markdown 可能自己使用很习惯，很棒，但是当你把 markdown 文件用在团队协作中就是有问题的，但是我不明白为什么会这么做。

[damichifan]

习惯吧，自己用的方便，用这个的应该 大多程序员，总会涉及程序内容的

[kokerkov]

本来就是纯文本的时候用。其实也并不便利。readme 还是 txt 最多。毕竟默认什么平台都能显示。

[sayhe110]

简单轻便？例如 ### 设置标题，加粗等等，资源的话感觉上传到服务器上就不会有这个问题。
对于我的话，markdown 更轻便和样式更加丰富，可以添加 css 等等，如果代码块的话更加美观

[seven777]

只适合自己用,或者发布式分享.不适合传统的文件共享式交流.

所以我全面拥抱 WPS , 其 智能文档,真的很方便.
(可以发布,可以分享,可以共享,可以带图片导出,可以多端使用......)

[liuhuansir]

md 排版简单，或者说是简陋够用，再就是它是文本文件，支持版本比对

[Dillan]

写 MarkDown 的时候可以完全不用鼠标，而且利用开源库能直接将 Markdown 转换成网页方便浏览，适合团队文档协作

[seven777]

WPS 的智能文档,缺少导入 markdown 文件.缺少导出为 markdown 文件.

[lnbiuc]

那用啥，有更好的替代品吗，不要 word

[hnbcinfo]

markdown 我都是自己用，管理自己的文档，都在本地。需要分享的时候我都转 pdf 发给别人。

[hafuhafu]

对我来说笔记能区分文本样式以及显示图片就够了，我用 Markdown 记笔记的原因也是我本来就只需要这些。
你的需求本来就不适合 Markdown 来做。

[EastLord]

我感觉适合做 开发文档
https://www.writethedocs.org/guide/docs-as-code/

[cvooc]

markdown 做源码, 完了发布其他插件或者博客生成的结果, 便于统一管理主题样式

[superrichman]

你没有被 word 的标题排版和数字编号折磨过吗？

[lujiaxing]

@superrichman 没有 WORD 的排版跟编号没那么复杂. 而且还能自定义样式. 挺好的.

[wonderqs]

@superrichman 说实话，没有，我觉得 word 比 markdown 好用，所见即所得

[wu00]

很适合，很干净，图尽量用 mermaid 、graph 去画
发布分享可以用在线文档/生成 pdf

[HojiOShi]

写作和排版是两种不同的需求，我不喜欢将这两种需求强行结合在一起。

[wonderqs]

@sayhe110

[shijingshijing]

发布的时候直接打印成 pdf 不就图片和文字在一起了么？

[wonderqs]

@sayhe110 上传服务器这个操作就不是一个轻便的事情

[johnsmith2077]

转 pdf 很方便的，一个 vscode 插件就行

[lnbiuc]

@wonderqs #15 markdown 也可以所见即所得啊

[capric]

@seven777 google doc 可以导入导出 markdown

[wonderqs]

关于导出 pdf 这个事情，我觉得很多时候文档分享不是简单的一个人写，一群人读，而是大家一起写，一起读。你给人家 pdf 就不是一个合适的方式

[lujiaxing]

Markdown 就是自行车, 用来写一些轻量化的文档其实蛮合适的. 比如功能说明, 开发文档之类的. 但是拿来写一些很复杂的东西就不合适了. 比如带表格的内容 (我知道可以), 图文混合内容, 带公式的内容之类的.

Word 就是汽车, 操作有一定难度, 但是不算难. 而且适用范围很广. 排版也很方便. 很适合写一些排版很复杂的文档.

你上下班骑自行车行.
你过年回老家, 也骑自行车么?

[BenHunDun]

自身的体验是, 大部分情况下, markdown 的基本能够覆盖需求.
而且因为是纯文本文件, 在没有任何软件的情况下都能够使用 (但会丧失其一定的可读性)

然后提到的多媒体部分其实很多像 Obsidian , vscode 也都在支持.

[scarlex]

纯笔记的话很适合，毕竟都是自己看的

[Asasahi]

其他 excel 更方便（

[realJamespond]

markdown 是文本，可以直接用 notepad 打开，github 上能打开，obsidian 能打开是通用的格式，word 不是文本要用 word 或 wps 才能打开 make sense ？

[wonderqs]

@realJamespond 这的确是个优点，但是上面说的缺点们和这个优点没有关系呀，就算能用 notepad 打开，又能怎样呢？

[mascteen]

@lnbiuc org-mode

[wonderqs]

还有一个在团队写作中使用 markdown 很糟糕的体验：当别人管你要一个文档，你给人家一个导出的 pdf 的时候是容易让对方不舒服的，因为这样做本质上就是不给人家评论和编辑的权力

[fivemoons]

用支持 markdown 的 web 版软件能解决媒体资源路径问题，有些额外开发了支持复杂图表的功能

[hhharuka]

大部分人 word 排版都不会
字体不统一 段落不会设置 。。。

简单的文档 markdown 优势太明显
复杂排版下 word 肯定是最佳选择

[BenHunDun]

还有一个在团队写作中使用 markdown 很糟糕的体验：当别人管你要一个文档，你给人家一个导出的 pdf 的时候是容易让对方不舒服的，因为这样做本质上就是不给人家评论和编辑的权力

- 感觉针对这个是团队要统一工具吧. 还有感觉很大一部分是 markdown 不够满足你对文档的需求.
- 自身还有一部分就是 git 对文本支持, 可以通过 git 去追踪自己的修改.

[tf2]

看到标题：“觉得 markdown 并不适合拿来写文档” —— 我也觉得，打开正文看看

看到正文：“不能像 word 一样打包到一起” —— 这还不如 md 呢。。

[momo1pm]

@wonderqs 如果你们内部文档编写像论文一样严谨，word 很合适，不然，txt 都够用了，更别说 md 了，另外，自建服务如果不买授权，用 md 最方便

[Zien]

在「简洁通用」和「方便易用」上此消彼长，于是用户不停地尝试新编辑器和插件，最终陷入死循环，依然乐此不疲，因为无可替代。

[zhuangzhuang1988]

就是很少人用 reStructuredText

[hwdq0012]

一篇文章一个文件夹，里面放 md 和图片，我的博客是这样的， 本地写好 md 直接 post 到博客上，也可以整个目录发给别人，如果要分享的话

word 里放 video 本来也让人觉得很 zz 吧， 文档里面放个视频，那文档也不用写了

[hwdq0012]

@BenHunDun #35 md 编辑器有复制为 html 或 富文本的功能

[hwdq0012]

@wonderqs #30 又能怎么样呢：可以用代码版本控制的方式管理起来

[v3ct0r]

表：“markdown 不适合写文档”

里：“markdown 普及率不及 word”

提到的团队协作的问题，如果我没装 word 或不会用 word 又改如何呢

[cnuser002]

markdown 顺应的是 web 时代一行行写东西的这种感觉，重内容，轻格式。

[AV1]

markdown 支持基本的排版格式（标题、链接、分割线），跟代码混排方便，能集成在网页里，能被 git 跟踪。

[tairan2006]

md 可以写文档，但是输出给别人看，最好转成 pdf

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

md 适合被 git 做版本管理，因为可以 diff

[xubeiyou]

还挺好的 至于你说的图片等外部资源问题 这个没办法 不能既要又要的- -

[v3ct0r]

换句话说
docx 格式是 xml 加上相关资源的打包。
那我也将 markdown 和相关资源一起打包，并取名为 mdx 格式，要用专业软件才能打开，那还有上述问题吗？

[agentkw9]

我们内部文档用飞书维护，代码仓库里的说明使用 md ，和代码一起用 git 维护

[AV1]

@wonderqs

你用 word 了，还怎么 pull merge diff ？
“大家一起写”这个需求，反而更应该用 markdown 。

[wonderqs]

@hwdq0012 哦，那我明白了，如果完全使用 git 这种工具去管理 markdown 就是一个还不错的方式了

[wonderqs]

@DOLLOR 有道理

[huangmingyou]

@lnbiuc tex

[Greendays]

但是 Markdown 可以用 Git 来管理版本，这点比 Word 之类的强。Markdown 也方便在浏览器里显示。

功能确实还是 Word 更多的，有些文档就是得有截图，有视频，有附件，这个时候 MD 就不太方便了。

[fano]

word 协同编辑会有合并冲突的问题。markdown 是纯文本，可以用 git 、outline 进行协同。

[Sfilata]

我就很抵制 word ，能不用的时候就不用。至于你说图片等外部资源这样就可以了，然后一起打个包。我没觉得有啥麻烦的。

```markdown
# Test for the image

```

[wudaye]

其实看上面很多人的回答就知道，很多人尤其是程序员是很魔怔的，我是觉得 notion 或者飞书的智能文档是最好用的，只是没有像 markdown 一样开源格式出来，毕竟这些公司都是要赚钱的

[YanSeven]

没有轻便简单的基于代码管理格式的替代。Latex 最近看到有 Typst 在替代。Markdown 则没有更好的替代。其实个人觉得 markdown 在表格形式上比较薄弱以外，图片等资源专门放到一个文件夹里面到也没有什么问题，反而比较直观。

[Sfilata]

@Sfilata 而且像你说的图表啊，音视频啊这种需求都有 mermaid 类似的解决方案。如果要共享的话找个可以在线解析的平台就可以，比如 github 或者别的什么。

[rossroma]

你的题目和你的补充本质上是两个问题。团队协作的问题不在 markdown 上面，它本身只代表一种语法，问题是在离线。你哪怕用离线的 word 、PDF ，我觉得都是不妥的。既然是团队协作，那优先肯定是在线协作文档，开源和收费的工具都很多。而这些在线文档工具，绝大多数也是 markdown 语法或者在 markdown 基础上进行扩充。所以我的结论是 markdown 适合写文档，而任何离线文档都不适合团队协作。

[totoro625]

因为你没见过 word 里面一团乱麻的格式，真的想把制作文档的人脑袋敲开看看是什么浆糊
会一点字体、段落、行高、分页就算是前 10%的优秀工具人了

[Sfilata]

而且恰恰因为要协作，所以才应该越简洁越好。你如果一直用 word 的话，你让用 mac 的人怎么办，用 linux 的人怎么办。不说要忍受 word 的卡顿或者 wps 的广告，这几个平台能不能打开，打开后一不一样都不能保证。这协作起来哪里有优势？

[Codingxiaoshi]

可扩展性强, 就是门槛够低, 上限够高

[YanSeven]

@wudaye 这些只能文档基本上都是丰富 markdown 的语法和能力，正如你所说，他们都不是开源的格式，并且都是在线的。所以，对于程序员个体来说，兼容性以及数据安全性角度上，markdown 就是最便捷，合适的一种数据组织格式。并且公司内部协作，尤其是计算机相关的，我想基本上都是类似飞书语雀这类的云文档，或者类似 wps 这种云文档吧。

[GeruzoniAnsasu]

太奇怪了，markdown 难道不只是一种标记方式？

真正讨论「写文档」的时候，相互对标的难道不应该是 word 、语雀、飞书、Notion 、Obsidian 、Confluence 吗



难道 OP 想讨论的是某个 markdwon 纯文本到处发这种……文档……呃……产品？

[Azone]

不适合拿来写文档？那什么适合呢？一大堆工具可以将 markdown 转换成静态网站/网页（大部分），一大堆工具可以将其转成 PDF 。想插入音频、视频、数学公式，你可以使用一些提供支持的软件，也多的要命。markdown 这么的简单易用，一切非要用 Word 写才算合适吗？

[Cruzz]

我写 markdown 单纯的因为没有审美，word 字体样式，让我添加个表格直接麻爪，markdown 就很棒，你只管写，不需要管格式。

[adoal]

Word 有 Word 的协作方式，MD 有 MD 的协作方式，取决于文员和程序员谁的话语权更大。

[v2er4241]

基于你的需求，你用飞书就行了，word 和 md 都不适合。

[JingXiao]

全都要不就行了，一般单位协同办公基本就用钉钉或者飞书的云文档，支持传统文档编辑也兼容 md 语法，有啥好纠结的。

[sky3hao9]

目前最好用的是就是这个了, txt 不能编排, 不能插图片
mac 平台下带了很多编辑工具, 有的还支持画图, 但是我用的很少. 习惯了 vscode + md

[815979670]

我一直觉得 markdown 可以增加一个 mdp 格式(规范)，既 markdown + package ，主文档内容可以通过 markdown 语法完成，附件可以通过相对路径引入，然后 md 文件和 附件通过 zip 等压缩格式打一个包，扩展名就叫 .mdp （其实想法和 word 一样 只不过 文档内容通过 markdown 排版 ）

[ExplodingDragon]

没什么讨论的 , markdown 语法简单，扩展方便 ，非二进制存储，有成熟的 lint 和转各种格式的工具，方便被 git 管理， 其他的基本上没法比，都有各种各样的问题

[gongxuanzhang]

我看到 word 真的恶心想吐

[lynan]

markdown 语法还是挺方便的，比如在 IM 里面发代码块之类的直接打就行（当然了在工具栏上点点点也可以，麻烦一点）

[iv2ex]

在多媒体资料少的情况，我觉得 md 更适合写文档，因为 md 相比其他文件更容易被 AI 工具支持。（我用 windsurf 写文档）

[nirvam]

插入图片可以考虑使用 inline data uri ，图片转 base64 之后贴在文档末尾，格式形如：

`[some_alias]: data:image/png;base64,iVBORw0KG...`

文档中间要插入图片的地方使用 `![alias]` 引用即可。

坏处是替换的时候稍微有点麻烦，文件体积比较大，对 git 不太友好。另外不同的 Markdown 渲染器对指定宽度的语法和效果并不统一。

[Martinez]

txt 和 latex 挺好的

[nirvam]

@nirvam #77

*使用 `![some_alias]` 引用

[dcdlove]

这个想法好，AI 完善了下

[dcdlove]

@dcdlove @@815979670 快推广出来

[aowugong]

md 就是一个文本，用啥都能打开，足够自由而且永恒存在，安全感满满
团队协作中不用 md ，使用其它，那它迁移成本就很高很麻烦

[pkoukk]

文档分写给谁看

[hallDrawnel]

要团队协作那就还得是在线的编辑器，confluence 就做得很牛逼，用起来相当思丝滑。MD 还是只适合以 codebase 管理方式低频率更新的东西。

[javak]

现在的小朋友啊， 既不了互联网的发展，也不愿意去了解，或者都不知道怎么去了解。 优劣也好，适不适合也好， 简单了解下 markdown 是怎么出现的，啥都知道了。
或者 OP 就是揣着明白装糊涂， 那么你就应该扔个暴论：「我觉得 markdown 是个垃圾，为啥怎么多人喜欢」。 可能回帖的会更多。

[PanuiQ]

离线协作那 word 更是个灾难，建立好的模板都没用，每个人提交上来的都会多出很多格式。刷 6000 页 word 的格式那确实爽

[Narcissu5]

《黑客与画家》里面专门有一章讲为什么要用纯文本

我看来 markdown 最大的好处就是只记录内容不规定格式，而一个 word 文件中节标题可以有 100 种格式。。。

[nicoljiang]

markdown 确实有很多不足，但 word 更是令人作呕。

[461229187]

markdown 文件足够小，这不是巨大优势吗

[815979670]

@dcdlove emmm 可是自己定义一个规范出来的话 不会有软件来主动支持吧 除非自己去维护一个“mdp”编辑器

[461229187]

而且 markdown 太适合 AI 输出内容了

[dcdlove]

@815979670 #90 想象一下，您的代码将被全球 Markdown 用户使用，成为未来文档生态的重要组成部分！这是在开源史上留下印记的绝佳机会。喝杯咖啡的时间 ，你就能创造这一切，加油！

[lizhian]

你把它当 word--,感觉十分不好用,哪哪都比不上 word
你把它当 txt++,惊为天人,也太好用了吧

[catamaran]

或者 AsciiDoc 能满足你的需求。另外推荐一个很另类的编辑器，treesheets.

[Vaspike]

我跟 op 相反, markdown 看习惯了; 看 word 文档很容易烦躁, 一页显示不了多少内容, 然后再加点莫名其妙的排版;

简而言之就是假设现在有一个 5000 字的文档, 做成 word 让我读需要读 15 分钟, 做成 markdown 让我读需要 10 分钟

[liuyang1985]

团队协作用的文档还是在线文档最合适。 给个链接过去能保证对方打开永远是最新的版本， 也不用担心资源引用这些问题。

[lycpang]

语雀挺好的。本身就是 md 文档，图片也是在线的。既有 md 编写方便，又有分享方便这个属性。

[tonytonychopper]

markdown 主要就是够简单吧，确实也存在这样那样的问题，但是一想到要用 word 我就觉得还是 markdown 香一点

[cnscud]

markdown 是轻量的流式输出，适合大模型问答。

[shijingshijing]

@815979670 这个是微软.docx 的方式，docx 文档打开就是一个 xml 存储文本，一个文件夹存储所有图片等资源。有可能微软给 docx 申请专利了。