阅读本文需要4分钟
安装pandoc
什么是pandoc
pandoc是一个文件转换工具，支持不同文件间的相互转换，具体见https://github.com/jgm/pandoc 输入文件，支持的格式如下：
commonmark
creole
docbook
docx
dokuwiki
epub
fb2
gfm
haddock
html
ipynb
jats
json
latex
man
markdown
markdown_github
markdown_mmd
markdown_phpextra
markdown_strict
mediawiki
muse
native
odt
opml
org
rst
t2t
textile
tikiwiki
twiki
vimwiki输出文件支持格式如下：
asciidoc
asciidoctor
beamer
commonmark
context
docbook
docbook4
docbook5
docx
dokuwiki
dzslides
epub
epub2
epub3
fb2
gfm
haddock
html
html4
html5
icml
ipynb
jats
jira
json
latex
man
markdown
markdown_github
markdown_mmd
markdown_phpextra
markdown_strict
mediawiki
ms
muse
native
odt
opendocument
opml
org
plain
pptx
revealjs
rst
rtf
s5
slideous
slidy
tei
texinfo
textile
xwiki
zimwiki安装
参考：https://pandoc.org/installing.html。进入下载页面，获取安装包
# linux
# $TGZ 源文件路径 $DEST 安装路径
tar xvzf $TGZ --strip-components 1 -C $DEST修改配置
修改.gitconfig
1. 添加文件名中文支持
[core]
quotepath = false
2. wdiff 比较word
[diff "pandoc"]
textconv=pandoc --to=markdown
prompt = false
[alias]
wdiff = diff --word-diff=color --unified=1增加.gitattributes
你可以在你项目的文件根目录下里新增一个.gitattributes文件，并进行设置。如果不想让这些属性文件与其他文件一同提交，也可以在.git/info/attributes文件进行设置
#.git/info/attributes
*.docx = pandoc如果想要查看历史修改：
git log -p --word-diff=color file.docx不足
1. 不支持doc读取，只能比较docx文件，如果要对文档进行管理，建议保存为docx
2. 只能比较显示的文本，对图片增加删除修改后，比较显示的是 markdown格式，不利于观看
3. 总的来说，如果要管理文档，还是建议先用其他工具比较在提交比较靠谱.git diff对比有些不足。
4. 如有其他实现手段欢迎后台留言讨论。
