快速在 vs 撰寫 markdown 文件

安裝 Markdown Editor

使用擴充套件 Markdown Editor v2 for Visual Studio，安裝完成之後就可以在 Visual Studio 中撰寫 markdown 文件。 Markdown Editor

以下是一些常用的 Markdown 語法，本文的 Markdown 內容可在底下連結取得。 https://github.com/vitoshao/notes/blob/main/docs/MISC/markdown.md

目錄

文字與段落

這是一段文字，可以使用 ** 或 __ 來加粗，例如：這是加粗的文字。這也是是加粗的文字

這是另一段文字，段落之間可以使用 空行 來分隔。

也可以使用 * 或 _ 來斜體，例如：這是斜體的文字。這也是是斜體的文字

刪除線可以使用 ~~ 來標記，例如：這是刪除線的文字

This is a subscript text

This is a superscript text

This is an underlined text

The background color is #ffffff for light mode and #000000 for dark mode.

列表

無序清單

  • 項目 1
  • 項目 2
  • 項目 3
    • 項目 3-1
    • 項目 3-2

有序清單

  1. 項目 1
  2. 項目 2
  3. 項目 3

工作清單

  • 項目 1
  • 項目 2
  • 項目 3

項目接續

  1. 項目 4
  2. 項目 5

定義清單

Name
Godzilla
Born
1952
Birthplace
Japan
Color
Green

連結與圖片

連結

Markdown 語法建立的連結無法另開新頁籤

若要開新頁籤，只能使用 html

若要連結到同一個網頁中的某個區塊，可以使用 # 加上區塊標題名稱

跳至目錄

若目標區塊標題有空白或者有英文字，則空白會被轉成 -，英文字會被轉成小寫。

例如：若標題內容為 內嵌 Html 語法，這個標題的 ID 會被轉成 內嵌-html-語法

所以連結到這個區塊的語法為 [內嵌 Html 語法](#內嵌-html-語法)

圖片

Markdown 語法建立的圖片無法更改顯示大小

Sample

若要更改顯示大小，只能使用 html

引用程式碼

public class Teacher
{
    #nullable disable
    public int Id { get; set; }
    public string LastName { get; set; } = null!;
    public Office Office { get; set; }
}

表格

IdCourseIdNameDescription
11C# 基礎C# 基礎課程
21C# 進階C# 進階課程
32SQL 基礎SQL 基礎課程
42SQL 進階SQL 進階課程

內嵌 html 語法

以下是一段簡單的內嵌 html 語法：

這是一段帶有深灰色樣式的文字。

這是一段帶有紅色背景的區塊。

註解 (Callout)

一般註解

這是一段註解。 這還是同一段註解。

這是另一段註解。使用 空行 來分隔不同段落。

有樣式的註解

這是一段有特殊樣式的註解，可以用來強調重點。

這是一段有特殊樣式的註解，可以用來警告使用者。

這是一段有特殊樣式的註解，可以用來強調重要性。

這是一段有特殊樣式的註解，沒有TITLE

自訂標題的註解

My Note

這是一段有特殊樣式的註解，可以用來強調重點。

My Warning

這是一段有特殊樣式的註解，可以用來警告使用者。

My Important

這是一段有特殊樣式的註解，可以用來強調重要性。

My Heighligh

這是一段有特殊樣式的註解，沒有TITLE

Alerts

[!NOTE] Useful information that users should know, even when skimming content.

[!TIP] Helpful advice for doing things better or more easily.

[!IMPORTANT] Key information users need to know to achieve their goal.

[!WARNING] Urgent info that needs immediate user attention to avoid problems.

[!CAUTION] Advises about risks or negative outcomes of certain actions.

Collapsed Section

使用 <details> 標籤，可以建立折疊區塊。

Shopping list (click me!)

This is content inside a <details> dropdown.

  • Apples
  • Oranges
  • Milk

label

Default label

Blue label

Stable

New release

Coming soon

Deprecated