Freshers/2023/Markdown

フレッシャーズセミナー 2023年度高橋担当分†

Freshers/2023 へ戻る

Markdown†

VSCode で Markdown のファイルを作ってみましょう．

Step1†

1. VSCode を開く．
2. hoge.md という名前の新しいファイルを作る．
3. その中身を次のようにする（コピー&ペーストしましょう）．

   # 大きい見出しです
   
   ## 中くらいの見出しですです
   
   行の先頭を `#` や `##` で始めると，章や節のタイトルになります．
   「大きい見出しです」は `#` で，「中くらいの見出しですです」は，`##` で始まってるので，前者よりも後者の方が一つ下のレベルの見出しとなっています．
   
   ほげほげほげほげほげほげほげほげほげほげほげほげほげほげほげほげほげほげほげほげ
   ほげほげほげほげほげほげほげほげほげほげほげほげほげほげほげほげほげほげほげほげ．
   
   ## 中くらいの見出しでんがなまんがな
   
   「中くらいの見出しでんがなまんがな」は，「〜ですです」と同じレベルのタイトルですです．
   
   ### も一つ下の見出しでっせ
   
   `###` にすると↑のようになります．
   
   だんらくだんらくだんらくだんらくだんらく *だんらく* だんらくだん **らくだ** んらくだんらくだんらくだんらくだんらくだんらくだんらくだんらくだんらくだんらくだんらくだんらくだんらくだんらくだんらくだんらく．
   
   だんらくだんらくだんらくだんらく．
   

4. 下図の丸で囲んだアイコンを押して「プレビュー」を開く
   
5. 下図のように，VSCode のウィンドウが分割されて，左に hoge.md の中身が，右にそれを見栄え良く整形したもの（プレビュー）が表示される
   
6. 左右を見比べる

Step2†

hoge.md の末尾に以下を追加して観察しましょう．

### 箇条書き

行の先頭を`- `（`-` のあとに半角の空白を入れる）とすると，箇条書きができます．

- 箇条書き
- かじょーがき
    - 過剰牡蠣
    - 渦状柿

行の先頭を `1. `（`.` のあとに半角の空白を入れる）とすると，すると，番号付きの箇条書きができます． 

1. 箇条書き
1. かじょーがき
    1. 過剰牡蠣
    1. 渦状柿

Step3†

補足です．

1. Google 等のウェブ検索で「Markdown」 や「Markdown記法」をキーワードにして検索すると，Markdown の書き方に関する情報が見つかります．いろいろ試してみましょう．

   Markdown にもいろいろ方言があるので，見つけた書き方が VSCode のプレビューでは正しく描かれないこともあります

2. （これは必須ではありません） VSCode に拡張機能をインストールすることで，Markdown 文書をHTMLやPDFに変換できます．

   いろんな拡張機能がありますが，後述するような LaTeX 数式を含む Markdown を扱うなら， Markdown Preview Enhanced （日本語）がよいでしょう．

Freshers/2023 へ戻る

takataka

龍谷大学
　先端理工/数理
　　高橋隆史
　　　時間割/2024

最新の25件

edit