› Daring Fireball: Markdown
› CommonMark
› MacDown Open Source Markdown Editor
› Marked
› GitHub Flavored Markdown
如题，markdown 这种东西有很多问题，例如依赖的媒体资源（例如图片）只能作为零散的文件存在，不能像 word 一样打包到一起，这样在把文件发送给别人的时候很不方便。另外 markdown 文件一旦拷贝或移动过，那么依赖的媒体资源的路径就会破坏。
除了这些之外还有很多问题，例如无法插入音视频资源，无法构造复杂图表，对于数学公式的支持也是缺失的。
按我的理解 markdown 本身就只是在很朴素的纯文本基础上做了一些增强，它的目标场景也是取代一些原本使用纯文本的地方（例如代码的 readme 文件、部分 web 场景下的文本编辑功能等）。既然如此不适合，那么为什么还是有那么多人喜欢用 markdown 来写文档呢（包括写笔记）？
第 1 条附言 · 10 天前
我本意不是想在这里讨论 markdown 的优劣势，因为这些东西本质上没有什么争议。我讲的这种问题是限定在“使用离线的 markdown 来写工作文档，并且使用这种方式进行团队协作”这件事情上。因为我有遇到不少人在实际工作中这么干，我是觉得这样做是不妥的，markdown 可能自己使用很习惯，很棒，但是当你把 markdown 文件用在团队协作中就是有问题的，但是我不明白为什么会这么做。
 |
1
damichifan 10 天前
习惯吧，自己用的方便，用这个的应该 大多程序员，总会涉及程序内容的
|
 |
2
kokerkov 10 天前
本来就是纯文本的时候用。其实也并不便利。readme 还是 txt 最多。毕竟默认什么平台都能显示。
|
 |
3
sayhe110 10 天前
简单轻便？例如 ### 设置标题，加粗等等，资源的话感觉上传到服务器上就不会有这个问题。
对于我的话，markdown 更轻便和样式更加丰富，可以添加 css 等等，如果代码块的话更加美观 |
 |
4
seven777 10 天前
只适合自己用,或者发布式分享.不适合传统的文件共享式交流.
所以我全面拥抱 WPS , 其 智能文档,真的很方便. (可以发布,可以分享,可以共享,可以带图片导出,可以多端使用......) |
 |
5
liuhuansir 10 天前  1
md 排版简单，或者说是简陋够用，再就是它是文本文件，支持版本比对
|
 |
6
Dillan 10 天前
写 MarkDown 的时候可以完全不用鼠标，而且利用开源库能直接将 Markdown 转换成网页方便浏览，适合团队文档协作
|
|
7
seven777 10 天前
WPS 的智能文档,缺少导入 markdown 文件.缺少导出为 markdown 文件.
|
 |
8
lnbiuc 10 天前
那用啥，有更好的替代品吗，不要 word
|
 |
9
hnbcinfo 10 天前
markdown 我都是自己用，管理自己的文档，都在本地。需要分享的时候我都转 pdf 发给别人。
|
 |
10
hafuhafu 10 天前 1
对我来说笔记能区分文本样式以及显示图片就够了，我用 Markdown 记笔记的原因也是我本来就只需要这些。
你的需求本来就不适合 Markdown 来做。 |
 |
11
EastLord 10 天前 1
|
 |
12
retrocode 10 天前
markdown 做源码, 完了发布其他插件或者博客生成的结果, 便于统一管理主题样式
|
 |
13
superrichman 10 天前 4
你没有被 word 的标题排版和数字编号折磨过吗？
|
 |
14
lujiaxing 10 天前
@superrichman 没有 WORD 的排版跟编号没那么复杂. 而且还能自定义样式. 挺好的.
|
 |
15
wonderqs OP @superrichman 说实话，没有，我觉得 word 比 markdown 好用，所见即所得
|
 |
16
wu00 10 天前 2
很适合，很干净，图尽量用 mermaid 、graph 去画
发布分享可以用在线文档/生成 pdf |
 |
17
HojiOShi 10 天前
写作和排版是两种不同的需求，我不喜欢将这两种需求强行结合在一起。
|
 |
19
shijingshijing 10 天前
发布的时候直接打印成 pdf 不就图片和文字在一起了么？
|
 |
21
johnsmith2077 10 天前
转 pdf 很方便的，一个 vscode 插件就行
|
|
24
wonderqs OP 关于导出 pdf 这个事情，我觉得很多时候文档分享不是简单的一个人写，一群人读，而是大家一起写，一起读。你给人家 pdf 就不是一个合适的方式
|
|
25
lujiaxing 10 天前 5
Markdown 就是自行车, 用来写一些轻量化的文档其实蛮合适的. 比如功能说明, 开发文档之类的. 但是拿来写一些很复杂的东西就不合适了. 比如带表格的内容 (我知道可以), 图文混合内容, 带公式的内容之类的.
Word 就是汽车, 操作有一定难度, 但是不算难. 而且适用范围很广. 排版也很方便. 很适合写一些排版很复杂的文档. 你上下班骑自行车行. 你过年回老家, 也骑自行车么? |
 |
26
BenHunDun 10 天前
自身的体验是, 大部分情况下, markdown 的基本能够覆盖需求.
而且因为是纯文本文件, 在没有任何软件的情况下都能够使用 (但会丧失其一定的可读性) 然后提到的多媒体部分其实很多像 Obsidian , vscode 也都在支持. |
 |
27
scarlex 10 天前
纯笔记的话很适合，毕竟都是自己看的
|
 |
28
AsahiHuang 10 天前
其他 excel 更方便（
|
 |
29
realJamespond 10 天前
markdown 是文本，可以直接用 notepad 打开，github 上能打开，obsidian 能打开是通用的格式，word 不是文本要用 word 或 wps 才能打开 make sense ？
|
|
30
wonderqs OP @realJamespond 这的确是个优点，但是上面说的缺点们和这个优点没有关系呀，就算能用 notepad 打开，又能怎样呢？
|
|
32
wonderqs OP 还有一个在团队写作中使用 markdown 很糟糕的体验：当别人管你要一个文档，你给人家一个导出的 pdf 的时候是容易让对方不舒服的，因为这样做本质上就是不给人家评论和编辑的权力
|
 |
33
fivemoons 10 天前
用支持 markdown 的 web 版软件能解决媒体资源路径问题，有些额外开发了支持复杂图表的功能
|
 |
34
hhharuka 10 天前 1
大部分人 word 排版都不会
字体不统一 段落不会设置 。。。 简单的文档 markdown 优势太明显 复杂排版下 word 肯定是最佳选择 |
|
35
BenHunDun 10 天前
还有一个在团队写作中使用 markdown 很糟糕的体验：当别人管你要一个文档，你给人家一个导出的 pdf 的时候是容易让对方不舒服的，因为这样做本质上就是不给人家评论和编辑的权力
- 感觉针对这个是团队要统一工具吧. 还有感觉很大一部分是 markdown 不够满足你对文档的需求. - 自身还有一部分就是 git 对文本支持, 可以通过 git 去追踪自己的修改. |
 |
36
lambdaq 10 天前 3
看到标题：“觉得 markdown 并不适合拿来写文档” —— 我也觉得，打开正文看看
看到正文：“不能像 word 一样打包到一起” —— 这还不如 md 呢。。 |
 |
38
Zien 10 天前
在「简洁通用」和「方便易用」上此消彼长，于是用户不停地尝试新编辑器和插件，最终陷入死循环，依然乐此不疲，因为无可替代。
|
 |
39
zhuangzhuang1988 10 天前
就是很少人用 reStructuredText
|
 |
40
hwdq0012 10 天前
一篇文章一个文件夹，里面放 md 和图片，我的博客是这样的， 本地写好 md 直接 post 到博客上，也可以整个目录发给别人，如果要分享的话
word 里放 video 本来也让人觉得很 zz 吧， 文档里面放个视频，那文档也不用写了 |
 |
43
v3ct0r 10 天前
表：“markdown 不适合写文档”
里：“markdown 普及率不及 word” 提到的团队协作的问题，如果我没装 word 或不会用 word 又改如何呢  |
 |
44
cnuser002 10 天前
markdown 顺应的是 web 时代一行行写东西的这种感觉，重内容，轻格式。
|
 |
45
DOLLOR 10 天前
markdown 支持基本的排版格式（标题、链接、分割线），跟代码混排方便，能集成在网页里，能被 git 跟踪。
|
 |
46
tairan2006 10 天前
md 可以写文档，但是输出给别人看，最好转成 pdf
另外，图片和流媒体，一般使用图床（如阿里云 oss ）存放 md 适合被 git 做版本管理，因为可以 diff |
 |
47
xubeiyou 10 天前
还挺好的 至于你说的图片等外部资源问题 这个没办法 不能既要又要的- -
|
|
48
v3ct0r 10 天前 7
换句话说
docx 格式是 xml 加上相关资源的打包。 那我也将 markdown 和相关资源一起打包，并取名为 mdx 格式，要用专业软件才能打开，那还有上述问题吗？ |
 |
49
agentkw9 10 天前 via Android
我们内部文档用飞书维护，代码仓库里的说明使用 md ，和代码一起用 git 维护
|
 |
53
huangmingyou 10 天前
@lnbiuc tex
|
 |
54
Greendays 10 天前
但是 Markdown 可以用 Git 来管理版本，这点比 Word 之类的强。Markdown 也方便在浏览器里显示。
功能确实还是 Word 更多的，有些文档就是得有截图，有视频，有附件，这个时候 MD 就不太方便了。 |
 |
55
fano 10 天前
word 协同编辑会有合并冲突的问题。markdown 是纯文本，可以用 git 、outline 进行协同。
|
 |
56
Sfilata 10 天前
我就很抵制 word ，能不用的时候就不用。至于你说图片等外部资源这样就可以了，然后一起打个包。我没觉得有啥麻烦的。
```markdown # Test for the image  ``` |
 |
57
wudaye 10 天前 1
其实看上面很多人的回答就知道，很多人尤其是程序员是很魔怔的，我是觉得 notion 或者飞书的智能文档是最好用的，只是没有像 markdown 一样开源格式出来，毕竟这些公司都是要赚钱的
|
 |
58
SGL 10 天前
没有轻便简单的基于代码管理格式的替代。Latex 最近看到有 Typst 在替代。Markdown 则没有更好的替代。其实个人觉得 markdown 在表格形式上比较薄弱以外，图片等资源专门放到一个文件夹里面到也没有什么问题，反而比较直观。
|
|
59
Sfilata 10 天前
@Sfilata 而且像你说的图表啊，音视频啊这种需求都有 mermaid 类似的解决方案。如果要共享的话找个可以在线解析的平台就可以，比如 github 或者别的什么。
|
 |
60
rossroma 10 天前
你的题目和你的补充本质上是两个问题。团队协作的问题不在 markdown 上面，它本身只代表一种语法，问题是在离线。你哪怕用离线的 word 、PDF ，我觉得都是不妥的。既然是团队协作，那优先肯定是在线协作文档，开源和收费的工具都很多。而这些在线文档工具，绝大多数也是 markdown 语法或者在 markdown 基础上进行扩充。所以我的结论是 markdown 适合写文档，而任何离线文档都不适合团队协作。
|
 |
61
totoro625 10 天前
因为你没见过 word 里面一团乱麻的格式，真的想把制作文档的人脑袋敲开看看是什么浆糊
会一点字体、段落、行高、分页就算是前 10%的优秀工具人了 |
|
62
Sfilata 10 天前
而且恰恰因为要协作，所以才应该越简洁越好。你如果一直用 word 的话，你让用 mac 的人怎么办，用 linux 的人怎么办。不说要忍受 word 的卡顿或者 wps 的广告，这几个平台能不能打开，打开后一不一样都不能保证。这协作起来哪里有优势？
|
 |
63
Codingxiaoshi 10 天前
可扩展性强, 就是门槛够低, 上限够高
|
|
64
SGL 10 天前
@wudaye 这些只能文档基本上都是丰富 markdown 的语法和能力，正如你所说，他们都不是开源的格式，并且都是在线的。所以，对于程序员个体来说，兼容性以及数据安全性角度上，markdown 就是最便捷，合适的一种数据组织格式。并且公司内部协作，尤其是计算机相关的，我想基本上都是类似飞书语雀这类的云文档，或者类似 wps 这种云文档吧。
|
 |
65
GeruzoniAnsasu 10 天前
太奇怪了，markdown 难道不只是一种标记方式？
真正讨论「写文档」的时候，相互对标的难道不应该是 word 、语雀、飞书、Notion 、Obsidian 、Confluence 吗 难道 OP 想讨论的是某个 markdwon 纯文本到处发这种……文档……呃……产品？ |
 |
66
Azone 10 天前
不适合拿来写文档？那什么适合呢？一大堆工具可以将 markdown 转换成静态网站/网页（大部分），一大堆工具可以将其转成 PDF 。想插入音频、视频、数学公式，你可以使用一些提供支持的软件，也多的要命。markdown 这么的简单易用，一切非要用 Word 写才算合适吗？
|
 |
67
Richared 10 天前
我写 markdown 单纯的因为没有审美，word 字体样式，让我添加个表格直接麻爪，markdown 就很棒，你只管写，不需要管格式。
|
 |
68
adoal 10 天前
Word 有 Word 的协作方式，MD 有 MD 的协作方式，取决于文员和程序员谁的话语权更大。
|
 |
69
klo424 10 天前
基于你的需求，你用飞书就行了，word 和 md 都不适合。
|
 |
70
JingXiao 10 天前
全都要不就行了，一般单位协同办公基本就用钉钉或者飞书的云文档，支持传统文档编辑也兼容 md 语法，有啥好纠结的。
|
 |
71
sky3hao9 10 天前
目前最好用的是就是这个了, txt 不能编排, 不能插图片
mac 平台下带了很多编辑工具, 有的还支持画图, 但是我用的很少. 习惯了 vscode + md |
 |
72
815979670 10 天前
我一直觉得 markdown 可以增加一个 mdp 格式(规范)，既 markdown + package ，主文档内容可以通过 markdown 语法完成，附件可以通过相对路径引入，然后 md 文件和 附件通过 zip 等压缩格式打一个包，扩展名就叫 .mdp （其实想法和 word 一样 只不过 文档内容通过 markdown 排版 ）
|
 |
73
ExplodingFKL 10 天前
没什么讨论的 , markdown 语法简单，扩展方便 ，非二进制存储，有成熟的 lint 和转各种格式的工具，方便被 git 管理， 其他的基本上没法比，都有各种各样的问题
|
 |
74
gongxuanzhang 10 天前
我看到 word 真的恶心想吐
|
 |
75
lynan 10 天前 via iPad
markdown 语法还是挺方便的，比如在 IM 里面发代码块之类的直接打就行（当然了在工具栏上点点点也可以，麻烦一点）
|
 |
76
iv2ex 10 天前
在多媒体资料少的情况，我觉得 md 更适合写文档，因为 md 相比其他文件更容易被 AI 工具支持。（我用 windsurf 写文档）
|
 |
77
nirvam 10 天前 1
插入图片可以考虑使用 inline data uri ，图片转 base64 之后贴在文档末尾，格式形如：
`[some_alias]: data:image/png;base64,iVBORw0KG...` 文档中间要插入图片的地方使用 `![alias]` 引用即可。 坏处是替换的时候稍微有点麻烦，文件体积比较大，对 git 不太友好。另外不同的 Markdown 渲染器对指定宽度的语法和效果并不统一。 |
 |
78
Martinez 10 天前
txt 和 latex 挺好的
|
 |
80
dcdlove 10 天前 2
这个想法好，AI 完善了下
      |
 |
82
howie110 10 天前
md 就是一个文本，用啥都能打开，足够自由而且永恒存在，安全感满满
团队协作中不用 md ，使用其它，那它迁移成本就很高很麻烦 |
 |
83
pkoukk 10 天前
文档分写给谁看
|
 |
84
hallDrawnel 10 天前
要团队协作那就还得是在线的编辑器，confluence 就做得很牛逼，用起来相当思丝滑。MD 还是只适合以 codebase 管理方式低频率更新的东西。
|
 |
85
javak 10 天前 4
现在的小朋友啊， 既不了互联网的发展，也不愿意去了解，或者都不知道怎么去了解。 优劣也好，适不适合也好， 简单了解下 markdown 是怎么出现的，啥都知道了。
或者 OP 就是揣着明白装糊涂， 那么你就应该扔个暴论：「我觉得 markdown 是个垃圾，为啥怎么多人喜欢」。 可能回帖的会更多。 |
 |
86
PanuiQ 10 天前
离线协作那 word 更是个灾难，建立好的模板都没用，每个人提交上来的都会多出很多格式。刷 6000 页 word 的格式那确实爽
|
 |
87
Narcissu5 10 天前 1
《黑客与画家》里面专门有一章讲为什么要用纯文本
我看来 markdown 最大的好处就是只记录内容不规定格式，而一个 word 文件中节标题可以有 100 种格式。。。 |
 |
88
nicoljiang 10 天前 1
markdown 确实有很多不足，但 word 更是令人作呕。
|
 |
89
461229187 10 天前
markdown 文件足够小，这不是巨大优势吗
|
|
91
461229187 10 天前
而且 markdown 太适合 AI 输出内容了
|
|
92
dcdlove 10 天前
@815979670 #90 想象一下，您的代码将被全球 Markdown 用户使用，成为未来文档生态的重要组成部分！这是在开源史上留下印记的绝佳机会。喝杯咖啡的时间 ，你就能创造这一切，加油！
 |
 |
93
lizhian 10 天前
你把它当 word--,感觉十分不好用,哪哪都比不上 word
你把它当 txt++,惊为天人,也太好用了吧 |
 |
94
catamaran 10 天前
或者 AsciiDoc 能满足你的需求。另外推荐一个很另类的编辑器，treesheets.
|
 |
95
Vaspike 10 天前
我跟 op 相反, markdown 看习惯了; 看 word 文档很容易烦躁, 一页显示不了多少内容, 然后再加点莫名其妙的排版;
简而言之就是假设现在有一个 5000 字的文档, 做成 word 让我读需要读 15 分钟, 做成 markdown 让我读需要 10 分钟 |
 |
96
liuyang1985 10 天前 via Android
团队协作用的文档还是在线文档最合适。 给个链接过去能保证对方打开永远是最新的版本， 也不用担心资源引用这些问题。
|
 |
97
lycpang 10 天前
语雀挺好的。本身就是 md 文档，图片也是在线的。既有 md 编写方便，又有分享方便这个属性。
|
 |
98
tonytonychopper 10 天前
markdown 主要就是够简单吧，确实也存在这样那样的问题，但是一想到要用 word 我就觉得还是 markdown 香一点
|
 |
99
cnscud 10 天前
markdown 是轻量的流式输出，适合大模型问答。
|
|
100
shijingshijing 10 天前
@815979670 这个是微软.docx 的方式，docx 文档打开就是一个 xml 存储文本，一个文件夹存储所有图片等资源。有可能微软给 docx 申请专利了。
|
Select Language