您可以在Linux上使用pandoc在40多種檔案格式之間進行轉換。您還可以使用它建立一個簡單的文件作為程式碼系統，方法是使用Markdown編寫文件，使用git儲存文件，並以其支援的任何格式釋出文件。

文件轉換和文件作為程式碼

如果你有一個檔案在潘多克的許多支援的檔案格式中的任何一種，將它轉換成其他任何一種都是輕而易舉的。這是一個方便的工具！

但是當你把它作為一個簡單的docs-as程式碼系統的基礎時，pandoc的真正威力就變得顯而易見了。文件作為程式碼的前提是採用軟體開發的一些技術和原則，並將它們應用於編寫文件，特別是軟體開發專案。不過，您可以將其應用於任何型別文件的開發。

軟體開發人員使用他們喜歡的編輯器或整合開發環境（IDE）來編寫他們的程式。他們鍵入的程式碼儲存在文字檔案中。這些包含程式的原始碼。

他們使用版本控制系統，或者VCS（Git是最流行的），來捕獲原始碼在開發和增強時的變化。這意味著程式設計師擁有原始碼檔案所有版本的完整歷史記錄。他或她可以快速訪問任何以前版本的檔案。Git將檔案儲存在儲存庫中。每個開發人員的計算機上都有一個本地儲存庫和一箇中央的、共享的、遠端的儲存庫，這些儲存庫通常是雲託管的。

當他們準備生成程式的工作版本時，他們使用編譯器讀取原始碼並生成二進位制可執行檔案。

透過使用輕量級的、基於文字的標記語言編寫文件，您可以使用VCS來控制您的編寫。當您準備分發或釋出文件時，可以使用pandoc生成所需的任意多個不同版本的文件，包括基於web（HTML）、文書處理或排版（LibreOffice、Microsoft word、TeX）、可移植文件格式（PDF）、電子書（ePub）等。

您可以從一組版本控制的輕量級文字檔案中執行所有這些操作。

安裝pandoc

要在Ubuntu上安裝pandoc，請使用以下命令：

在Fedora上，您需要的命令如下：

在Manjaro上，您需要鍵入：

您可以使用--version選項檢查已安裝的版本：

使用不帶檔案的pandoc

如果不使用任何命令列選項而使用pandoc，它也接受鍵入的輸入。只需按Ctrl+D就可以表示您已經完成了輸入。pandoc希望您輸入降價格式，並生成HTML輸出。

讓我們看一個例子：

我們已經鍵入了幾行降價，即將按Ctrl+D。

一旦我們這樣做，pandoc就會生成等價的HTML輸出。

不過，要對pandoc做任何有用的事情，我們確實需要使用檔案。

減價基礎

Markdown是一種輕量級標記語言，它賦予某些字元特殊的含義。可以使用純文字編輯器建立標記檔案。

標記可以很容易地閱讀，因為沒有視覺上麻煩的標籤來分散文字的注意力。降價文件中的格式類似於它所表示的格式。以下是一些基礎知識：

• 要用斜體強調文字，請用星號將其括起來。*我們將強調這一點*
• 若要加粗文字，請使用兩個星號。**這將以粗體顯示**
• 標題由數字符號/雜湊標記（#）表示。文字與雜湊值之間用空格隔開。使用一個雜湊值作為頂級標題，兩個雜湊值作為第二級標題，依此類推。
• 要建立帶專案符號的列表，請在列表的每一行開頭加一個星號，並在文字前**空格。
• 要建立帶編號的列表，請在每行的開頭加上一個數字和一個句點，然後在文字前**空格。
• 要建立超連結，請將站點名稱括在方括號（[]）中，並將URL括在圓括號[（）]中，如下所示：[Link To How To Geek](https://www.tl80.cn/).
• 要**影象，請在括號（！[]). 為括號中的影象鍵入任何可選文字。然後，將指向影象的路徑括在括號[（）“]中。舉個例子：！[極客](HTG.png格式).

我們將在下一節中介紹更多的例子。

相關報道：什麼是降價？你如何使用它？

轉換檔案

檔案轉換非常簡單。pandoc通常可以從檔名中找出您正在使用的檔案格式。在這裡，我們將從一個降價檔案生成一個HTML檔案。-o（output）選項告訴pandoc我們要建立的檔案的名稱：

我們的降價檔案樣本，示例.md，包含下圖所示的標記的簡短部分。

一個名為示例.html已建立。當我們雙擊檔案時，我們的預設瀏覽器將開啟它。

現在，讓我們生成一個可在LibreOffice Writer中開啟的文件格式文字文件：

ODT檔案的內容與HTML檔案相同。

整潔的觸控是影象的替代文字，也用於自動生成圖形的標題。

指定檔案格式

-f（from）和-t（to）選項用於告訴pandoc要從哪些檔案格式轉換為哪些檔案格式。如果您使用的是與其他相關格式共享副檔名的檔案格式，這將非常有用。例如，TeX和LaTeX都使用“.TeX”副檔名。

我們還使用了-s（獨立）選項，這樣pandoc將生成一個完整的、自包含的、格式良好的LaTeX文件所需的所有LaTeX序言。如果沒有-s（standalone）選項，輸出仍然是格式良好的LaTeX，可以**到另一個LaTeX文件中，因此無法作為獨立的LaTeX文件進行正確的解析。

我們鍵入以下內容：

如果你開啟示例.tex“在文字編輯器中，您將看到生成的乳膠。如果您有一個LaTeX編輯器，您可以開啟TEX檔案來檢視如何解釋LaTeX排版命令的預覽。縮小視窗以適應下面的影象使顯示器看起來很侷促，但實際上，它很好。

我們用了一個叫做Texmaker的乳膠編輯器。如果要在Ubuntu中安裝，請鍵入以下內容：

在Fedora中，命令是：

在Manjaro，使用：

使用模板轉換檔案

你可能已經開始瞭解潘多克提供的靈活性了。您可以編寫一次，並以幾乎任何格式釋出。這是一個偉大的壯舉，但檔案看起來確實有點香草。

透過模板，您可以指定pandoc生成文件時使用的樣式。例如，您可以告訴pandoc使用級聯樣式表（CSS）檔案中定義的樣式和--CSS選項。

我們建立了一個包含以下文字的小CSS檔案。它將更改一種樣式的級別標題上方和下方的間距。它還會將文字顏色更改為白色，將背景顏色更改為藍色：

完整命令如下所示。請注意，我們還使用了獨立選項（-s）：

pandoc使用了我們的簡約CSS檔案中的單一樣式，並將其應用於一級標頭檔案。

在處理HTML檔案時，另一個可用的微調選項是在標記檔案中包含HTML標記。這將作為標準HTML標記傳遞到生成的HTML檔案。

不過，當您只生成HTML輸出時，應該保留此技術。如果您使用多種檔案格式，pandoc將忽略非HTML檔案的HTML標記，它將作為文字傳遞給這些檔案。

我們還可以指定生成ODT檔案時使用的樣式。開啟一個空白的libreofficewriter文件，調整標題和字型樣式以滿足您的需要。在我們的示例中，我們還添加了頁首和頁尾。將文件另存為“odt”-模板.odt.”

我們現在可以將其作為模板使用--reference doc選項：

將其與前面的ODT示例進行比較。此文件使用不同的字型，有彩色標題，包括頁首和頁尾。然而，它是由完全相同的示例.md“降價檔案。

參考文件模板可用於指示文件生產的不同階段。例如，您可能有帶有“草稿”或“供審閱”水印的模板。沒有水印的模板將用於定稿文件。

生成PDF

預設情況下，pandoc使用LaTeX PDF引擎生成PDF檔案。確保滿足適當的乳膠依賴關係的最簡單方法是安裝乳膠編輯器，例如Texmaker。

這是一個相當大的安裝，雖然得克薩斯和乳膠都相當大。如果你的硬碟空間有限，或者你知道你永遠不會使用TeX或LaTeX，你可能更喜歡生成一個ODT檔案。然後，您可以在libreofficewriter中開啟它並將其儲存為PDF。

作為程式碼的文件

使用Markdown作為寫作語言有以下幾個優點：

• 在純文字檔案中工作速度很快：它們的載入速度比同樣大小的字處理器檔案快，而且在文件中的移動速度也更快。許多編輯器，包括gedit、Vim和Emacs，都使用語法高亮和標記文字。
• 您將擁有文件所有版本的時間表：如果您將文件儲存在VCS（如Git）中，您可以很容易地看到同一檔案的任何兩個版本之間的差異。然而，只有當檔案是純文字時，這才真正起作用，因為VCS希望使用純文字。
• 風投可以記錄誰做了任何改變，以及什麼時候做的改變：如果你經常在大型專案上與他人合作，這尤其有用。它還為文件本身提供了一箇中央儲存庫。許多雲託管的Git服務，如GitHub、GitLab和BitBucket，在其定價模型中都有免費的層。
• 您可以以多種格式生成文件：只需幾個簡單的shell指令碼，就可以從CSS和引用文件中提取樣式。如果您將文件儲存在與持續整合和持續部署（CI/CD）平臺整合的VCS儲存庫中，則無論何時構建軟體，都可以自動生成這些文件。

相關：什麼是GitHub，它的用途是什麼？

最後的想法

潘多克有更多的選擇和功能，比我們在這裡所涵蓋的。大多數檔案型別的轉換過程都可以調整和微調。要了解更多資訊，請檢視pandoc官方網頁（非常詳細）上的優秀示例。