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

Reformat Markdown files to a specific code style

我正在写一本书,有几个人在编写和编辑文本。一切都是降价。不幸的是,混合了不同的样式和线宽。从技术上讲这不是问题,但在美学方面并不好。

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

您可能想看看 Pandoc;它理解多种 Markdown 风格。

pandoc -f markdown -t gfm foobar.md

几年前用 Perl 编写了一个标记转换器,如果没有像样的词法分析器,我不想完成这样的任务,这有​​点超出 shell 脚本。

我写了一个工具叫 tidy-markdown that will reformat any Markdown (including GFM) according to this styleguide

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

它处理内联 HTML 到 Markdown 的转换、代码块等语法元素的规范化(将它们转换为围栏)、列表、block-quotes、front-matter、headers,甚至会尝试标准化 code-block 语言标识符。