mirror of
https://github.com/LCTT/TranslateProject.git
synced 2024-12-26 21:30:55 +08:00
147 lines
6.6 KiB
Markdown
147 lines
6.6 KiB
Markdown
[#]: subject: "Converting Multiple Markdown Files into HTML or Other Formats in Linux"
|
||
[#]: via: "https://itsfoss.com/convert-markdown-files/"
|
||
[#]: author: "Bill Dyer https://itsfoss.com/author/bill/"
|
||
[#]: collector: "lujun9972"
|
||
[#]: translator: "lxbwolf"
|
||
[#]: reviewer: "wxy"
|
||
[#]: publisher: "wxy"
|
||
[#]: url: "https://linux.cn/article-13274-1.html"
|
||
|
||
在 Linux 中把多个 Markdown 文件转换成 HTML 或其他格式
|
||
======
|
||
|
||
|
||
|
||
很多时候我与 Markdown 打交道的方式是，先写完一个文件，然后把它转换成 HTML 或其他格式。也有些时候，需要创建一些新的文件。当我要写多个 Markdown 文件时，通常要把他们全部写完之后才转换它们。
|
||
|
||
我用 `pandoc` 来转换文件，它可以一次性地转换所有 Markdown 文件。
|
||
|
||
Markdown 格式的文件可以转换成 .html 文件，有时候我需要把它转换成其他格式，如 epub，这个时候 [pandoc][1] 就派上了用场。我更喜欢用命令行，因此本文我会首先介绍它，然而你还可以使用 [VSCodium][2] 在非命令行下完成转换。后面我也会介绍它。
|
||
|
||
### 使用 pandoc 把多个 Markdown 文件转换成其他格式（命令行方式）
|
||
|
||
你可以在 Ubuntu 及其他 Debian 系发行版本终端输入下面的命令来快速开始：
|
||
|
||
```
|
||
sudo apt-get install pandoc
|
||
```
|
||
|
||
本例中，在名为 `md_test` 目录下我有四个 Markdown 文件需要转换。
|
||
|
||
```
|
||
[email protected]:~/Documents/md_test$ ls -l *.md
|
||
-rw-r--r-- 1 bdyer bdyer 3374 Apr 7 2020 file01.md
|
||
-rw-r--r-- 1 bdyer bdyer 782 Apr 2 05:23 file02.md
|
||
-rw-r--r-- 1 bdyer bdyer 9257 Apr 2 05:21 file03.md
|
||
-rw-r--r-- 1 bdyer bdyer 9442 Apr 2 05:21 file04.md
|
||
[email protected]:~/Documents/md_test$
|
||
```
|
||
|
||
现在还没有 HTML 文件。现在我要对这些文件使用 `pandoc`。我会运行一行命令来实现：
|
||
|
||
* 调用 `pandoc`
|
||
* 读取 .md 文件并导出为 .html
|
||
|
||
下面是我要运行的命令：
|
||
|
||
```
|
||
for i in *.md ; do echo "$i" && pandoc -s $i -o $i.html ; done
|
||
```
|
||
|
||
如果你不太理解上面的命令中的 `;`，可以参考 [在 Linux 中一次执行多个命令][3]。
|
||
|
||
我执行命令后，运行结果如下：
|
||
|
||
```
|
||
[email protected]:~/Documents/md_test$ for i in *.md ; do echo "$i" && pandoc -s $i -o $i.html ; done
|
||
file01.md
|
||
file02.md
|
||
file03.md
|
||
file04.md
|
||
[email protected]:~/Documents/md_test$
|
||
```
|
||
|
||
让我再使用一次 `ls` 命令来看看是否已经生成了 HTML 文件:
|
||
|
||
```
|
||
[email protected]:~/Documents/md_test$ ls -l *.html
|
||
-rw-r--r-- 1 bdyer bdyer 4291 Apr 2 06:08 file01.md.html
|
||
-rw-r--r-- 1 bdyer bdyer 1781 Apr 2 06:08 file02.md.html
|
||
-rw-r--r-- 1 bdyer bdyer 10272 Apr 2 06:08 file03.md.html
|
||
-rw-r--r-- 1 bdyer bdyer 10502 Apr 2 06:08 file04.md.html
|
||
[email protected]:~/Documents/md_test$
|
||
```
|
||
|
||
转换很成功，现在你已经有了四个 HTML 文件，它们可以用在 Web 服务器上。
|
||
|
||
pandoc 功能相当多，你可以通过指定输出文件的扩展名来把 Markdown 文件转换成其他支持的格式。不难理解它为什么会被认为是[最好的写作开源工具][4]。
|
||
|
||
### 使用 VSCodium 把 Markdown 文件转换成 HTML（GUI 方式）
|
||
|
||
就像我们前面说的那样，我通常使用命令行，但是对于批量转换，我不会使用命令行，你也不必。VSCode 或 [VSCodium][7] 可以完成批量操作。你只需要安装一个 Markdown-All-in-One 扩展，就可以在一次运行中转换多个 Markdown 文件。
|
||
|
||
有两种方式安装这个扩展：
|
||
|
||
* VSCodium 的终端
|
||
* VSCodium 的插件管理器
|
||
|
||
通过 VSCodium 的终端安装该扩展：
|
||
|
||
1. 点击菜单栏的 `终端`。会打开终端面板
|
||
2. 输入，或[复制下面的命令并粘贴到终端][8]：
|
||
|
||
```
|
||
codium --install-extension yzhang.markdown-all-in-one
|
||
```
|
||
|
||
**注意**：如果你使用的 VSCode 而不是 VSCodium，那么请把上面命令中的 `codium` 替换为 `code`
|
||
|
||
![][9]
|
||
|
||
第二种安装方式是通过 VSCodium 的插件/扩展管理器：
|
||
|
||
1. 点击 VSCodium 窗口左侧的块区域。会出现一个扩展列表，列表最上面有一个搜索框。
|
||
2. 在搜索框中输入 “Markdown All in One”。在列表最上面会出现该扩展。点击 “安装” 按钮来安装它。如果你已经安装过，在安装按钮的位置会出现一个齿轮图标。
|
||
|
||
![][10]
|
||
|
||
安装完成后，你可以打开含有需要转换的 Markdown 文件的文件夹。
|
||
|
||
点击 VSCodium 窗口左侧的纸张图标。你可以选择文件夹。打开文件夹后，你需要打开至少一个文件。你也可以打开多个文件，但是最少打开一个。
|
||
|
||
当打开文件后，按下 `CTRL+SHIFT+P` 唤起命令面板。然后，在出现的搜索框中输入 `Markdown`。当你输入时，会出现一列 Markdown 相关的命令。其中有一个是 `Markdown All in One: Print documents to HTML` 命令。点击它：
|
||
|
||
![][11]
|
||
|
||
你需要选择一个文件夹来存放这些文件。它会自动创建一个 `out` 目录，转换后的 HTML 文件会存放在 `out` 目录下。从下面的图中可以看到，Markdown 文档被转换成了 HTML 文件。在这里，你可以打开、查看、编辑这些 HTML 文件。
|
||
|
||
![][12]
|
||
|
||
在等待转换 Markdown 文件时，你可以更多地集中精力在写作上。当你准备好时，你就可以把它们转换成 HTML —— 你可以通过两种方式转换它们。
|
||
|
||
--------------------------------------------------------------------------------
|
||
|
||
via: https://itsfoss.com/convert-markdown-files/
|
||
|
||
作者：[Bill Dyer][a]
|
||
选题：[lujun9972][b]
|
||
译者：[lxbwolf](https://github.com/lxbwolf)
|
||
校对：[wxy](https://github.com/wxy)
|
||
|
||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||
|
||
[a]: https://itsfoss.com/author/bill/
|
||
[b]: https://github.com/lujun9972
|
||
[1]: https://pandoc.org/
|
||
[2]: https://vscodium.com/
|
||
[3]: https://itsfoss.com/run-multiple-commands-linux/
|
||
[4]: https://itsfoss.com/open-source-tools-writers/
|
||
[5]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2016/10/Best-Markdown-Editors-for-Linux.jpg?fit=800%2C450&ssl=1
|
||
[6]: https://itsfoss.com/best-markdown-editors-linux/
|
||
[7]: https://itsfoss.com/vscodium/
|
||
[8]: https://itsfoss.com/copy-paste-linux-terminal/
|
||
[9]: https://i0.wp.com/itsfoss.com/wp-content/uploads/2021/04/vscodium_terminal.jpg?resize=800%2C564&ssl=1
|
||
[10]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/vscodium_extension_select.jpg?resize=800%2C564&ssl=1
|
||
[11]: https://i1.wp.com/itsfoss.com/wp-content/uploads/2021/04/vscodium_markdown_function_options.jpg?resize=800%2C564&ssl=1
|
||
[12]: https://i0.wp.com/itsfoss.com/wp-content/uploads/2021/04/vscodium_html_filelist_shown.jpg?resize=800%2C564&ssl=1
|