ヘルプセンター
LaTeX と Typst のプロジェクトの作成、コンパイル、共同作業のための実用的なガイド。
Markdown で書く
.md ファイルをソースでも書式付きでも編集し、その場でプレビューし、LaTeX や Typst に変換できます。
ソースとビジュアルを切り替える
Markdown ファイル(.md または .markdown)には同じテキストの表示が 2 つあります。「ソース」は入力したままの Markdown を、「ビジュアル」は編集しながら書式を整えた状態を表示します。
手順
- Markdown ファイルを開きます。最初は「ソース」で開きます。
- タブの下にあるツールバー先頭の「ソース / ビジュアル」切り替えを選ぶか、コマンドパレットで「Markdown:ビジュアルエディターに切り替え」を実行します。もう一度選ぶと元に戻ります。
- 「ビジュアル」では、見出し、リスト、表、画像、数式が読むときの姿で表示されます。数式にカーソルを置くとそのソースを編集でき、下に「数式のプレビュー」が出ます。
- 画像を選ぶと「画像を編集」(「パスまたは URL」と「代替テキスト」を変えて「適用」)と「画像を削除」が出ます。リンクにポインターを合わせると「リンクを開く」と「リンクを解除」が出ます。
- 「ビジュアル」で文字を選ぶと、「コメントを追加」「チャットに追加」「クイック編集」が使えます。共同編集者の編集、コメント、変更履歴はどちらの表示にも出ます。
- 2 つの表示はカーソルを共有するので、切り替えても位置はそのままです。表示はタブごとに選べます。
ツールバーで書式を付ける
Markdown のタブでは、ツールバーは Markdown を挿入し、ボタンは「ソース」と「ビジュアル」のどちらでも同じように働きます。
手順
- 「ソース / ビジュアル」切り替えの後に、「元に戻す」「やり直す」「見出しレベル」(1〜6)「太字」「斜体」「インラインコード」「リンクを挿入」「脚注を挿入」「リストを挿入」「図を挿入」「表を挿入」「揃えた数式を挿入」「別行立て数式を挿入」「分数を挿入」が並びます。収まらないものは末尾の「その他の Markdown 操作」に入ります。
- 段落や見出しの上で「見出しレベル」を選ぶとそのレベルが設定され、それ以外の場所では新しい見出しが挿入されます。
- 「リストを挿入」では「箇条書き」か「番号付きリスト」を選べ、「表を挿入」では大きさを選べます。
- Markdown には下線、引用、相互参照がないため、Markdown のタブにはそれらのボタンは表示されません。
- ツールバーを右クリックして「テキストツールバーを非表示」を選ぶと書式ボタンが隠れますが、「ソース / ビジュアル」切り替えは残ります。エディター設定の「テキストツールバー」で元に戻せます。
Markdown ファイルをプレビューする
プレビューは、あなたや共同編集者の入力に合わせてファイルをそのまま表示します。コンパイルは要りません。
手順
- Markdown タブのタブバーで「プレビュー」を選ぶか、Ctrl+K に続けて V を押します(Mac では ⌘K に続けて V)。プレビューはソースの隣に開きます。
- 表、タスクリスト、脚注、$ と $$ で書いた数式、Mermaid の図を表示し、> [!NOTE] のようなアラートは目立つ枠で表示します。YAML のフロントマターは表示されず、ファイル内の HTML も表示されません。
- 画像には、Markdown ファイルからのパスで指定したプロジェクト内のファイルか、https のアドレスを使えます。プロジェクト内の別のファイルへのリンクは、そのファイルを開きます。
- ソースをスクロールするとプレビューも追従します。ブロックをダブルクリックするか、Ctrl キー(Mac では Cmd キー)を押しながらクリックすると、ソースの該当行へ移動します。
- プレビューを右クリックすると「ソースへ移動」と「ソースファイルを開く」があります。
Markdown を取り込む・書き出す
Markdown は LaTeX や Typst に変換でき、LaTeX や Typst のプロジェクトは Markdown として書き出せます。
手順
- Markdown の下書きからプロジェクトを作るには、「新規プロジェクト」の横の矢印を開いて「ファイルからインポート」を選び、.md ファイルを指定し、LaTeX か Typst を選んで「インポートを開始」を押します。
- プロジェクトの中では、エクスプローラーで .md ファイルを右クリックして「LaTeX に変換」(Typst プロジェクトでは「Typst に変換」)を選ぶと、結果がその隣に作られます。
- プロジェクトの Markdown 版が欲しいときは、タイトルバーの ••• 「プロジェクト操作」ボタンを開き、「書き出し」から「Markdown (.md)」を選びます。数式は TeX のまま残り、画像は本文の隣のフォルダーに入ります。
- 個人ノートも Markdown です。画像のないページで「ダウンロード」を選ぶと、その .md ファイルが保存されます。
