将Markdown文件重新格式化为特定的代码样式

Question

我正在写一本有几个人写作和编辑文本的书。一切都是Markdown。不幸的是，有不同风格和线条宽度的混合。从技术上讲，这不是一个问题，但在美学方面并不好。

重新格式化这些文件的最佳方式是什么？ GitHub降价风格？这个工作有一个shell脚本吗？

Answer 1

你可能想看看Pandoc;它了解Markdown的几种风格。

pandoc -f markdown -t markdown_github foobar.md

几年前在Perl编写了一个标记转换器，如果没有合适的词法分析器，我不希望接近这样的任务，这有​​点超出shell脚本。

Answer 2

我编写了一个名为tidy-markdown的工具，它将根据this styleguide重新格式化任何Markdown（包括GFM）。

$ tidy-markdown < ./ugly-markdown.md > ./clean-markdown.md

它处理内联HTML到Markdown的转换，语法元素的规范化，如代码块（将它们转换为fenced），列表，块引用，前端内容，标题，甚至会尝试标准化代码块语言标识符。