【技術書著者必見】Word地獄からの脱却！Markdownで電子書籍・紙を同時生成する「Quarto」最適ワークフロー

quarto install tinytex

quarto install tinytex

git clone https://github.com/b-rodrigues/kdp_quarto
cd kdp_quarto
quarto render  # 初期ビルド確認

git clone https://github.com/b-rodrigues/kdp_quarto
cd kdp_quarto
quarto render  # 初期ビルド確認

chapters:
  - index.qmd # ここは固定
  - chapters/chapter_01.qmd # 以降はフォルダを切って配置してもOK

chapters:
  - index.qmd # ここは固定
  - chapters/chapter_01.qmd # 以降はフォルダを切って配置してもOK

format:
  pdf:
    pdf-engine: lualatex
    documentclass: bxjsbook
    classoption: [lualatex, ja=standard, 10pt, openany]
    pagestyle: headings
    number-sections: true  # 見出しに番号を付ける
    number-depth: 2  # subsectionまで見出し番号を付ける
    include-in-header:
      - file: _preamble_book.tex  # プリアンブルの設定
    toc: true  # 目次を生成
    toc-depth: 2  # 目次の深さ（sectionまで）
    toc-title: 目次  # 目次のタイトル
    highlight-style: tango  # コードブロックのシンタックスハイライトのスタイル
    # keep-tex: true  # デバッグ用に.texファイルを残す
  epub:
    toc:
      true
    lang:
      ja
    date:
      today
    css:
      epub.css
  html:
    theme:
      light: flatly
      dark: solar
    css:
      epub.css

format:
  pdf:
    pdf-engine: lualatex
    documentclass: bxjsbook
    classoption: [lualatex, ja=standard, 10pt, openany]
    pagestyle: headings
    number-sections: true  # 見出しに番号を付ける
    number-depth: 2  # subsectionまで見出し番号を付ける
    include-in-header:
      - file: _preamble_book.tex  # プリアンブルの設定
    toc: true  # 目次を生成
    toc-depth: 2  # 目次の深さ（sectionまで）
    toc-title: 目次  # 目次のタイトル
    highlight-style: tango  # コードブロックのシンタックスハイライトのスタイル
    # keep-tex: true  # デバッグ用に.texファイルを残す
  epub:
    toc:
      true
    lang:
      ja
    date:
      today
    css:
      epub.css
  html:
    theme:
      light: flatly
      dark: solar
    css:
      epub.css

% Packages

\usepackage{array} % tabular環境を拡張、セルの幅を設定できる
\usepackage{multirow} % 表のセルを縦方向に結合
\usepackage{siunitx} % 数字と単位の書式設定
\sisetup{mode = match}  % モード（数式／本文）に合わせて、数字や単位の書式を切替
\usepackage[dvipsnames]{xcolor}  % 色の設定
\usepackage{here}  % {fig-pos="H"}で図をソースコードの位置に強制的に配置
\usepackage{pdfpages}  % 外部で作成したPDF（図面、別章、付録など）をそのまま挿入
\usepackage[hidelinks]{hyperref}  % PDFにハイパーリンク機能を追加
\usepackage{appendix}  % 付録の章番号を設定
\usepackage{quotchap} % 章見出しのデザインを変更

% Font

\usepackage[no-math]{fontspec}  % LuaLaTeXでOpenType/TrueTypeフォントを直接指定する、数式フォントの設定は無効化
\usepackage{amsmath,amssymb}  % 数式で\align環境などを使えるようにする、追加の数学記号を使えるようにする
\usepackage[noto-jp,deluxe,expert,bold]{luatexja-preset}  % 日本語フォントにプリセットを使う
\ltjsetparameter{ jacharrange = {-2} }  % リテラルなギリシャ文字を欧文扱いする（ギリシャ文字に欧文フォントをそのまま使う）
\setmainfont[Ligatures=TeX]{Noto Serif}  % 英数字メインフォントを設定
\setsansfont[Ligatures=TeX]{Noto Sans}  % 英数字サンセリフフォントを設定
\setmainjfont{Noto Serif JP}  % 日本語メインフォントを設定
\setsansjfont{Noto Sans JP}  % 日本語サンセリフフォントを設定
\setmathfont[Scale=1.0]{texgyrepagella-math.otf}  % 数式用フォントを設定
\setmonofont{PlemolJP}  % 英数字等角フォントを設定
\setmonojfont{PlemolJP}  % 日本語等角フォントを設定

% geometryはここで一度だけ指定する
\makeatletter
\@ifpackageloaded{geometry}{
  % geometryが既に読み込まれている場合はオプションを上書き設定
  \geometry{
    paperwidth=155.2mm, % 152 + 裁ち落とし
    paperheight=224.4mm,  % 218 + 裁ち落とし
    % paperwidth=210mm,  % A4サイズ
    % paperheight=297mm,  % A4サイズ
    top=14mm,
    bottom=14mm,
    inner=12mm,
    outer=12mm
  }
}{
  % 未読み込みならここで一度だけ読み込む
  \usepackage[
    paperwidth=155.2mm, % 152 + 裁ち落とし
    paperheight=224.4mm,  % 218 + 裁ち落とし
    % paperwidth=210mm,  % A4サイズ
    % paperheight=297mm,  % A4サイズ
    top=14mm, % 上余白
    bottom=14mm, % 下余白
    inner=12mm, % 内側の余白
    outer=12mm % 外側の余白
  ]{geometry}
}
\makeatother

\setpagelayout{hmargin=12mm} % 左右の余白を12mmに設定
\setlength{\textheight}{0.80\paperheight} % 本文部分の高さ
\addtolength\topmargin{-0.2in} % 上余白の微調整
\setlength{\headsep}{20pt} % ヘッダーと本文の間隔を20ptに設定

\usepackage{titlesec} % セクション見出しのフォーマットを変更するためのパッケージ
\usepackage{tikz} % LaTeXで図や図形を描くための描画パッケージ

% Title

\usepackage{titling}  % タイトルのフォーマットを変更するためのパッケージ
\makeatletter
\newcommand{\subtitle}[1]{\def\@subtitle{#1}}
\newcommand{\@subtitle}{}  % 初期値は空
\pretitle{\begin{center}\gt\sf\bfseries\huge}
\posttitle{
  \par\end{center}
  \ifx\@subtitle\@empty
  \else{
    \begin{center}\gt\sf\large\@subtitle\par\end{center}
  }
  \vskip 2em  % タイトルの後に空白を追加
}
\preauthor{\begin{center}\gt\sf\large}
\postauthor{\par\end{center}\vskip 1em}  % 著者の後に空白を追加
\predate{\begin{center}\gt\sf\large}
\postdate{\par\end{center}}
\makeatother

% description list

\usepackage{enumitem}
\setlist[description]{%
  font=\sffamily\bfseries,  % ラベルをサンセリフ体の太字に
  style=nextline,           % ラベルの後に改行
  leftmargin=1em            % 本文の左マージン
}

% inline code block
\definecolor{codebg}{RGB}{234,234,234}  % 明るいグレーの背景色
\let\oldtexttt\texttt
\renewcommand{\texttt}[1]{  % \textttの再定義
  \colorbox{codebg}{  % 背景色
    \textcolor{Maroon}{  % 文字色
      \small  % 文字サイズ
      \oldtexttt{#1}
    }
  }
}

% code block
\usepackage{fvextra}    % fancyvrbの拡張
\setlength{\fboxrule}{6pt}  % 枠の太さを太くする
\fvset{
  bgcolor = codebg,
  frame = single,
  framesep = 0pt,        % 枠と内容の間の余白
  rulecolor = \color{codebg},
  fontsize = \footnotesize,
  breaklines = true,
  breakanywhere = true,  % 単語の途中でも改行する
  commandchars = \\\{\},  % Pandocの構文ハイライトマクロに必要
}
\usepackage{framed} % <- Shaded は framed の shaded/snugshade を使う
\definecolor{shadecolor}{RGB}{255,255,255} % 外枠の Shaded を白に

% Headings

% --- Chapter ---
\titleformat
{\chapter} % command
[display] % shape
{\color{NavyBlue}\gt\sf\bfseries} % format
{%
\titlerule[3pt]%
\huge 第\thechapter 章%
} % label
{-10pt} % sep
{\huge} % before-code
[{\titlerule[3pt]}] % after-code

\titlespacing*{\chapter}{0pt}{0pt}{40pt}

% --- Section ---
\titleformat
{\section} % command
[block] % shape
{\color{NavyBlue}\gt\sf\bfseries\Large} % format
{
  \definecolor{teal}{gray}{0.30}
  \begin{picture}(-11,0)
    \put(-11,-5){
      \color{NavyBlue}
      \line(1,0){\hsize}
    }
  \end{picture}
  \Large%
  \hspace{-4pt}
  \thesection .
  \hspace{0pt}
} % label
{0pt} % sep
{} % before-code


% --- Section (.unnumbered) ---
\titleformat
{name=\section,numberless} % command
[block] % shape
{\color{NavyBlue}\gt\sf\bfseries\Large} % format
{} % label
{0pt} % sep
{
  \definecolor{teal}{gray}{0.30}
  \begin{picture}(-11,0)
    % \put(-10,-5){
    %   \begin{tikzpicture}
    %     \fill[teal] (0pt,0pt) rectangle (5pt,19pt);
    %   \end{tikzpicture}
    % }
    \put(-11,-5){
      \color{NavyBlue}
      \line(1,0){\hsize}
    }
  \end{picture}
} % before-code

% --- Subsection ---
\titleformat
{\subsection} % command
[block] % shape
{\color{NavyBlue}\gt\sf\bfseries\large} % format
{\thesubsection .} % label
{8pt} % sep
{} % before-code

% --- Subsubsection ---
\titleformat
{\subsubsection} % command
[block] % shape
{\color{NavyBlue}\gt\sf\bfseries} % format
{} % label
{} % sep
{} % before-code

% --- Paragraph ---
\titleformat
{\paragraph} % command
[runin] % shape
{\normalsize\gt\sf\bfseries} % format
{} % label
{} % sep
{} % befor-code
% スペーシングの調整
\titlespacing*{\paragraph}{0pt}{3.25ex plus 1ex minus .2ex}{1em}

% Packages

\usepackage{array} % tabular環境を拡張、セルの幅を設定できる
\usepackage{multirow} % 表のセルを縦方向に結合
\usepackage{siunitx} % 数字と単位の書式設定
\sisetup{mode = match}  % モード（数式／本文）に合わせて、数字や単位の書式を切替
\usepackage[dvipsnames]{xcolor}  % 色の設定
\usepackage{here}  % {fig-pos="H"}で図をソースコードの位置に強制的に配置
\usepackage{pdfpages}  % 外部で作成したPDF（図面、別章、付録など）をそのまま挿入
\usepackage[hidelinks]{hyperref}  % PDFにハイパーリンク機能を追加
\usepackage{appendix}  % 付録の章番号を設定
\usepackage{quotchap} % 章見出しのデザインを変更

% Font

\usepackage[no-math]{fontspec}  % LuaLaTeXでOpenType/TrueTypeフォントを直接指定する、数式フォントの設定は無効化
\usepackage{amsmath,amssymb}  % 数式で\align環境などを使えるようにする、追加の数学記号を使えるようにする
\usepackage[noto-jp,deluxe,expert,bold]{luatexja-preset}  % 日本語フォントにプリセットを使う
\ltjsetparameter{ jacharrange = {-2} }  % リテラルなギリシャ文字を欧文扱いする（ギリシャ文字に欧文フォントをそのまま使う）
\setmainfont[Ligatures=TeX]{Noto Serif}  % 英数字メインフォントを設定
\setsansfont[Ligatures=TeX]{Noto Sans}  % 英数字サンセリフフォントを設定
\setmainjfont{Noto Serif JP}  % 日本語メインフォントを設定
\setsansjfont{Noto Sans JP}  % 日本語サンセリフフォントを設定
\setmathfont[Scale=1.0]{texgyrepagella-math.otf}  % 数式用フォントを設定
\setmonofont{PlemolJP}  % 英数字等角フォントを設定
\setmonojfont{PlemolJP}  % 日本語等角フォントを設定

% geometryはここで一度だけ指定する
\makeatletter
\@ifpackageloaded{geometry}{
  % geometryが既に読み込まれている場合はオプションを上書き設定
  \geometry{
    paperwidth=155.2mm, % 152 + 裁ち落とし
    paperheight=224.4mm,  % 218 + 裁ち落とし
    % paperwidth=210mm,  % A4サイズ
    % paperheight=297mm,  % A4サイズ
    top=14mm,
    bottom=14mm,
    inner=12mm,
    outer=12mm
  }
}{
  % 未読み込みならここで一度だけ読み込む
  \usepackage[
    paperwidth=155.2mm, % 152 + 裁ち落とし
    paperheight=224.4mm,  % 218 + 裁ち落とし
    % paperwidth=210mm,  % A4サイズ
    % paperheight=297mm,  % A4サイズ
    top=14mm, % 上余白
    bottom=14mm, % 下余白
    inner=12mm, % 内側の余白
    outer=12mm % 外側の余白
  ]{geometry}
}
\makeatother

\setpagelayout{hmargin=12mm} % 左右の余白を12mmに設定
\setlength{\textheight}{0.80\paperheight} % 本文部分の高さ
\addtolength\topmargin{-0.2in} % 上余白の微調整
\setlength{\headsep}{20pt} % ヘッダーと本文の間隔を20ptに設定

\usepackage{titlesec} % セクション見出しのフォーマットを変更するためのパッケージ
\usepackage{tikz} % LaTeXで図や図形を描くための描画パッケージ

% Title

\usepackage{titling}  % タイトルのフォーマットを変更するためのパッケージ
\makeatletter
\newcommand{\subtitle}[1]{\def\@subtitle{#1}}
\newcommand{\@subtitle}{}  % 初期値は空
\pretitle{\begin{center}\gt\sf\bfseries\huge}
\posttitle{
  \par\end{center}
  \ifx\@subtitle\@empty
  \else{
    \begin{center}\gt\sf\large\@subtitle\par\end{center}
  }
  \vskip 2em  % タイトルの後に空白を追加
}
\preauthor{\begin{center}\gt\sf\large}
\postauthor{\par\end{center}\vskip 1em}  % 著者の後に空白を追加
\predate{\begin{center}\gt\sf\large}
\postdate{\par\end{center}}
\makeatother

% description list

\usepackage{enumitem}
\setlist[description]{%
  font=\sffamily\bfseries,  % ラベルをサンセリフ体の太字に
  style=nextline,           % ラベルの後に改行
  leftmargin=1em            % 本文の左マージン
}

% inline code block
\definecolor{codebg}{RGB}{234,234,234}  % 明るいグレーの背景色
\let\oldtexttt\texttt
\renewcommand{\texttt}[1]{  % \textttの再定義
  \colorbox{codebg}{  % 背景色
    \textcolor{Maroon}{  % 文字色
      \small  % 文字サイズ
      \oldtexttt{#1}
    }
  }
}

% code block
\usepackage{fvextra}    % fancyvrbの拡張
\setlength{\fboxrule}{6pt}  % 枠の太さを太くする
\fvset{
  bgcolor = codebg,
  frame = single,
  framesep = 0pt,        % 枠と内容の間の余白
  rulecolor = \color{codebg},
  fontsize = \footnotesize,
  breaklines = true,
  breakanywhere = true,  % 単語の途中でも改行する
  commandchars = \\\{\},  % Pandocの構文ハイライトマクロに必要
}
\usepackage{framed} % <- Shaded は framed の shaded/snugshade を使う
\definecolor{shadecolor}{RGB}{255,255,255} % 外枠の Shaded を白に

% Headings

% --- Chapter ---
\titleformat
{\chapter} % command
[display] % shape
{\color{NavyBlue}\gt\sf\bfseries} % format
{%
\titlerule[3pt]%
\huge 第\thechapter 章%
} % label
{-10pt} % sep
{\huge} % before-code
[{\titlerule[3pt]}] % after-code

\titlespacing*{\chapter}{0pt}{0pt}{40pt}

% --- Section ---
\titleformat
{\section} % command
[block] % shape
{\color{NavyBlue}\gt\sf\bfseries\Large} % format
{
  \definecolor{teal}{gray}{0.30}
  \begin{picture}(-11,0)
    \put(-11,-5){
      \color{NavyBlue}
      \line(1,0){\hsize}
    }
  \end{picture}
  \Large%
  \hspace{-4pt}
  \thesection .
  \hspace{0pt}
} % label
{0pt} % sep
{} % before-code


% --- Section (.unnumbered) ---
\titleformat
{name=\section,numberless} % command
[block] % shape
{\color{NavyBlue}\gt\sf\bfseries\Large} % format
{} % label
{0pt} % sep
{
  \definecolor{teal}{gray}{0.30}
  \begin{picture}(-11,0)
    % \put(-10,-5){
    %   \begin{tikzpicture}
    %     \fill[teal] (0pt,0pt) rectangle (5pt,19pt);
    %   \end{tikzpicture}
    % }
    \put(-11,-5){
      \color{NavyBlue}
      \line(1,0){\hsize}
    }
  \end{picture}
} % before-code

% --- Subsection ---
\titleformat
{\subsection} % command
[block] % shape
{\color{NavyBlue}\gt\sf\bfseries\large} % format
{\thesubsection .} % label
{8pt} % sep
{} % before-code

% --- Subsubsection ---
\titleformat
{\subsubsection} % command
[block] % shape
{\color{NavyBlue}\gt\sf\bfseries} % format
{} % label
{} % sep
{} % before-code

% --- Paragraph ---
\titleformat
{\paragraph} % command
[runin] % shape
{\normalsize\gt\sf\bfseries} % format
{} % label
{} % sep
{} % befor-code
% スペーシングの調整
\titlespacing*{\paragraph}{0pt}{3.25ex plus 1ex minus .2ex}{1em}

@book{kaneda_hajimete_android_2020,
  author    = {金田浩明},
  title     = {はじめてのAndroidプログラミング 第5版},
  year      = {2020},
  publisher = {SBクリエイティブ},
  address   = {東京},
  isbn      = {978-4-8156-0796-8},
  note      = {日本語},
  url       = {https://www.amazon.co.jp/dp/4815607966},
  urldate   = {2025-11-16}
}

@book{kaneda_hajimete_android_2020,
  author    = {金田浩明},
  title     = {はじめてのAndroidプログラミング 第5版},
  year      = {2020},
  publisher = {SBクリエイティブ},
  address   = {東京},
  isbn      = {978-4-8156-0796-8},
  note      = {日本語},
  url       = {https://www.amazon.co.jp/dp/4815607966},
  urldate   = {2025-11-16}
}

Android入門としては「はじめてのAndroid入門」, @kaneda_hajimete_android_2020 が参考になる

Android入門としては「はじめてのAndroid入門」, @kaneda_hajimete_android_2020 が参考になる

::: {layout="[0.5, 0.5]"}
::: {#firstcol}
Fist column content.
:::

::: {#secondcol}
Second column content.
:::
:::

::: {layout="[0.5, 0.5]"}
::: {#firstcol}
Fist column content.
:::

::: {#secondcol}
Second column content.
:::
:::

crossref:
  custom:
    - kind: float
      reference-prefix: "コード"
      caption-location: top
      key: code
      latex-env: lstlisting

crossref:
  custom:
    - kind: float
      reference-prefix: "コード"
      caption-location: top
      key: code
      latex-env: lstlisting

::: {#code-define-variable layout="[0.5, 0.5]"}
::: {#firstcol}
```kotlin
var a: Int = 100
```
:::

::: {#secondcol}
```markdown
a: 100
```
:::
型を明示する“aaaaaaあ」あああああああああ”
:::

::: {#code-define-variable layout="[0.5, 0.5]"}
::: {#firstcol}
```kotlin
var a: Int = 100
```
:::

::: {#secondcol}
```markdown
a: 100
```
:::
型を明示する“aaaaaaあ」あああああああああ”
:::

quarto render

quarto render

function Span(el)
  if el.classes:includes("enji") then
    if FORMAT:match "html" then
      return pandoc.RawInline("html", '<span style="color: #B22652;">' .. 
             pandoc.utils.stringify(el.content) .. '</span>')
    elseif FORMAT:match("latex") then
      -- LaTeX 出力用：プリアンブルで \enjiText を定義している想定
      return pandoc.RawInline("latex", '\\enjiText{' .. pandoc.utils.stringify(el.content) .. '}')             
    elseif FORMAT:match "epub" then
      return pandoc.RawInline("html", '<span style="color: #B22652;">' .. 
             pandoc.utils.stringify(el.content) .. '</span>')
    end
  end
  return el
end

function Span(el)
  if el.classes:includes("enji") then
    if FORMAT:match "html" then
      return pandoc.RawInline("html", '<span style="color: #B22652;">' .. 
             pandoc.utils.stringify(el.content) .. '</span>')
    elseif FORMAT:match("latex") then
      -- LaTeX 出力用：プリアンブルで \enjiText を定義している想定
      return pandoc.RawInline("latex", '\\enjiText{' .. pandoc.utils.stringify(el.content) .. '}')             
    elseif FORMAT:match "epub" then
      return pandoc.RawInline("html", '<span style="color: #B22652;">' .. 
             pandoc.utils.stringify(el.content) .. '</span>')
    end
  end
  return el
end

{
	"enji": {
		"scope": "Markdown,Quarto",
		"prefix": "enji",
		"body": [
			"console.log('$TM_SELECTED_TEXT');"
		],
		"description": "Add enji class to the previous line"
	}
}

{
	"enji": {
		"scope": "Markdown,Quarto",
		"prefix": "enji",
		"body": [
			"console.log('$TM_SELECTED_TEXT');"
		],
		"description": "Add enji class to the previous line"
	}
}