› 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 文件用在团队协作中就是有问题的，但是我不明白为什么会这么做。
 |
101
shijingshijing 10 天前
@PanuiQ #86 离线协作微软从 200x 年就考虑到了，微软所有的 office 产品都带有版本管理功能，最早是配合 Sharepoint 作为服务器端进行协作，后面逐步淘汰了 Sharepoint ，转换成了微软自带的基于 Azure 云服务的 Office 365 ，但是现在还有不少大公司和外企用私有部署的 Sharepoint 。
|
 |
102
crackidz 10 天前
Markdown 只是用来写，保存又不是让你保存了之后直接发给别人...
Markdown 本身也非常方便转换为其他格式，真正发给别人的时候，离线最好的格式是 PDF ，在线就分享个链接 |
 |
103
815979670 10 天前
@shijingshijing #100 应该不会把，epub 电子出版格式 也是类似的方案，不过是 html+资源嵌入，
|
 |
104
Geon97 10 天前
代码文档肯定首选 markdown
|
 |
105
chanChristin 10 天前
你说来说去不还是觉得团队协作上不好用呗
那我感觉还是你对 md 有偏见，觉得有各种各样的问题，但是我用 md 就是为了不需要动鼠标去调复杂的格式，只需要几个特殊的重点标记，不用离开键盘就能比较完整地输出一篇有格式有层级的文章就行了。 你说的图片问题，我理解的 md 适合插入在线图片，或者楼上的插件转成 base64 ，至于你说的插入音视频我觉得你在扯淡，你会往 word 里面插入音视频的场景又有多少呢。 如果你们的团队协作场景经常性的需要格式工整、包含各种多媒体、需要大量数学公式和复杂表格的情况下还非得有人要用 md 来做，那是他有毛病；如果 md 就能解决的问题反而是你非得用 word 我觉得你可以看看奥卡姆剃刀。 |
 |
106
xubingok 10 天前
md 文档顶天贴贴图片罢了..其他的媒体还是算了.
然而我从来不用本地图片,都是贴图床链接. |
 |
107
PanuiQ 10 天前
@shijingshijing #101 草台班子，根本没这些东西，大家各自发挥，word 和 wps 混用，分别打开同一份文档也会出现格式问题，甚至页数都不同。至于在线协作那更不可能了，公司的文档是不允许上云的。
|
 |
108
zblogstop 10 天前
@wonderqs 如果是团队协作的情况，用 Google Dcs / 飞书文档/钉钉文档也可以，而且没记错的话这些线上文档都是支持基本的 markdown 语言的。
Word 作为编辑器来看太重了，很臃肿，不如 markdown 这种标记语言轻量化。用 Word 和用 markdown 的人完全是两类不同的群体。用 word 的人追求多样化排版；而用 markdown 的人则是不在意排版，追求极简。 |
 |
110
abcbuzhiming 10 天前
你和我的想法是一样的，我最终放弃 markdown 就是因为这玩意要“所见即所得”太麻烦了，文档这个东西应该是写少看多的，看的多的东西，markdown 就不太合适。富文本才是合理的路径，当然富文本搞成 word 那样又太夸张了，其实应该允许中间路线存在
|
 |
111
bowencool 10 天前
因为它是纯文本，不需要任何工具就能写，而且方便 git diff 。
你说的插入音视频，在里面写 HTML 标签就能实现了，不需要任何插件。 图表也有 mermind 插件，这就需要呈现端也安装同样的插件，但这样就背离了它简单这一优势，如果呈现端是自己控制的，比如写博客网站，那还是很香的 所以说 markdown 的设计原则就是简单，再复杂就不叫 markdown 了，得改名 mdx 之类的。mdx 里可以写代码，写复杂交互，甚至写个 APP ，不比你 docx 强多了。 |
 |
112
yaytohkay 10 天前  2
我会嘲笑任何一个用 word 写技术文档的人，这玩意放到 github 上都没法预览的
|
 |
113
leatomic 10 天前
@Narcissu5 "《黑客与画家》里面专门有一章讲为什么要用纯文本"，没看过这书，这是直接否定对样式的真实需求吗？
你说的最大好处是只记录内容不规定样式（列表项/表格单元格/链接等等内容就是各种格式了，你说的应该是指样式），不规定，是分离内容和样式而已，没错，方便在不需要编辑内容的情况下随意调整样式。主要是限制了元素的多样性，标题只有 6 级(记得好像是)，所有 1 级标题样式统一，不需要那么灵活，对于所有的一级标题，极少需要针对某些个一级标题整出花来差异化表达出额外的信息)，合作者的样式再难苟同，内容格式正确，到我这来按照我喜欢的样式展示，依旧很好看。 然后非常重要的是输入方式，我不知道 word 有没有特殊的指令/宏之类的将当前输入的元素的样式设置为一级标题，在我认知中只能先输入内容，然后由键盘切换到鼠标操作...在键盘和鼠标中切换，对于大脑来说注意挪动手掌位置，是一种很重的消耗，尤其是需要频繁操作，严重影响心流，这才是主要的一大痛点吧。markdown 输入起来确实爽多了，至少常见的大部分元素是覆盖了，当然我指的是在所见即所得的编辑器下的。 |
 |
114
kytrun 10 天前
|
 |
115
bsidb 10 天前
楼主如果用 Word 合并过多个人合理编写的大部头报告/书籍，被自动编号、标题格式、各种格式不一致整崩溃过，就能理解大型多人合作文档用 Markdown 其实挺好的。
|
 |
116
AirBai2 10 天前
我觉得挺合适的，看个人喜好吧
|
 |
117
Felldeadbird 10 天前
考虑过这个问题。
但是 MD 最好特点就是 好拆分和转换。 MD 的文档可以转各种类型。 反过来说，如果你是富文本的，转换的复杂度就上去了。 |
 |
118
zzzsy 10 天前 via Android
你再看看 adoc 呢
|
 |
119
irrigate2554 10 天前 1
别人喜欢别人觉得够用就用，你不喜欢，你就别用。更何况 markdown 是兼容 html 的，理论上任何效果都能实现
|
 |
120
bugu1986 10 天前 via iPhone
没有
|
 |
121
loveumozart 10 天前
markdown 用途：
github 项目公开文档，表面上你是在用 markdown 写文档，其实你是在写一个网页，轻量化了，挺适合的 和别人分享文档，用 markdown ，不适合，图片都插入不了 用 mardown 写笔记，不适合，非常不适合 |
 |
123
icy37785 10 天前
你觉得 markdown 不适合团队协作，然后困惑很多人工作中这样干，然后表示不理解。
有没有一种可能，不是 markdown 不适合团队合作，是你不适合团队协作。 我反正认为想使用 word 写文档的人，真不大适合团队协作，markdown 还能说优点跟缺点都很明显，word 是真找不到什么优点。 |
 |
124
fcten 10 天前
因为 markdown 就是用来转成网页浏览的。你甚至可以直接在 markdown 里写 html 。谁会直接打包 markdown 去分发？不都是渲染成网页放到静态页面托管服务上吗？
如果你们公司对 markdown 的支持不好，那不是 markdown 的问题。举个例子，假如你们公司没买 office ，有人用盗版 office ，有人用 wps ，有人用 libreoffice ，结果 word 的使用体验肯定是灾难，但这不是 word 的问题。 |
 |
125
Tokin 10 天前
可以封装一下 md ，把 md+图片等媒体文件打包进 zip ，然后写个程序去读就好了
word 文档不也是 zip 打包的吗 |
 |
126
leiletter 10 天前
请问日常记录码字的话，用 markdown 需要频繁切换中英文输入法，大家是怎么解决或者适应的？
|
 |
127
xjzshttps 10 天前
我是觉得 word 更不适合团队协作，或者说不适合版本库管理的团队协作。
>不能像 word 一样打包到一起，这样在把文件发送给别人的时候很不方便。 可能其他领域直接发 word 文档挺合适，但是感觉互联网企业文档用 word 很离谱。 仅更新就是很麻烦的问题，如果文档更新了，难道要再次给很多人重发 word 新版本的文件吗？ 一个项目有多个不同的 word 文档，如果更新了其中一个，是给所有客户重发所有 word 还是仅发变更的？ 然后客户那边在自己手工保存并维护新版本？ 或者说提供个 ftp 让用户直接访问文档文件？ 或提供下载功能，让用户自己下载后观看？ 但是要求用户必须有 word 软件，要是注意合规，那么还要 word 软件授权。这一条就会造成 word 不适合，你不能强迫用户再去购买 word 软件。 反而 md 的文档其实都是直接转换为 html 展示，客户直接访问网页就能得到最新版本的文档。浏览器不需要购买，简单得多。 如果真的需要 word 类似的单文件，直接转换为 pdf 也不麻烦，甚至转换为 word 也不是没有这个功能。 然后再说下文档更新维护问题。 靠谱的企业要有版本管理功能，要记录下来是谁修改的哪一部分。md 是很容易实现版本管理及编辑责任追踪的。 但是 word 我没怎么了解，但是感觉并不是那么简单。 另外 md 可以简单的实现网页编辑提交功能，企业内文档管理系统很容易实现。 但是 word 我就觉得这个不太好弄，难道要做成 用户下载了原始版本的 word ，本地使用 word 编辑，然后在上传到文档管理系统？ 虽然也有在线编辑 word 类的实现，但是成本高，并且 wps 都不能做到和 ms office 一致，我是不信在线编辑类的能实现显示一致。 都的确 md 格式太简单，很多东西都不支持，但是相对于 word 还是更有优势。 对了，看看，今天 V2EX 还有用户问是否有免费的 类 word 软件，他有合规需求。这还是在已经出现 wps 免费版本的情况下，想想以前没有 wps 免费版本时，就知道为什么 word 不太适合了。 |
 |
128
chingyat 10 天前 via iPhone
是的，markdown 其实不太适合写文档. 相比之下 rst 更适合.
|
|
129
xjzshttps 10 天前
@xjzshttps #127 其实仅合规问题就能让 word 不太合适。
国内小其他不注重合规，但是想做大或者做的比较大的企业还是要注意版权问题。 想一下一个公司要开发一个通用的企业文档管理系统，那么他是选择 word 还是选择 md ？ 选择 word 意味着强迫客户企业及客户企业的客户都要购买 word ，那么想购买这套系统的企业购买前是不是会考虑下这个问题？ 或者说一个大型公司对外公开的文档系统，他是选择 word 文档？ 强迫自己全球的客户都要购买 word ？ |
 |
130
isnullstring 10 天前
这玩意适合简单记录，不需要过多样式和图片
|
 |
131
wentx 10 天前
用 ASCIIDOC 吧
|
 |
132
ob616 9 天前
个人觉得非纯文本容易搞成 PPT 一样看起来花里胡哨实际信息量更低可读性更低的东西。有点像 CPP 之于 C ，提供了很多语法糖，但也多了能出错的新写法，各种抽象又需要阅读更多代码
|
 |
133
Cccczzz7 9 天前
有个追求格式的狂人搞了 latex ，之后很久科研领域涉及符号格式的都在用，但是插图片实在是太麻烦了；鞋合不合适只有脚知道，工具趁手好用就行，哪个好用用哪个，如果想打个几百字的内容，做个记录，用 typora 写 markdown 是比较舒服的方式，word 更适合长文章，代码可能 jupyter notebook 会好一些，但是在一些性能孱弱的电脑，可能打开 wps 或者 word 的时间太长，还不如新建 txt ，以及最经典的 解压密码是 XXXXX.txt
|
 |
134
cj323 9 天前 via iPhone
看受众。如果是我自己或者一两个开发。txt 就够了，放 github 会放个 md 。公司内部就看标准了，md 写过，txt 写过，confluence 写过
|
 |
135
gigishy 9 天前 via iPhone
不多说，直接谈我个人意见：完全肯定 op 的疑问：我觉得不适合。
|
|
136
gigishy 9 天前 via iPhone
op 另一个问题：“既然如此不适合，那么为什么还是有那么多人喜欢用 markdown 来写文档呢（包括写笔记）？”
我回答：装的居多，人云亦云居多，用此来显示自己高档的居多，不懂得内容大于形式的居多…… |
 |
137
alading11 9 天前
所以我用在线笔记，支持 md ，支持上传图片
|
 |
138
xinshidai 9 天前
(latex,typst, quarkdown) > markdown
|
 |
140
MoRanjiang 9 天前
方便版本管理，虽然对日记版本管理听起来有点奇怪
|
 |
141
tusj 9 天前
还得是飞书文档
|
 |
142
goodryb 9 天前
我觉得是不适合写复杂的文档，如果是纯文本+简单表格+图片还可以，如果要用到专业的能力，比如数学公式、复杂排版 还是得靠 word
|
 |
143
jukanntenn 9 天前
markdown 只是规范，具体用户体验怎么样得看应用的实现，例如使用 obsidian ，上述你说的一些场景，上传图片，附件，打包等，体验都很好。
|
 |
144
mingtdlb 9 天前
md 适合文本，文档还是算了
|
 |
145
jeesk 9 天前
简单的记录就是 txt 最好。markdown 在手机上其实不好。
|
 |
146
uds9u32br 9 天前
纯文本是最舒服的，带多媒体文件的是要头疼一点
|
 |
147
LitterGopher 9 天前 1
不如反過來問, 除了 md 你還可以選擇那些東西?
1. HTML? 拉倒吧, 結果雖然很好看, 但 HTML 文本本身真的很難好看 2. WIKI?和 md 差不多的複雜度, 但是並沒有強大多少, 而且支持渲染的軟件很少 3. word? 請問如何在不打開 word 的方式下搜索裏面的文字? 最好支持正則 4. typst 或其他排版工具? 確實很好用, 但是對於筆記或普通文檔來說有點複雜 markdown 不是最好的選擇, 但一定是最不差的選擇: 1. 語法簡單, 十來分鐘就能看完 2. 編輯器支持完善, 支持 md 語法的軟件太多了 3. 筆記更應該關注的是筆記內容, 而不是表格多好看, 表格能不能支持運算, 圖片能不能居中這種无关紧要的問題 4. markdown 本身是簡陋到有些粗陋的, 但也方便其他軟件對其進行擴展,比如 obsidian 的雙向引用, 比如 notion 的摺疊塊 |
 |
148
SoviaPhilo 9 天前
说些你们可能没提到的点，markdown 利于版本管理， 同时纯文本也利于 LLM 协助
在 ai 增强检索技术发展到足够高，成本到足够低之前，markdown 都会是比 ms word 更合适的文档格式 |
 |
149
cheerxl 9 天前
对我来说，markdown 最大的优势就是可以通过 git 来了解文档的变更，此外相比起 word ，md 不用频繁切换上下文（软件），在一个编辑器里把事情都做了。
|
 |
150
MuSeCanYang 9 天前
多人协作的话，离线应该都不咋地吧。 你用其他的方式，效果也一般般啊
|
 |
151
zuotun 9 天前
如果 word 也能够在浏览器等地方直接阅读编辑，那我也很乐意用，不然还需要一个专门的阅读器，我觉得很麻烦，我现在自己的几台电脑都没装 office 类软件，只有一台工位的才有。
|
 |
152
chenqh 9 天前
md 写表格太痛苦了,所以我现在主要用 rst
|
 |
153
yb2313 9 天前
用 typst
|
 |
154
SkywalkerJi 9 天前 via Android
如果是项目交付文档，最好肯定是 pdf 吧。
word ，md ，都会随着阅读器不同显示出不同样子。 md 强在兼容 git |
 |
155
wcs111 9 天前
源文件使用 markdown 给别人看，输出 html 之类的
|
 |
156
longzhentian 9 天前
用 markdown 各种编辑器都可以打开 不用考虑排版 分页这些，还有上面说的 git 版本管理
用 word 必须使用 wps 或者 office 才可以打开，而且还会出现分页的情况莫名其妙的出现空白部分（强迫症真的想看看能不能去掉空白） |
 |
157
sleepingdog 9 天前
|
 |
158
WuDiHaiTai 9 天前
我认为 md 应该和 txt 作比较，而 word 去对标 LaTex 。
|
 |
159
newyangnc 8 天前
|
 |
160
agagega 8 天前 via iPhone
这么多人里只有一个提到了 textbundle 啊
不能带图片不是 markdown 一个的问题，而是所有纯文本格式的问题，但是纯文本本身就和带资源这件事是矛盾的，只能靠 textbundle 这样折中下。 说 markdown 本身的缺点的话，就是太混乱了，最原始的 markdown 功能非常少，各种衍生版相互不兼容。真写复杂的文档也许 restructuredtext 、org ，甚至 LaTeX 都会适合一些 |
 |
161
levelworm 8 天前
Confluence 使用下来还是最舒服的，虽然它的确也有不少问题，但是内嵌媒体没有什么大问题。
|
 |
162
apuslilie 8 天前
@Cccczzz7
个人理解 latex 跟 markdown 有点像，设计初衷是让大家从格式（狭义的说就是“所见即所得”）中解放出来。大概写个文档，能看出来标题和篇章结构就行了，具体怎么排版交给具体的渲染程序就行了。 但是慢慢的好像变成一个追求格式统一的东西了。。 |
 |
164
rarpainting 8 天前 1
markdown 不就是最适合团队协助的吗，你是没见过一个文档 N 种排版的？
|
 |
165
kapaseker 8 天前 1
哈哈，我巴不得所有的文档，图标都用 Markdown 写
|
Select Language