1 妙筆在手，編程無憂！

1.1 編程為啥要做筆記？這答案絕了！

????????嘿，各位鍵盤魔法師！學編程不記筆記，就像吃火鍋不配冰可樂 —— 爽到一半直接噎住！你以為自己腦子是頂配 SSD，結果 debug 時連變量名都寫成 "a1a2a3" ？別慌！筆記就是你的 "代碼防丟符"，專治各種 "昨天我寫了啥" 的失憶癥！

????????做筆記的三大神效：

• 🔥?BUG 克星：報錯原因 + 解決方案寫成 "避坑寶典"，下次遇到同類問題直接 Ctrl + C，效率開掛！
• 🔥?靈感存錢罐：零散思路秒變 "代碼模塊庫"，復用率堪比老干媽?—— 萬物皆可蘸！
• 🔥?職場護身符：注釋清晰到讓同事想給你磕頭，離職時還能把筆記當 "傳家寶" 留給接盤俠～

1.2 多種筆記形式的對比

????????在編程學習中，我們可選擇的筆記形式多種多樣，每種形式都有其獨特的優勢與局限。

• 紙質筆記：
  • 優點：手感真實，書寫流暢，有助于深度思考。
  • 缺點：攜帶不便，查找困難，難以進行大規模整理與分享，長時間書寫易疲勞。
• 電子版筆記（Word、TXT、Markdown）：
  • Word：功能強大，格式豐富，但文件體積大，跨平臺兼容性一般。
  • TXT：純文本格式，簡單輕便，但缺乏格式支持，可讀性較差。
  • Markdown：輕量級標記語言，易于學習，格式簡潔美觀，但原生不支持復雜排版，且不同編輯器間可能存在渲染差異。不過，對于編程筆記而言，Markdown 的簡潔性與代碼高亮功能已足夠強大。
  • 共同缺點：相較于云筆記和博客，這些形式在隨時修改與多端查看上略顯不便。
• 云筆記（有道云筆記、語雀等）：
  • 優點：支持多端同步，便于隨時隨地記錄與查看；提供豐富的模板與協作功能。
  • 缺點：免費空間有限，超出后需付費；部分高級功能需訂閱會員。
• 博客（CSDN、51CTO、博客園、簡書、掘金）：
  • 優點：
    • 跨平臺性：無論身處何地，只要有網絡，就能訪問自己的博客。
    • 多設備可查看：手機、平板、電腦，隨時隨地回顧筆記。
    • 分享與交流：博客是公開的平臺，便于與他人分享知識，參與討論。
    • SEO 優化：優質內容易被搜索引擎收錄，提升個人影響力。
  • 推薦理由：特別是 CSDN，作為國內領先的 IT 社區，擁有龐大的用戶群體與豐富的資源，是編程學習者分享與交流的理想之地。

---

2 ?Markdown 核心教程

2.1 Markdown 簡介

????????Markdown 是一種輕量級標記語言，它支持人們以易讀易寫的純文本格式編寫文檔，隨后可轉換為有效的 XHTML（或 HTML）文檔。對于編程學習者來說，Markdown 具備諸多極具吸引力的特性：

• 簡潔易上手：基本語法簡單直觀，短時間內即可快速掌握。
• 代碼高亮：能夠支持多種編程語言的代碼高亮顯示，使代碼筆記更加清晰、易讀。
• 格式多樣：盡管簡潔，但 Markdown 也支持標題、列表、鏈接、圖片等多種格式，完全能滿足日常筆記需求。
• 跨平臺通用：幾乎所有的文本編輯器和 IDE 都支持 Markdown 格式，而且許多網站（如 GitHub、CSDN 等）也直接支持 Markdown 編輯與預覽。

2.2 Markdown 語法精講

????????在了解多種筆記形式并認識 Markdown 筆記后，相信大家對 Markdown 這個簡潔且功能強大的工具產生了濃厚興趣。接下來，讓我們一同深入 Markdown 的語法世界，從基礎的標題語法開始，逐步掌握這個 “筆記利器” 的核心要點。

????????這里，我們選擇 VS Code 作為 “得力助手”，帶領大家一起撰寫 Markdown 筆記，親身感受它的獨特魅力。VS Code 作為一款功能強大的代碼編輯器，為 Markdown 提供了出色的支持。它具備語法高亮顯示功能，讓 Markdown 代碼清晰易辨；還有實時預覽功能，讓我們在編寫筆記時，能隨時查看最終的呈現效果。有了這些功能的助力，我們編寫 Markdown 筆記的效率將大幅提升，整個過程也會更加輕松愉悅。

2.2.1 標題

????????首先，啟動 VS Code，新建一個名為 “Markdown筆記演示” 的文件夾，接著在該文件夾內創建一個名為 “標題” 的 Markdown 文件，文件后綴為 “.md”，即 “標題.md”，操作示例如下：

????????之后，我們開啟 VS Code 的實時預覽功能，這樣在編寫筆記的過程中，就能隨時查看最終的呈現效果，具體展示如下：

????????Markdown 提供了簡單且直觀的方式來創建標題，通過使用不同數量的 “#” 符號來定義不同級別的標題，最多支持六級標題。以下是詳細的說明和示例：

注意事項：?

• “#” 符號與標題內容之間需要有一個空格，否則 Markdown 無法正確識別為標題。
• 標題內容可以是任意文本，但建議簡潔明了，能夠準確概括該部分內容的主題。
• 在實際編寫文檔時，應根據文檔結構和內容層次合理選擇標題級別，避免標題級別混亂，影響文檔的可讀性。

2.2.2 代碼塊

????????Markdown 中使用成對的三個反引號（``` ```，位于 Tab 鍵上方）來創建代碼塊。將代碼放在成對的三個反引號之間，就可以形成一個獨立的代碼塊。

????????為了讓代碼更具可讀性，Markdown 允許在開頭的三個反引號后面指定編程語言，從而實現代碼高亮。不同的編程語言有不同的高亮規則，這樣可以讓代碼中的關鍵字、變量、注釋等以不同的顏色顯示。

????????如果你只需要在文本中插入一小段代碼，可以使用行內代碼語法。行內代碼使用一對反引號（` `）將代碼包裹起來。

注意事項：?

• 確保三個反引號是成對出現的，否則代碼塊可能無法正常顯示。
• 指定編程語言名稱時，要確保拼寫正確，否則代碼高亮可能無法生效。
• 行內代碼適用于簡短的代碼片段，如果代碼較長或需要格式化顯示，建議使用代碼塊。

2.2.3 列表

無序列表：

????????無序列表使用 -（減號）、+（加號）或 *（星號）作為列表項的前綴，后面緊跟一個空格，然后輸入列表項的內容。

????????各個列表項之間沒有順序之分，獨占一行。

????????可以通過在列表項中再次使用有序或無序列表語法來創建嵌套列表，實現多級列表的展示。

有序列表：

? ? ? ? 有序列表使用數字 1 到 n，后面緊跟一個英文句號 . 和一個空格，然后輸入列表項的內容。

????????各個列表項之間有明確的順序，獨占一行。

????????雖然 Markdown 會根據列表項的順序自動編號，但建議按照自然順序編寫數字，以提高代碼的可讀性。

????????同樣，可以在有序列表項中再次使用有序或無序列表語法來創建嵌套列表，實現多級列表的展示。

嵌套列表：

????????有序列表和無序列表可以相互嵌套使用。

注意事項：?

• 列表項的前綴（如 -、+、*、數字 .）與列表項內容之間必須有一個空格，否則 Markdown 無法正確識別為列表。
• 列表項之間的空行不會影響列表的顯示，但建議在列表項之間保持適當的空行，以提高代碼的可讀性。
• 嵌套列表的縮進建議使用兩個或四個空格，以保持代碼的一致性和可讀性。

2.2.4 文本樣式

????????強調（斜體）：使用星號 * 或下劃線 _ 包圍文本。

????????加粗：使用兩個星號 ** 或兩個下劃線 __ 包圍文本。

????????加粗且斜體：使用三個星號 *** 或三個下劃線 ___ 包圍文本（或使用組合如 **_ 或 _**，但 *** 更常見）。

????????刪除線：使用兩個波浪號 ~~ 包圍文本。

????????引用：在文本前添加一個大于號 >。

? ? ? ? 換行：如果需要確保跨平臺兼容性，建議使用兩個空格 + 回車或 <br> 標簽來實現換行。

2.2.5 分割線

????????使用三個或更多的星號 ***、減號 --- 或下劃線 ___。

2.2.6 圖片

????????Markdown 使用以下語法來插入圖片：

![圖片描述](圖片路徑)

• 圖片描述：這是圖片的替代文本（alt text），在圖片無法加載時顯示，也有助于提高可訪問性。
• 圖片路徑：可以是本地相對路徑或網絡鏈接。

注意事項：

1. 本地圖片
   • 確保圖片路徑正確，與 Markdown 文件相對位置一致。
   • 圖片文件需完整且未被刪除，否則無法顯示。
   • 渲染器可能不支持本地路徑（如 GitHub），需提前確認。
2. 網絡圖片
   • 確保圖片 URL 正確且可訪問，優先使用 HTTPS 協議。
   • 考慮圖片鏈接的穩定性，避免使用易失效的鏈接。
   • 遵守版權規定，使用合法圖片資源。

2.2.7 超鏈接

????????在 Markdown 中，超鏈接用于創建指向其他網頁、文件或資源的可點擊鏈接。Markdown 使用以下語法來創建超鏈接：

[鏈接文本](鏈接地址)

• 鏈接文本：這是用戶看到的可點擊文本。
• 鏈接地址：這是點擊鏈接文本后要訪問的 URL 或路徑。

---

3 Typora 的安裝與配置

3.1 Typora 簡介

????????Typora 是一款全球公認的優秀 Markdown 編輯器，以其簡潔的界面、實時預覽功能和強大的擴展性著稱。與 VS Code 等需要分屏預覽的編輯器不同，Typora 實現了所見即所得（WYSIWYG）的編輯體驗，無需切換預覽模式，極大提升了筆記編寫的流暢度。其豐富的自定義選項和主題支持，使其成為撰寫 Markdown 筆記的首選工具。

3.2 Typora 安裝流程

? ? ? ? 你可以通過訪問 Typora 的官方網站：?https://www.typora.net/ 下載適合你操作系統（Windows/macOS/Linux）的版本：

????????此外，你還可以選擇通過博主分享的網盤鏈接（https://pan.baidu.com/s/12pImL7DSy09h_Wrret568Q?pwd=n857）下載所需文件。下載并解壓該資料包后，在 “軟件安裝包” 文件夾內，有一個名為 “Typora激活資源” 的文件夾，其中存放著 Typora 軟件的安裝包，如在所示：

????????軟件安裝包下載完成后，只需雙擊名為 “typora-setup-x64-1.2.4.exe” 的安裝文件即可開始安裝，操作示例如下：

????????接下來，選定軟件的安裝路徑：

? ? ? ? 你可以選擇是否勾選創建桌面圖標的選項：

????????最后，點擊 “Install” 按鈕即可完成安裝。

3.3 Typora 激活流程

????????在成功安裝 Typora 軟件后，請先將其關閉，隨后關閉電腦上運行的所有殺毒軟件。?

????????接下來，請將《Typora激活資源》文件夾中的 app.asar 文件，復制到 Typora 軟件的安裝路徑下的 resources 文件夾中，并替換掉原有的 app.asar 文件，操作如下所示：

????????而后，點擊 “替換目標中的文件” 選項以完成替換操作。

????????之后，重新啟動 Typora 軟件，并在相應界面點擊 “輸入序列號” 選項。

????????在注冊界面中，請輸入以下郵箱地址和授權碼：

郵箱：xiajierluantian@163.com (隨便寫)
授權碼: E8Q9Y5-KXMTL5-7578SL-4S5XKS

????????完成上述步驟后，Typora 軟件即安裝并激活成功。但請注意，此操作僅供學習交流使用，強烈建議你支持正版軟件，以確保獲得合法的使用權益及優質的技術支持。

3.4?Typora 基礎配置

????????在 Typora 軟件中，通過點擊菜單欄的 “文件” 選項，然后選擇 “偏好設置”，即可進入軟件配置界面。

3.4.1 通用配置

????????首先，建議關閉軟件的自動更新功能，以避免不必要的干擾。至于其他通用配置選項，如啟動時的默認行為（例如選擇 “打開新文件” 等），則可根據個人使用習慣進行自由設置。

3.4.2 編輯器配置

????????在 Typora 編輯器中，你可以根據自己的寫作習慣對編輯器進行相應的配置。以下是一些具體的配置建議，特別是關于縮進字符、成對符號匹配等方面的設置：

1. 配置默認縮進字符

• 縮進級別：在 “編輯器” 設置中的 “默認縮進” 部分，你可以設置默認的縮進級別。你可以選擇 2 個、3 個、4 個空格或其他你喜歡的縮進單位。這有助于你在編寫列表、代碼塊或引用時保持一致的縮進風格。

2. 設置成對符號匹配

• 匹配括號和引號：在 “使用成對的符號” 部分，勾選 “匹配括號和引號” 選項。這樣，當你輸入左括號或左引號時，Typora 會自動為你匹配右括號或右引號，提高輸入效率。

• 匹配 Markdown 字符：同樣地，勾選 “匹配 Markdown 字符” 選項。這意味著當你輸入 Markdown 特定字符（如星號用于加粗或斜體）時，Typora 會自動為你匹配成對的字符，方便你快速應用 Markdown 格式。

3. 其他編輯器配置建議

• 即時渲染：如果你希望實時查看 Markdown 渲染效果，可以在 “即時渲染” 部分選擇不勾選 “顯示當前塊元素的 Markdown 源碼”。這樣，Typora 會即時渲染你的 Markdown 內容，讓你更直觀地看到最終效果。

• 默認復制行為：在 “默認復制行為” 部分，你可以根據自己的需求選擇復制純文本時是否復制 Markdown 源碼，以及復制或剪切時若沒有文字被選中是否復制或剪切光標所在的一整行。

• 默認換行符：根據你的操作系統選擇默認的換行符。如果你使用的是 Unix/Linux 或 macOS 系統，選擇 “LF (Unix Style)”；如果你使用的是 Windows 系統，選擇 “CRLF (Windows Style)”。

• 拼寫檢查：勾選 “自動檢測語言” 選項，讓 Typora 根據你輸入的內容自動檢測語言，并提供拼寫檢查功能。

• 打字機模式：如果你喜歡始終將光標保持在屏幕中間進行寫作，可以勾選 “在打字機模式下，始終保證光標在屏幕中間” 選項。

3.4.3 圖像配置

1. 復制圖片到指定文件夾

• 復制圖片到 ./${filename}.assets 文件夾：
  • 選擇此選項后，當你將圖片插入到 Typora 中時，圖片會被復制到當前 Markdown 文件同目錄下的 ${filename}.assets 文件夾中。${filename} 是你的 Markdown 文件名（不包括擴展名）。
  • 這樣做的好處是，你的圖片文件會與 Markdown 文件一起被組織和管理，方便備份和遷移。
• 無特殊操作：
  • 如果你不希望 Typora 對插入的圖片進行任何特殊處理，可以選擇此選項。圖片將保持其原始位置，Typora 只會記錄圖片的路徑。
• 復制圖片到當前文件夾：
  • 選擇此選項后，圖片會被復制到當前 Markdown 文件所在的文件夾中，而不是創建一個單獨的 .assets 文件夾。

2. 圖片上傳選項

• 上傳圖片：
  • 如果你希望將圖片上傳到某個圖床或云存儲服務，可以選擇此選項。然后，你需要配置上傳服務的相關信息（如 API 密鑰、上傳 URL 等），這通常需要在 Typora 的高級設置或 YAML 前置事項中進行配置。
• 對本地 / 網絡位置的...應用上述規則：
  • 這兩個選項允許你指定是否對本地圖片和網絡圖片應用上述的復制或上傳規則。

3. 優先使用相對路徑

• 勾選此選項后，Typora 會優先使用相對路徑來引用圖片。這意味著，如果你的圖片文件和 Markdown 文件在同一個文件夾或子文件夾中，Typora 會使用相對路徑來引用圖片，而不是絕對路徑。這樣做的好處是，當你的文件被移動到其他位置時，圖片引用仍然有效。

4. 允許根據 YAML 設置自動上傳圖片

• 勾選此選項后，你可以通過在 Markdown 文件的 YAML 前置事項中配置上傳服務的信息，來自動上傳插入的圖片。這需要在 YAML 中指定上傳服務的名稱、API 密鑰等相關信息。

5. 插入時自動轉義圖片 URL

• 勾選此選項后，當你插入圖片時，Typora 會自動對圖片的 URL 進行轉義。這通常是為了防止 URL 中的特殊字符（如空格、括號等）在 Markdown 渲染時出現問題。

3.4.4 Markdown 配置?

1. Markdown 語法偏好

• 嚴格模式：如果你希望 Typora 嚴格遵循 Markdown 語法規范，可以勾選此選項。但如果你希望 Typora 在某些情況下更加寬容，可以不勾選。
• 標題樣式：選擇你喜歡的標題樣式，如 “atx (#)” 或 “無序列表”。
• 無序列表和有序列表：確保這些選項已勾選，以便你可以輕松創建列表。

2. Markdown 擴展語法

• 內聯公式：如果你需要在 Markdown 中插入數學公式，可以勾選此選項，并熟悉 LaTeX 語法。
• 下標和上標：勾選這些選項，以便你可以輕松地在文本中使用下標和上標。
• 高亮：勾選此選項，以便你可以使用 ==key== 語法來高亮文本。
• 圖表：如果你需要在 Markdown 中插入圖表（如序列圖、流程圖和 Mermaid 圖），可以勾選此選項，并學習相應的圖表語法。

3. 智能標點

• 輸入時轉換：勾選此選項，以便 Typora 在你輸入時自動轉換引號、破折號等標點符號為智能標點。
• 智能引號和智能破折號：確保這些選項已勾選，以獲得更好的排版效果。
• 解析 Markdown 時允許并轉化 Unicode 標點：勾選此選項，以便 Typora 在解析 Markdown 時能夠正確處理和轉換 Unicode 標點。

4. 代碼塊

• 顯示行號：如果你希望在代碼塊中顯示行號，可以勾選此選項。
• 代碼塊自動換行：根據個人喜好選擇是否勾選。如果你希望代碼塊中的代碼自動換行，可以勾選；否則，可以不勾選。
• 代碼縮進：設置你喜歡的代碼縮進級別，如 4 個空格。

5. 公式

• 自動添加序號：如果你希望在公式旁邊自動添加序號，可以勾選此選項。
• 支持使用 \newline 換行：勾選此選項，以便你可以在公式中使用 \newline 進行換行。
• 啟用 physics 包：如果你需要在公式中使用 physics 包的特性，可以勾選此選項。
• 當復制或導出為無格式的 HTML 時：選擇你喜歡的選項，如 “使用 SVG”，以確保公式在復制或導出時保持正確的格式。

3.5 Typora 快捷鍵

3.5.1?文件操作快捷鍵

快捷鍵	功能描述
Ctrl + N	新建文件
Ctrl + O	打開文件
Ctrl + S	保存文件
Ctrl + Shift + S	另存為文件
Ctrl + W	關閉當前文件

3.5.2?編輯操作快捷鍵?

快捷鍵	功能描述
Ctrl + Z	撤銷上一步操作
Ctrl + Y	重做上一步操作（部分系統為 Ctrl + Shift + Z）
Ctrl + X	剪切選中文本
Ctrl + C	復制選中文本
Ctrl + V	粘貼剪貼板內容
Ctrl + A	全選文本
Ctrl + L	選中當前行/句
Ctrl + D	選中相同格式的單詞
Ctrl + E	選中相同格式的文字

3.5.3?段落格式快捷鍵

快捷鍵	功能描述
Ctrl + 1/2/3/4/5/6	設置一級/二級/三級/四級/五級/六級標題
Ctrl + 0	設置為普通段落
Ctrl + T	插入表格
Ctrl + Shift + Q	插入引用
Ctrl + Shift + [	增加縮進（有序列表）
Ctrl + Shift + ]	減少縮進（無序列表）

3.5.4?文本格式快捷鍵

快捷鍵	功能描述
Ctrl + B	加粗文本
Ctrl + I	傾斜文本
Ctrl + U	下劃線文本
Alt + Shift + 5	添加刪除線

3.5.5?插入元素快捷鍵

鍵	功能描述
Ctrl + K	插入超鏈接
Ctrl + Shift + I	插入圖片
Ctrl + Shift + K	插入代碼塊

3.5.6?光標移動快捷鍵

快捷鍵	功能描述
Ctrl + Home	跳轉到文章開頭
Ctrl + End	跳轉到文章結尾
Ctrl + J	跳轉到所選內容

3.5.7?查找與替換快捷鍵

快捷鍵	功能描述
Ctrl + F	查找文本
Ctrl + H	替換文本

3.5.8?視圖切換快捷鍵

捷鍵	功能描述
Ctrl + /	切換源代碼模式
F11	切換全屏模式
Ctrl + Shift + L	顯示/隱藏側邊欄
Ctrl + Shift + 1	打開大綱視圖
Ctrl + Shift + 2	打開文檔列表視圖
Ctrl + Shift + 3	打開文件樹視圖