> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ja/xiang-xi-ji-shi/32-markdown-into-latex-with-style.md).

# スタイル付きMarkdownからLaTeXへ

**公開後の更新** (2017年5月13日): 私たちは、Vít Novotný、 `markdown` パッケージの著者/メンテナである彼から、元の記事に関する役立つフィードバックを送っていただいたことに感謝しています。彼の助言と提案を反映したこの更新版を公開できてうれしく思います。

### はじめに

少し前に、私たちは〜のリリースを喜びました [`markdownパッケージ`](http://www.ctan.org/pkg/markdown) これによりLaTeX文書内でmarkdown構文を書けるようになり、さらに「 [OverleafでMarkdownを書く方法](/latex/ja/xiang-xi-ji-shi/30-how-to-write-in-markdown-on-overleaf.md) その目的は、サポートされている構文のいくつかを示すことでした。

**覚えておいてください**：あなたの `.tex` ファイルを `--shell-escape` オプション付きでコンパイルする必要があります。そうしないとローカルのLaTeX環境では動作しません。Overleafではこれを自動的に行います。ほとんどの学術誌投稿ポータルでは `--shell-escape`—原稿の出力PDFだけをアップロードできる場合を除き、markdownを含むLaTeXファイルは、出版社の投稿システムで処理されたときに正常にコンパイルされない可能性があります。

前の記事で示唆されたアイデアの一つは [以前の記事](/latex/ja/xiang-xi-ji-shi/30-how-to-write-in-markdown-on-overleaf.md) です。markdownとLaTeXを組み合わせることで、内容とスタイルを見事に分離できるということです。著者（特にすでにmarkdownに慣れている人）は、いくつかの注意点はあるものの、ずっと簡潔な構文を使え、その一方でスタイルや書式設定はLaTeXパッケージやテンプレートのあらゆる利点に任せられます。そこで [以前の記事](/latex/ja/xiang-xi-ji-shi/30-how-to-write-in-markdown-on-overleaf.md) markdownを使った [Beamerプレゼンテーション](https://www.overleaf.com/read/dnrwnjrpjjhw) や [ポスター](https://www.overleaf.com/read/jtbgmmgqrqmh)：今日はさらに楽しくて刺激的なスタイルの可能性を見ていきます！

### スタイル付きLaTeXテンプレートでmarkdownを使う

上の例以外にも、ほとんどすべてのテンプレートでmarkdownを使えます。以下にいくつか簡単な例を示します。

* この [Legrangeのオレンジブック](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) テンプレート
* この [Tufte風の配布資料](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) テンプレート
* この [とても素敵な記事テンプレート](https://www.overleaf.com/read/xfsrpsmdtqvt) Thiagoによる

このうち2つが記事テンプレートで、1つが書籍テンプレートであることに気づくかもしれません。 [`markdownパッケージ`](http://www.ctan.org/pkg/markdown) は、 `\\chapter` コマンドが特定のLaTeX文書で利用可能かどうかを検出し、第1レベルの見出しを `markdown` 行にレンダリングして `\\chapter` または `\section` 適切にします。

### とても手早い配布資料: markdown + pocketmod

markdownを初めて知ったときから、これは素早く便利にメモを取る方法だと感じました。紙切れや付箋にメモを書きなぐるような感覚に近いからです。特に箇条書きや番号付きリストの構文がそうです。私が初めて [PocketModテンプレート](https://www.overleaf.com/read/nqbhpnrkskrx) を2015年に作ったとき、PocketModを作れるようにLaTeXでmarkdownを書ける方法を切望していました *と* markdownを使いたいと思ったのは、それが…適切だと感じたからです。小さな折り畳み冊子にシンプルな構文でメモを書き留める——しかも美しいタイポグラフィで——。PocketModを「zine（ジン）」と呼ぶ人もいます。A4用紙1枚から作れる8ページの小冊子だからです。

そして実際に可能でした！ これにより、次のものを素早く簡単に作れます。 [週間予定表のミニ冊子](https://www.overleaf.com/read/zfzcxygqwqsq) あるいは小さな [絵本](https://www.overleaf.com/read/rppnsfgnrhsf)。ええ、娘は自分の描いた絵で作ったお話の本を見て楽しんでいました……まあ、10分間だけですが！ [`markdownパッケージ`](http://www.ctan.org/pkg/markdown) では、各markdown構文がLaTeXへどのようにレンダリングされるかをカスタマイズできるので、標準の `![](img_file "caption")` 構文を再定義して、キャプションを画像ファイルの下に置くようにし（「Figure」という接頭辞や番号付けはなし）、その後に改ページを挿入しました。これで絵本を作るのがさらに簡単になります。以下は冊子の折り方を示す動画です。

{% embed url="<https://www.youtube.com/embed/IAb31rIeGZo>" %}

### 簡単なレシピ冊子

考えてみれば、レシピはリストでできています。材料のリスト、下ごしらえや調理手順のリスト、そして場合によってはメモのリスト（調理時間、何人分かなど）です。ですから、次のように書く代わりに：

```latex
\begin{enumerate}
\item まずこれを行う
\item 次にそれを行う
...
\end{enumerate}
```

私はぜひ次のように書けるとありがたいです：

```
#. まずこれを行う
#. 次にそれを行う
```

そして材料についても同様です：

```
- 卵2個
- 塩ひとつまみ
```

そこで、手早くレシピを簡単に作るには、次のように書けます：

```
# いり卵

調理時間
：5分

人数
: 1

## 材料
- 卵4個
- バター小さじ1
- 牛乳1/4カップ
- 塩、こしょう（好みで）

## 手順

#. 卵と牛乳を混ぜる...
#. フライパンでバターを熱する...
#. ...
```

うーん、これは期待できそうです。Overleafの何人か（そして私たちの家族）が、それぞれのお気に入りの簡単レシピ（初めて料理する人に最適）を提供してくれたので、私はさっと作り上げました（しゃれをお許しください）。 [簡単レシピテンプレート](https://www.overleaf.com/read/gscqdhnwzsfg) markdownで書ける *や* ミニ冊子にできます。

[![A recipe booklet produced on Overleaf using markdown](/files/d81410cbe887b896333fb68de70f6a36e3c6d48b)](https://www.overleaf.com/read/gscqdhnwzsfg)

ここでさらに少し楽しい話です。裏側ではこれは依然としてLaTeXなので、見出し、箇条書き、フォントなどのさまざまな要素を、いつものLaTeXの技を使って引き続き整えられます。そこで私はかなり夢中になって、次のものを考え出しました。 *3つの* のための「テーマ」 `simple-recipe` クラス！

### ボーナス1: markdownパッケージを使う際の注意点

* SyncTeXは完全には機能しません。Overleafでは、これは「プレビューでの位置」や「プレビューをクリックしてソースへジャンプ」の操作が `markdown` 領域では機能しないことを意味します。
* `\\` は通常の意味を失います。通常の「2つのスペースの後に改行」という `markdown` この裏技はここでは使えません。末尾の空白はLuaパーサーによって削除されるためです。これは [`markdown` パッケージのドキュメント](http://texdoc.net/pkg/markdown). `\newline` では機能します。
* 同じ行に複数のアンダースコア文字がある場合は注意してください。これは次の場合に問題になることがあります：

  * 式の中で添字をたくさん使っているとき（ヒント：その場合は `markdown` 環境の外に出すこと）；
  * BibTeXキーにアンダースコアを使いたいとき。

  次のように設定できます `underscores=false` 最新の `markdownパッケージ` ファイルで添字のアンダースコアを機能させられますが、BibTeXキー中のアンダースコアは依然として機能しません。

  **更新** (2017年5月13日): BibTeXキー内のアンダースコアは `markdown` v2.5.2以降で機能します。Vít、ありがとう！
* そのままのハッシュ文字を表示するのには少し苦労するでしょう。なぜなら `\#` さえも使えないからです！ 私は通常、新しいコマンドを定義して代わりに使います。

### ボーナス2: 更新版markdownパッケージの新機能

`markdown` v2.4以降では、いくつかのとても便利な構文がサポートされました：

* **インライン脚注構文**: `...^[これは脚注です]` （ `inlineFootnotes` オプションが必要）
* **引用：**`[@smith1990]` （ `引用` オプション；また、BibTeXキー中のアンダースコアにも注意してください！）
* **フェンス付きコード**：チルダでも `~` バッククォートでも `` ` `` フェンスとして使えます。

```
~~~~
int main() {
  cout << "Hello world!";
  return 0;
}

~~~~
```

これらの新機能を使いたい場合は、次の最新版を必ずアップロードしてください： `markdown.lua`, `markdown.tex` や `markdown.sty` あなたのプロジェクトに、あるいは [このテンプレートから新しいプロジェクトを作成できます。](https://www.overleaf.com/read/whdrnpcpnwrm).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/ja/xiang-xi-ji-shi/32-markdown-into-latex-with-style.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.