[{"data":1,"prerenderedAt":529},["ShallowReactive",2],{"wiki-page-\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian":3,"wiki-doc-items-\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian":494,"language-switcher-data-\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian":513,"wiki-i18n-paths-\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian":528},{"id":4,"title":5,"body":6,"canonicalPath":475,"chapterDepth":476,"chapterOrder":477,"date":331,"description":478,"docI18nKey":479,"docKey":480,"docRoot":481,"docTitle":482,"extension":483,"i18nKey":484,"isBlogPost":485,"isWikiDoc":372,"isWikiIndex":485,"layout":486,"legacyPath":486,"locale":487,"localeSlug":488,"meta":489,"navigation":372,"path":475,"seo":490,"sourcePath":491,"sourceStem":484,"stem":492,"wikiDepth":76,"__hash__":493},"content\u002F_i18n\u002Fzh-tw\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0200-环境搭建.md","環境搭建",{"type":7,"value":8,"toc":471},"minimark",[9,13,26,34,40,47,50,55,58,64,154,158,164,167,173,178,185,195,228,234,285,295,298,322,337,340,343,346,353,356,451,454,459,462,467],[10,11,12],"h1",{"id":12},"安裝",[14,15,16,17,21,22,25],"p",{},"首先可以安裝一個VScode插件叫做",[18,19,20],"code",{},"Markdown All in One",",然後還有",[18,23,24],{},"Markdown Preview Enhanced",".",[14,27,28],{},[29,30,31],"a",{"href":31,"rel":32},"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=yzhang.markdown-all-in-one",[33],"nofollow",[14,35,36],{},[29,37,38],{"href":38,"rel":39},"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=shd101wyy.markdown-preview-enhanced",[33],[14,41,42],{},[43,44],"img",{"alt":45,"src":46},"","https:\u002F\u002Fcdn.tungchiahui.cn\u002Ftungwebsite\u002Fassets\u002Fimages\u002F2025\u002F12\u002F25\u002F1787036895321-6b09b664.webp",[10,48,49],{"id":49},"配置圖片直接粘貼",[51,52,54],"h2",{"id":53},"規劃文件夾與圖片等命名老方法新手推薦","規劃文件夾與圖片等命名(老方法,新手推薦)",[14,56,57],{},"圖片名字格式為當前圖片創建的日期:時間戳.擴展名,例如20251225153422.webp",[14,59,60,61],{},"在工程根目錄創建",[18,62,63],{},".vscode\u002Fsettings.json",[65,66,70],"pre",{"className":67,"code":68,"language":69,"meta":45,"style":45},"language-json shiki shiki-themes github-light github-dark","{\n  \"markdown.editor.filePaste.enabled\": \"always\",\n  \"markdown.copyFiles.destination\": {\n    \"**\u002Fcontent\u002Fposts\u002F*.md\": \"\u002Fpublic\u002Fimages\u002F${documentBaseName}\u002F${unixTime}.${fileExtName}\",\n    \"**\u002Fcontent\u002Fpages\u002F*.md\": \"\u002Fpublic\u002Fimages\u002Fpages\u002F${unixTime}.${fileExtName}\"\n  },\n  \"markdown.copyFiles.overwriteBehavior\": \"nameIncrementally\"\n}\n","json",[18,71,72,81,98,107,120,131,137,148],{"__ignoreMap":45},[73,74,77],"span",{"class":75,"line":76},"line",1,[73,78,80],{"class":79},"sVt8B","{\n",[73,82,84,88,91,95],{"class":75,"line":83},2,[73,85,87],{"class":86},"sj4cs","  \"markdown.editor.filePaste.enabled\"",[73,89,90],{"class":79},": ",[73,92,94],{"class":93},"sZZnC","\"always\"",[73,96,97],{"class":79},",\n",[73,99,101,104],{"class":75,"line":100},3,[73,102,103],{"class":86},"  \"markdown.copyFiles.destination\"",[73,105,106],{"class":79},": {\n",[73,108,110,113,115,118],{"class":75,"line":109},4,[73,111,112],{"class":86},"    \"**\u002Fcontent\u002Fposts\u002F*.md\"",[73,114,90],{"class":79},[73,116,117],{"class":93},"\"\u002Fpublic\u002Fimages\u002F${documentBaseName}\u002F${unixTime}.${fileExtName}\"",[73,119,97],{"class":79},[73,121,123,126,128],{"class":75,"line":122},5,[73,124,125],{"class":86},"    \"**\u002Fcontent\u002Fpages\u002F*.md\"",[73,127,90],{"class":79},[73,129,130],{"class":93},"\"\u002Fpublic\u002Fimages\u002Fpages\u002F${unixTime}.${fileExtName}\"\n",[73,132,134],{"class":75,"line":133},6,[73,135,136],{"class":79},"  },\n",[73,138,140,143,145],{"class":75,"line":139},7,[73,141,142],{"class":86},"  \"markdown.copyFiles.overwriteBehavior\"",[73,144,90],{"class":79},[73,146,147],{"class":93},"\"nameIncrementally\"\n",[73,149,151],{"class":75,"line":150},8,[73,152,153],{"class":79},"}\n",[51,155,157],{"id":156},"使用-md-image-uploader推薦","使用 MD Image Uploader（推薦）",[14,159,160,163],{},[18,161,162],{},"MD Image Uploader"," 可以在 Markdown 中直接粘貼圖片，將圖片轉換為 WebP 後上傳到兼容 S3 的對象存儲，並自動插入 CDN 圖片鏈接。",[14,165,166],{},"插件下載地址：",[14,168,169],{},[29,170,171],{"href":171,"rel":172},"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=tungchiahui.md-image-uploader",[33],[14,174,175],{},[43,176],{"alt":45,"src":177},"https:\u002F\u002Fcdn.tungchiahui.cn\u002Ftungwebsite\u002Fassets\u002Fimages\u002F2025\u002F12\u002F25\u002F1787036910208-ed1a73d9.webp",[14,179,180,181,184],{},"也可以在 VS Code 擴展面板中搜索 ",[18,182,183],{},"tungchiahui.md-image-uploader","，然後點擊“安裝”。",[14,186,187,188,191,192,194],{},"訪問密鑰屬於敏感信息，請打開 VS Code 的",[18,189,190],{},"首选项：打开用户设置(JSON)","，將下面兩項寫入個人設置。不要將它們放進項目的 ",[18,193,63],{},"，也不要提交到 Git：",[65,196,198],{"className":67,"code":197,"language":69,"meta":45,"style":45},"\u002F\u002F 请放到个人设置，不要放到项目的 .vscode\u002Fsettings.json\n\"mdImageUploader.s3.accessKeyId\": \"xxxxxxxxxxxxxxxxxxxx\",\n\"mdImageUploader.s3.secretAccessKey\": \"xxxxxxxxxxxxxxxxxxxx\"\n",[18,199,200,206,218],{"__ignoreMap":45},[73,201,202],{"class":75,"line":76},[73,203,205],{"class":204},"sJ8bj","\u002F\u002F 请放到个人设置，不要放到项目的 .vscode\u002Fsettings.json\n",[73,207,208,211,213,216],{"class":75,"line":83},[73,209,210],{"class":93},"\"mdImageUploader.s3.accessKeyId\"",[73,212,90],{"class":79},[73,214,215],{"class":93},"\"xxxxxxxxxxxxxxxxxxxx\"",[73,217,97],{"class":79},[73,219,220,223,225],{"class":75,"line":100},[73,221,222],{"class":93},"\"mdImageUploader.s3.secretAccessKey\"",[73,224,90],{"class":79},[73,226,227],{"class":93},"\"xxxxxxxxxxxxxxxxxxxx\"\n",[14,229,230,231,233],{},"以下配置可以放到項目的 ",[18,232,63],{},"。這是騰訊雲 COS 的配置示例，請根據自己的存儲桶和 CDN 地址進行修改：",[65,235,239],{"className":236,"code":237,"language":238,"meta":45,"style":45},"language-jsonc shiki shiki-themes github-light github-dark","{\n  \u002F\u002F 可以放到 settings.json 的部分，以下是例子\n  \"mdImageUploader.s3.endpoint\": \"https:\u002F\u002Fcos.ap-beijing.myqcloud.com\",\n  \"mdImageUploader.s3.region\": \"ap-beijing\",\n  \"mdImageUploader.s3.bucket\": \"cdn-tungchiahui-cn-1377333392\",\n  \"mdImageUploader.cdnUrl\": \"https:\u002F\u002Fcdn.tungchiahui.cn\",\n  \"mdImageUploader.datedUploadPath\": \"\u002Ftungwebsite\u002Fassets\u002Fimages\",\n  \"mdImageUploader.undatedUploadPath\": \"\u002Ftungwebsite\u002Fassets\u002Fimages\u002Fundate\"\n}\n","jsonc",[18,240,241,245,250,255,260,265,270,275,280],{"__ignoreMap":45},[73,242,243],{"class":75,"line":76},[73,244,80],{},[73,246,247],{"class":75,"line":83},[73,248,249],{},"  \u002F\u002F 可以放到 settings.json 的部分，以下是例子\n",[73,251,252],{"class":75,"line":100},[73,253,254],{},"  \"mdImageUploader.s3.endpoint\": \"https:\u002F\u002Fcos.ap-beijing.myqcloud.com\",\n",[73,256,257],{"class":75,"line":109},[73,258,259],{},"  \"mdImageUploader.s3.region\": \"ap-beijing\",\n",[73,261,262],{"class":75,"line":122},[73,263,264],{},"  \"mdImageUploader.s3.bucket\": \"cdn-tungchiahui-cn-1377333392\",\n",[73,266,267],{"class":75,"line":133},[73,268,269],{},"  \"mdImageUploader.cdnUrl\": \"https:\u002F\u002Fcdn.tungchiahui.cn\",\n",[73,271,272],{"class":75,"line":139},[73,273,274],{},"  \"mdImageUploader.datedUploadPath\": \"\u002Ftungwebsite\u002Fassets\u002Fimages\",\n",[73,276,277],{"class":75,"line":150},[73,278,279],{},"  \"mdImageUploader.undatedUploadPath\": \"\u002Ftungwebsite\u002Fassets\u002Fimages\u002Fundate\"\n",[73,281,283],{"class":75,"line":282},9,[73,284,153],{},[14,286,287,288,291,292,294],{},"配置完成後，打開一個 Markdown 文件，複製截圖或本地圖片，然後按 ",[18,289,290],{},"Ctrl+V"," 粘貼。插件會依次轉換圖片、計算上傳路徑、上傳到對象存儲，並將最終的 Markdown 圖片鏈接插入當前位置。可以在 VS Code 的“輸出”面板中選擇 ",[18,293,162],{}," 查看實時日誌。",[14,296,297],{},"上傳路徑使用以下日期優先級：",[299,300,301,309,315],"ol",{},[302,303,304,305,308],"li",{},"優先讀取距離當前 Markdown 最近的、包含合法 ",[18,306,307],{},"YYYY-MM-DD"," 日期的父目錄；",[302,310,311,312,314],{},"父目錄沒有合法日期時，讀取 Markdown 文件名中的",[18,313,307],{},"格式日期；",[302,316,317,318,321],{},"兩處都沒有日期時，使用粘貼當天的本地日期和 ",[18,319,320],{},"undatedUploadPath","。",[14,323,324,325,328,329,332,333,336],{},"例如當前文件位於 ",[18,326,327],{},"content\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0200-环境搭建.md","，圖片會使用目錄日期 ",[18,330,331],{},"2025-12-25","，上傳到 ",[18,334,335],{},"datedUploadPath"," 對應的年月日目錄。",[10,338,339],{"id":339},"創建第一個md文件",[14,341,342],{},"打開VScode",[14,344,345],{},"創建一個.md為擴展名的文件",[14,347,348,349,352],{},"將文件保存為 ",[18,350,351],{},"TEST.md","（注意擴展名是 .md）",[14,354,355],{},"裡面內容改為:",[65,357,361],{"className":358,"code":359,"language":360,"meta":45,"style":45},"language-markdown shiki shiki-themes github-light github-dark","# 我的第一个 Markdown 文档\n\n这是我学习 Markdown 的开始。\n\n## 学习目标\n\n- 掌握基本语法\n- 了解应用场景\n- 能够独立创作文档\n\n## 今天的感受\n\n学习 Markdown 比我想象的**简单**，我对接下来的学习充满*期待*！\n\n---\n\n> 学习是一个持续的过程，每一小步都是进步。\n","markdown",[18,362,363,368,374,379,383,388,392,397,402,407,412,418,423,429,434,440,445],{"__ignoreMap":45},[73,364,365],{"class":75,"line":76},[73,366,367],{},"# 我的第一个 Markdown 文档\n",[73,369,370],{"class":75,"line":83},[73,371,373],{"emptyLinePlaceholder":372},true,"\n",[73,375,376],{"class":75,"line":100},[73,377,378],{},"这是我学习 Markdown 的开始。\n",[73,380,381],{"class":75,"line":109},[73,382,373],{"emptyLinePlaceholder":372},[73,384,385],{"class":75,"line":122},[73,386,387],{},"## 学习目标\n",[73,389,390],{"class":75,"line":133},[73,391,373],{"emptyLinePlaceholder":372},[73,393,394],{"class":75,"line":139},[73,395,396],{},"- 掌握基本语法\n",[73,398,399],{"class":75,"line":150},[73,400,401],{},"- 了解应用场景\n",[73,403,404],{"class":75,"line":282},[73,405,406],{},"- 能够独立创作文档\n",[73,408,410],{"class":75,"line":409},10,[73,411,373],{"emptyLinePlaceholder":372},[73,413,415],{"class":75,"line":414},11,[73,416,417],{},"## 今天的感受\n",[73,419,421],{"class":75,"line":420},12,[73,422,373],{"emptyLinePlaceholder":372},[73,424,426],{"class":75,"line":425},13,[73,427,428],{},"学习 Markdown 比我想象的**简单**，我对接下来的学习充满*期待*！\n",[73,430,432],{"class":75,"line":431},14,[73,433,373],{"emptyLinePlaceholder":372},[73,435,437],{"class":75,"line":436},15,[73,438,439],{},"---\n",[73,441,443],{"class":75,"line":442},16,[73,444,373],{"emptyLinePlaceholder":372},[73,446,448],{"class":75,"line":447},17,[73,449,450],{},"> 学习是一个持续的过程，每一小步都是进步。\n",[14,452,453],{},"點擊下方這個圖標可以預覽.",[14,455,456],{},[43,457],{"alt":45,"src":458},"https:\u002F\u002Fcdn.tungchiahui.cn\u002Ftungwebsite\u002Fassets\u002Fimages\u002F2025\u002F12\u002F25\u002F1787037063137-1d47eb79.webp",[14,460,461],{},"預覽如下圖:",[14,463,464],{},[43,465],{"alt":45,"src":466},"https:\u002F\u002Fcdn.tungchiahui.cn\u002Ftungwebsite\u002Fassets\u002Fimages\u002F2025\u002F12\u002F25\u002F1787036989834-c52de7a3.webp",[468,469,470],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":45,"searchDepth":83,"depth":83,"links":472},[473,474],{"id":53,"depth":83,"text":54},{"id":156,"depth":83,"text":157},"\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian",0,"0200","首先可以安裝一個VScode插件叫做Markdown All in One,然後還有Markdown Preview Enhanced.","wiki\u002F2025-12-25-markdown-jiao-cheng","zh-tw:2025-12-25-markdown-jiao-cheng","\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng","MarkDown教程","md","wiki\u002F2025-12-25-MarkDown教程\u002F0200-环境搭建",false,null,"zh-TW","zh-tw",{},{"title":5,"description":478},"\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian","_i18n\u002Fzh-tw\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0200-环境搭建","8MWub5pafg_v0zk8eWIgrgTV_KL4jaNp0nLNwvXcINI",[495,500,501,506,511],{"path":496,"stem":497,"title":498,"date":331,"chapterOrder":499,"chapterDepth":476,"docKey":480,"docRoot":481,"docTitle":482,"isWikiDoc":372,"isWikiIndex":485},"\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0100-jian-jie","_i18n\u002Fzh-tw\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0100-简介","簡介","0100",{"path":475,"stem":492,"title":5,"date":331,"chapterOrder":477,"chapterDepth":476,"docKey":480,"docRoot":481,"docTitle":482,"isWikiDoc":372,"isWikiIndex":485},{"path":502,"stem":503,"title":504,"date":331,"chapterOrder":505,"chapterDepth":476,"docKey":480,"docRoot":481,"docTitle":482,"isWikiDoc":372,"isWikiIndex":485},"\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0300-jiao-xue","_i18n\u002Fzh-tw\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0300-教学","教學","0300",{"path":507,"stem":508,"title":509,"date":331,"chapterOrder":510,"chapterDepth":476,"docKey":480,"docRoot":481,"docTitle":482,"isWikiDoc":372,"isWikiIndex":485},"\u002Fzh-tw\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0400-gao-ji-ji-qiao","_i18n\u002Fzh-tw\u002Fwiki\u002F2025-12-25-MarkDown教程\u002F0400-高级技巧","高級技巧","0400",{"path":481,"stem":512,"title":482,"date":331,"chapterOrder":486,"chapterDepth":476,"docKey":480,"docRoot":481,"docTitle":482,"isWikiDoc":372,"isWikiIndex":372},"_i18n\u002Fzh-tw\u002Fwiki\u002F2025-12-25-MarkDown教程\u002Findex",{"variants":514},[515,518,521,524,525],{"path":516,"localeSlug":517,"i18nKey":484},"\u002Fen-us\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian","en-us",{"path":519,"localeSlug":520,"i18nKey":484},"\u002Fzh-hant\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian","zh-hant",{"path":522,"localeSlug":523,"i18nKey":484},"\u002Fzh-hk\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian","zh-hk",{"path":475,"localeSlug":488,"i18nKey":484},{"path":526,"localeSlug":527,"i18nKey":484},"\u002Fzh-cn\u002Fwiki\u002F2025-12-25-markdown-jiao-cheng\u002F0200-huan-jing-da-jian","zh-cn",[516,491,519,491,522,491,475,491,526,491],1788531253143]