Tan Shuai
Change language: 繁體中文

在 macOS 上快速將 Markdown 轉換為學術風格的 PDF 文件

軟體開發

在本指南中，我將向你介紹如何在 macOS 上使用 Pandoc 和 BasicTeX 將 Markdown 文件轉換為學術風格的 PDF 文件。這種方法快捷簡單，非常適合當你需要為學術論文創建專業外觀的 PDF 文件時使用。

步驟 1：安裝 Pandoc 和 BasicTeX

首先，你需要在 macOS 系統上安裝 Pandoc 和 BasicTeX。以下是我如何操作的：

  1. 安裝 Pandoc：打開終端，輸入以下命令來安裝 Pandoc：

    brew install pandoc

  2. 安裝 BasicTeX：由於 MacTeX 相當大，我選擇了較小的 BasicTeX 包來節省空間。運行此命令：

    brew install --cask basictex

  3. 安裝常用的 LaTeX 包：為了確保你擁有生成 PDF 所需的必要包，運行以下命令：

    sudo tlmgr update --self
sudo tlmgr install collection-basic collection-latex collection-latexrecommended collection-fontsrecommended

步驟 2：準備你的 Markdown 文件

接下來，創建你的 Markdown 文件（例如 paper.md）。以下是我設置文件的方式，包括標題、作者、日期和聯繫信息：

---
title: "Your Paper Title"
subtitle: "Optional Subtitle"
date: \today

author: |
  | Your Name
  | your-email@tanshuai.com
  | www.tanshuai.com
---

# Abstract

Your abstract here.

# Introduction

Your introduction here.

# Methodology

Your methodology here.

# Results

Your results here.

# Conclusion

Your conclusion here.

步驟 3：使用 Pandoc 將 Markdown 轉換為 PDF

現在，你可以將你的 Markdown 文件轉換為 PDF。我在終端中使用了以下命令：

pandoc paper.md -o paper.pdf --pdf-engine=xelatex

此命令使用 Pandoc 的默認 LaTeX 模板將 Markdown 文件轉換為學術風格的 PDF 文件，包括在作者姓名下方添加聯繫信息。

附加提示

  • 自訂 LaTeX 模板：如果你需要更高級的格式或特定風格，可以創建或下載自訂的 LaTeX 模板並與 Pandoc 一起使用：

    pandoc paper.md -o paper.pdf --pdf-engine=xelatex --template=your-template.tex

  • 更多元數據：你可以在 YAML 元數據標頭中添加額外的信息，例如摘要或關鍵詞，並在自訂模板中使用這些信息。

結論

通過遵循這些步驟，你可以輕鬆地在 macOS 上將 Markdown 文件轉換為學術風格的 PDF 文件。使用 Pandoc 和 BasicTeX 使這一過程快速高效，非常適合當你需要生成專業的 PDF 文件時。無論你是在準備學術論文、技術報告還是其他正式文件，這種方法都非常有效。將聯繫信息包含在元數據標頭中，為你的文件增添了專業氣息。

希望這份指南對你有所幫助！如果你有任何問題或遇到困難，隨時可以聯繫我們。祝寫作愉快！