Markdown 中的 Table 一键排序

2018-11-06 22:05:43 +08:00
 simonguo

背景

在 Markdown 中我们经常会用到表格 , 但是手动排版太麻烦了,特别是表格排序。

在我们的开源项目 React Suite 中,组件的 API 文档,会用到大量的表格, 在写的时候随心所欲的写,发布上线,然后有人反应,包括我自己也觉得没有排序的表格,阅读起来太不爽了。

那怎么办?改呗。 本来想让新来的同事去改的, 然后再一看文档,80 个左右的组件再加上中英文两个版本,有 160 个左右的表格需要改,每一个表格如果要人工调整是很痛苦的。交给新同事太残忍了,还是自己写个工具解决吧。

本来想找个现成的工具,但是没找到,然后看了看类似的表格的格式化 VS Code 的插件,然后随手就改了改,写了一个可以排序的小插件,希望可以帮到您。

效果

格式化前大概长成这个样子,乱七八糟。

| name | email | description |
| -- | -- | --- |
| zhang | zhang@a.com  | zhang  |
| wang | wang@a.com   | wang |
| li | li@a.com   | li  |
| amity | amity@a.com  | amity  |
| batman | batman@a.com | batman |

格式后,就整齐了,同时 name 一列按照字母排序了。

| name   | email        | description |
| ------ | ------------ | ----------- |
| amity  | amity@a.com  | amity       |
| batman | batman@a.com | batman      |
| li     | li@a.com     | li          |
| wang   | wang@a.com   | wang        |
| zhang  | zhang@a.com  | zhang       |

表格的格式我用的是prettier,它提供很方便的 API。

安装

在 VS Code Extensions 中搜索: Markdown Table Sort

3959 次点击
所在节点    分享创造
22 条回复
simonguo
2018-11-07 17:36:09 +08:00
@Daath 只是格式化距离的话,已经有很多插件了,甚至有些编辑器就带这样的功能。prettier 也是支持格式化。 我没必要再去写一个这样的工具。
这个扩展的名字就叫 Markdown Table Sort, 目的就是解决排序问题。

@quinoa42 排序同样可以做成 TableFormat 的一部分,当把 md 中的 Table 抽象在一个数组对象中以后,有什么复杂的排序不能做
Daath
2018-11-07 17:39:02 +08:00
@simonguo 恩恩。刚才在 vs 插件上已经找到了 prettier,之前没有接触过 vs 的,没怎么去搜过。哈哈,谢谢啦

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

https://www.v2ex.com/t/505167

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

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

© 2021 V2EX