この記事を作った動機

 なんかそろそろ発表があるので、スライドを作ろうと思ったとき、MarkdownやWeb技術に基づいて作る方法があると話を聞いたことがあるを思い出した。卒論と修論において、MS Office 一連に対する代替を模索する一環としても興味深い。そこで、LLM に何があるか提案させ、それを自分で実際に使ってみるということをしていた。

 そこで選んだのが、Marp というものでVS Code上で動作する物を採用した。CSS で色々カスタムしたいと自然な成り行きとして思った。また、ただMarkdown中に直接描き込むのではなく、CSSとして独立したファイルからあれこれ編集を加えたいという需要があった。

 そのところなにをするべきかよく分からずに CSS ファイルを作成したり、CSS ファイル名を theme 名として markdown 内で指定したりして、間違った方法を試してしばらく時間を使うということがあった。その過程で分かったことを記録し、忘れたときにどうやって動作する状態に持ってくるか見返せるようにしたい。

 ちなみに LLM(少なくともローカル) は結局正しい方法を Web 検索などをもってしても提示できなかった。私としては、Use custom theme CSS 🛡️ を見て、ようやくどうすればいいか分かった形である。

前提

  • すでにcode .などで特定のフォルダを作業ディレクトリとして開いている
  • すでに作業ディレクトリに Markdown と カスタムテーマとなる CSS を記述したファイルが存在する
# イメージ
- workspaceFolder
    - slides.md
    - theme.css
  • VS Code の拡張機能として Marp を利用

やり方

 Marp は直接ワークスペース内にある CSS ファイルを自動認識してそのファイル名をカスタムテーマ名としてMarkdown内で記述できるわけではないことに注意する。

VS Code のワークスペース(全体に反映させる場合はグローバル設定へ)設定を確認

 Marp にカスタムテーマとして認識させたい CSS ファイルを指定する。

GUI で設定する

 設定画面の開き方は環境によって異なるため割愛する。

設定画面を開く
CSSを指定

直接ファイルを作成

 .vscodeのフォルダ名でワークスペースの最上位にフォルダを作成し、その中に、settings.jsonを作成、あるいは追記する。

- workspaceFolder
    - slides.md
    - theme.css
    - .vscode
        - settings.json
{
    "markdown.marp.themes": [
        "./theme.css"
    ]
}

CSS ファイル自体を確認

 Marp では、CSS ファイル内でメタデータとして指定されているテーマ名を認識して、Markdown で指定できるようになるという挙動をする。そのため、単なる CSS ではテーマとして認識せず機能しない。メタデータとしてのテーマ名は/* @theme [任意のテーマ名] */によって指定できる。

/* @theme main */

@import 'default';

h2 {
    position: absolute;
    top: 50px;
    left: 50px;
    text-align: left;
}

 ちなみに@import 'default';がないと全部自分でスライドとしての体裁を指定する必要がある状況になる。

default指定がないとき

参考にしたサイトとか