Format the markdown table in any editor that supports an external command
- 支持中文等多字节字符, 需要等宽字体
- 支持任意可自定义外部命令的编辑器
- php编写, 运行时需要php引擎
1.下载文件(以mac系统为例, 假设安装在/data/
目录下)
cd /data
git clone [email protected]:zh-five/MarkdownFormat.git
2.在sublime text3中, 为markdown文档配置一条build命令
选择 Tools
> Build System
> New Build System...
打开文件后, 复制以下内容写入
{
//注意更换路径和调整参数(因系统和字体的不同可能需要调整参数, 见文档末`其它一些问题`)
"shell_cmd": "/usr/bin/php /data/MarkdownFormat/mdfmt.php $file 3 5;",
//文档选择器, 限制为只对markdown文档有效
"selector": "text.html.markdown"
}
直接保存文件在默认的目录中, 取名为md-fmt.sublime-build
, .sublime-build
部分不要修改,
前面的文件名可以改为你喜欢的.
3.使用
把以下内容粘贴到sublime text3中, 保存为test.md
, 然后按快捷键command + b
即可格式化表格让其对齐
# 水果价格
| 名称 | 单价(元)|
|--| ---:|
| 苹果 | 6.50 |
| 脐橙 | 8.30 |
| 火龙果 | 8.99 |
col1|col2
:-|:---
a |b
c |d
1.下载文件(以mac系统为例, 假设安装在/data/
目录下)
cd /data
git clone [email protected]:zh-five/MarkdownFormat.git
2.在phpstorm中配置一条扩展命令
PhpStorm
> Preferences...
> Tools
> External Tool
点击右侧区域左下角+
号
在打开*.md文件时, 从顶部菜单运行刚才配置的命令即可格式化, Tools
> External Tool
> formatmarkdown
为例精确计算字符串的宽度, 进行对齐. 你的编辑必须使用等宽字体. 但同一中等宽字体, 在不同的编辑器里宽度是不一样的.
例如在我的sublime text3中, 3个汉字的宽度与5个空格宽度完全相等, 所以配置的命令为
php /data/MarkdownFormat/mdfmt.php $file 3 5
而在我的phpstorm中, 是4个汉字与7个空格完全相等, 所以配置的命令为
/data/MarkdownFormat/mdfmt.php $FilePath$ 4 7
因为系统、编辑器和字体不同,你可以用下面的方法精确找出字体的宽度
在你的编辑器里输入以两行字符,都使用|
结束,第一行逐渐增加汉字,第二行输入数字调整|
位置,当竖线垂直方向完全对齐
时,汉字个数和数字个数分别就是命令末尾的两个参数
汉字汉字|
1234567|
注意, 编辑器一定要设为等宽字体, 格式化工具才能正常工作. (不过编辑器的默认字体一般都是等宽字体) 若还有其它问题, 请留言.