Markdownしたい（`markdown`）

% プリアンブル
\usepackage[hybrid]{markdown}

% 本文
\begin{markdown}

# Markdown Package

`markdown`環境内の文章は、Markdown形式で入力します。

\end{markdown}

Markdown環境の外はLaTeX形式なので、
数式は、いつもどおりのLaTeXコマンドで作成できます。

\begin{equation}
E = mc^{2}
\end{equation}

markdownは、Markdown記法を使えるようにするパッケージです。 CommonMarkに対応しています。 hybridオプションを有効にすると、markdown環境の中でLaTeXコマンドが使えるようになります。

ひとつの文書の中で、LaTeX記法とMarkdown記法のいいとこどりができるように使い分けると執筆の効率があがりそうです。

インライン数式したい（`texMathDollars`）

\begin{markdown}
アインシュタインは$E=mc^{2}$のひとです。
\end{markdown}

$...$ で挟むことでインライン数式できます。また$$...$$で挟むことでディスプレイ数式できます。

複雑な数式は、markdown環境に入れずに、素直にalign環境などを使いましょう。

注釈

もし $...$ 記法が効かない場合、texMathDollarsオプションを明示してください。

\usepackage[hybrid,texMathDollors]{markdown}

LaTeXコマンドしたい（`hybrid`）

% プリアンブル
\usepackage[hybrid]{markdown}
\usepackage{siunitx}

% 本文
\section{SuperKEKB加速器}

\begin{markdown}
SuperKEKB加速器は周長\qty{3}{\km}の円型加速器です。
\end{markdown}

\section{Belle II 測定器}

\begin{markdown}
Belle II 測定器は\qtyproduct{8x8x8}{\m}の大きな測定器です。
\end{markdown}

hybridオプションを有効にするとmarkdown環境の中で LaTeXコマンドが使えるようになります。 markdown環境の中は、Markdown記法で閉じていたほうがよいと思います。ただ、単位表示のsiunitxパッケージは便利すぎる。

注釈

ログファイルに hybridオプションはsoft-deprecatedなので、代替オプションを明示的に選択するようにという警告がでていました。

Package markdown Warning: The `hybrid` option has been soft-deprecated.
(markdown)                Consider using one of the following better options
(markdown)                for mixing TeX and markdown: `contentBlocks`,
(markdown)                `rawAttribute`, `texComments`, `texMathDollars`,
(markdown)                `texMathSingleBackslash`, and
(markdown)                `texMathDoubleBackslash`. For more information, see
(markdown)                the user manual at
(markdown)                <https://witiko.github.io/markdown/>.

Markdownのフレーバー

年	フレーバー	概要	拡張機能
2004	Markdown	Markdownのオジリナル版
2005	MultiMarkdown	Markdownの拡張版	脚注、表、引用、メタデータ、LaTeXのサポート
2006	Pandoc Markdown	Pandocツール用	数式、脚注、スライド作成
2008	kramdown	Ruby用	表、数式、カスタム要素
2009	GitHub Flavored Markdown	GitHub用	表、チェックボックス、コードブロック、URLの自動リンク
2014	CommonMark	Markdownの標準化	一貫性と互換性のあるパーサー、多言語対応

Markdownから派生／拡張した記法のことをフレーバーと呼びます。フレーバーを年表にしてみましたが、多種多様なことがわかります。

よく知られているのはGitHub Flavored Markdown（GFM）だと思います。 GFMのリリースでMarkdown記法が普及しました。また、このように多様化したフレーバーの標準化を目指しているのがCommonMarkです。近年の拡張はこのCommonMarkがベースになっています。

参考

Markdownのオリジナル作者たちと、標準化を目指したコミュニティはバチバチのようです。なので、そのままMarkdownを名乗ることが許されず、 CommonMarkという別の名前になっているらしいです。

Markdownしたい（markdown）

インライン数式したい（texMathDollars）

LaTeXコマンドしたい（hybrid）

Markdownのフレーバー

Markdownしたい（`markdown`）

インライン数式したい（`texMathDollars`）

LaTeXコマンドしたい（`hybrid`）