转换和重新格式化 Markdown #

Typora 没有内置的 markdown 转换、重新格式化或 lint 功能,但有一些变通方法。

转换为其他的 markdown 规格 #

你可以打开偏好设置,选择 "导出 "部分,然后根据 "Markdown(其他规格)"模板添加一个新的导出项目。

然后选择你想要的标记变体。

注意

在这个过程中,你的 markdown 文件将被翻译成一个内部数据模型(AST),然后由 pandoc 翻译成其他 markdown 规范,这意味着对话不是逐行进行的,一些不影响最终 markdown 表述的细节将不会被保留。

比如说:

[linke][typora] is a website

[typora]: http://www.typora.io

导出后可能成为以下内容:

[linke](http://www.typora.io) is a website

markdown输出的格式选项 #

以前的 markdown 导出选项还提供了行宽等设置,可以用来重新格式化你的 markdown 文件。一些设置包括

columns #

等于 pandoc 的 --columns=NUMBER 标志。你可以用它来设置硬换行,例如,如果硬换行被设置为文本列宽 80,那么

(line 1) Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

将成为

(line 1) Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor
(line 2) incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis
(line 3) nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

终端 #

等于 pandoc 的 --eol=crlf|lf|native。在 Unix 风格 ( \n) 或 Windows 风格 ( \r\n) 之间改变行尾。

缩进 #

等于 pandoc 的 --tab-stop=NUMBER。指定每个标签的空格数(默认为 4)。

只允许 ASCII 字符 #

等于 pandoc 的 --ascii。启用后,在输出中只使用 ASCII 字符,例如,你好 将被转换为 你好

其他选择 #

你也可以附加其他 pandoc 参数。

使用自定义命令重新格式化 #

你可以 make an export item with custom commands (opens new window) 。然后使用第三种工具,如 prettier (opens new window) 或其他工具来重新格式化你的代码。

prettier (opens new window) 为例。

首先,用 npm install -g prettier 安装它。然后通过 which prettier 获得其路径。

然后按照 https://prettier.io/docs/en/cli.html, 添加格式命令,例如:

prettier --single-quote --tab-width 4 --prose-wrap always --print-width 80 --write "${currentPath}"

在 Windows 上,它可能是这样的:

node "C:\Program Files\nodejs\node_modules\prettier\bin-prettier.js" --print-width 80 --prose-wrap always "${currentPath}"

然后你可以从菜单栏上的 "导出" → "重新格式化" 中 "格式化" 内容。


你也可以通过在 "导出后" 设置中添加 "运行命令" 来结合导出和格式化或皮特。