リスト

言語、ツール、それらを束ねた組み合わせを示し、以降は組み合わせの良しあしなどを書く。

言語

Markdown
LaTeX
Typst

ツール

Pandoc
Word
pLaTeX, UpLaTeX, LuaTeX, XeTeX, pdftex

それらの組み合わせ

LaTeX + Compiler
Markdown + LaTeX + Pandoc
Markdown + VScodeの拡張機能: Markdown PDF
Typst

Markdown + LaTeX + Pandoc

本文はMarkdownで書いて、Pandocの内部でtexファイルに変換、最終的にPDFとして出力する方法。

---
title: いい感じのタイトル
author: Qiita太郎
---

## ヘッダー

オイラーの公式はインラインで書くと $\exp{i\theta} = \cos{\theta} + i \sin{\theta}$ であり、ブロックで書くと

$$
\exp{i\theta} = \cos{\theta} + i \sin{\theta}
$$

このように書いて、

$ pandoc --pdf-engine=lualatex -V documentclass=ltjsarticle -o output.pdf main.pdf

と実行すれば、以下のようなpdfが手に入る。

下記のような簡単なMakefileを用意するだけでmakeコマンドで全部pdfを生成できて便利。

MD=$(shell ls **/*.md)
PDF=$(MD:.md=.pdf)

all: $(PDF)

%.pdf: %.md
	pandoc --pdf-engine=lualatex -V documentclass=ltjsarticle -o $@ $<

clean:
	rm **/*.pdf

この方法は、Markdownで気楽に書けるのが大変よい。一方で少しだけレイアウトや見た目を変更したいというだけでも、専用のpandocのfilterを作成したりしないといけなかったりして、地獄を見る。レポートのレイアウトや見た目にそこまでシビアではない課題をこなすときに重宝する。

pdfへの変換にはLaTeXのツールセットに依存しているため、ローカルにTexの環境を用意してあげないといけないのが面倒。

LaTeX + Compiler

見た目やレイアウトに要件がある場合には、そのままLaTeXを使うのがよさげ。

日本語を使わなくていいなら、pdftexがコマンド一発でbibliographyまで処理してくれるので楽。日本語を使わないといけないなら、LuaLaTeXがコマンド一発で同じくbibliographyまで処理してくれるので楽。

慣れていないと不必要なpackageを\usepackageしてビルドが通らなかったり、不親切なエラーメッセージに悩ませられたりする。

Typst

Typstはおそらく最近でてきた、レポートなどが書けるツール。

CLIを実行すると専用GUIエディターが起動する。
Rustで書かれていて、シングルバイナリ(!!!!!!)

Rustの文字列はUTF-8だからか、特に設定しなくても日本語の入出力に対応している。

ドキュメントがすっきりまとまっているので、今から「レポートを書くためにWordから別のものに乗り換えたい」という人にはおすすめしようかなと考えている。

Word

嫌われがちだけど、機能を適切に使いこなせば大変優秀なツール。Gitとの親和性は最悪なので、データ解析やグラフのプロットと同じリポジトリで論文を書くというスタイルは難しい。Word本体の機能に共同編集、同時編集の機能があるようなので、そういった機能を利用したほうがよさそう。