也许 Markdown 并不是一个好选择

[keelii]

一点点想法，造过 Markdown 轮子的可以交流下：

https://wtdf.io/md-maybe-not-good-enough-6-6

[xiadong1994]

我对于 MD 的理解是一个简化的更友好的 HTML，它应该用来定义文档结构而不是用来“排版”。

[rogwan]

MD 还是好东西的，触摸屏上的富文本简直就是灾难。键鼠模式下 md 没什么用

[love]

MD 平衡做得很好了。
要功能强你可以直接写 HTML。

[keelii]

@yuanfnadi mdx is evil
@lhx2008 基于 shadow dom 的 web component 可以实现

[qiayue]

你的编辑器，输入 - 之后自动出现了列表，同时缩进了，列表写完了，想回到不缩进，没办法了

[keelii]

@qiayue https://wtdf.io/guide

Mod + [ 或者 Mod + ] 可以切换缩进量。

[leon001]

@orangutan92 那离线又看不了，很麻烦

[learnshare]

@geelaw 抬扛就没意思了

[MortyP]

要是觉着 markdown 不智能，可以用 tex 呀，专业排版软件，

[yuanfnadi]

@keelii 那你觉得有什么方法可以更好的撰写 react 组件库的文档。

[keelii]

@yuanfnadi 看需求吧，简单的文档直接用 docsify 这种方案就行了，代码展示内内嵌 playground。但是你要说搞组件库文档要能实时交互、还能方便的生成 props 那 mdx 还是挺好的。我觉得 mdx evil 是当它做为 markdown 格式的场景。

[agagega]

复杂的用 Org-mode

[cyspy]

markdown 最大的优势是人脑记得住、人眼可读，额外引入的诸如 graphviz 之类的也都符合这个要求。富文本和图片有太多让人强迫症发作的东西了

[snw]

你如果重度用过 Word 的话，就会知道 Word 这种 WYSIWYG 编辑器出 bug 时简直是灾难。
我不止一次遭遇 Word 修订功能搞坏表格样式的问题，然后就只能人工检查和手动修复。

[Wincer]

楼主可以试试 AsciiDoc

[Windelight]

这么说吧，Word 绝对是现在世界上最好的文本编辑器、排版器，但是你用在网页上，不仅是计算资源的问题，也是网络的问题，所以才会有 RichText，既可以在几十 kb 解决，又可以好一点，虽然排版不是很不行。
其实如果微软能发展 ActiveX 和 Silverlight，本地装了 Word 网页也可以直接用它调，但是实际上微软实在是 Ctrl。
接着又有人认为 RichText 的各路渲染器实际上是资源开销的大头，就算网速快，各种 editor 总是有 XSS 这种东西，那请问有没有什么更好的或者说语法相对简单，还能加入图片之类的？
BBCode 出来了，MediaWiki 出来了，Markdown 出来了，但是那 zs 一般的 MWLang 和 BBCode 的得打标签和回标，还嵌套来嵌套去，虽然没有多少人用特别复杂的排版，但是一般用也很作死。所以 MD 在以 Github 为首的网站被应用了，他很好用。毕竟 mwl 一个词条要经过很多修缮，而一般打字记录就是要方便快捷。
md 相对于 mwl 和 bbcode 相对于 word 来说都是精简了一层又一层，但是一般记录信息又不是那样对吧？

[JaguarJack]

@kaneg 同意。

[siteshen]

@agagega 怎么在非 Emacs 用户中推广 Org-Mode 是个很大的问题。

[LokiSharp]

rst 了解一下

[superalsrk]

Org-Mode 了解一下~