[{"data":1,"prerenderedAt":1298},["ShallowReactive",2],{"home-posts":3},[4],{"id":5,"title":6,"body":7,"description":1284,"draft":1285,"extension":1286,"meta":1287,"navigation":317,"path":1288,"publishedAt":1289,"seo":1290,"stem":1291,"tags":1292,"updatedAt":1296,"__hash__":1297},"posts\u002Fposts\u002Fguides\u002Fmarkdown-writing\u002Fzh-cn.md","Markdown 文章编写指南",{"type":8,"value":9,"toc":1270},"minimark",[10,14,18,26,36,55,159,162,165,169,213,217,237,241,247,251,254,257,260,263,285,288,303,306,332,335,418,421,428,561,564,583,586,592,595,598,604,607,614,630,637,642,679,682,695,832,1095,1098,1102,1125,1133,1136,1140,1157,1164,1181,1184,1187,1205,1208,1240,1243,1266],[11,12,13],"p",{},"这是一篇可以直接作为模板参考的文章，也是一份覆盖本站文章排版能力的验收样本。写作时优先表达内容和结构；页面会在构建期处理代码高亮、公式、图片与图表，不需要把展示逻辑写进正文。",[15,16,17],"h2",{"id":17},"从一份文章文件开始",[11,19,20,21,25],{},"每篇文章位于 ",[22,23,24],"code",{},"content\u002Fposts\u002F\u003CarticleKeyPath>\u002F\u003ClocaleCode>.md","。目录路径是跨语言共享的文章身份，文件名表示正文语言；例如：",[27,28,34],"pre",{"className":29,"code":31,"language":32,"meta":33},[30],"language-text","content\u002Fposts\u002Fnotes\u002Fmy-first-note\u002Fzh-cn.md\ncontent\u002Fposts\u002Fnotes\u002Fmy-first-note\u002Fen.md\n","text","",[22,35,31],{"__ignoreMap":33},[11,37,38,39,42,43,46,47,50,51,54],{},"文章开头必须有 Frontmatter。",[22,40,41],{},"title","、",[22,44,45],{},"description"," 与 ",[22,48,49],{},"publishedAt"," 是必填项；标签使用小写 ASCII kebab-case，草稿通过 ",[22,52,53],{},"draft: true"," 排除在公开页面之外。",[27,56,60],{"className":57,"code":58,"language":59,"meta":33,"style":33},"language-yaml shiki shiki-themes github-dark","---\ntitle: 一篇文章的标题\ndescription: 供文章列表、搜索结果和订阅源使用的简短摘要。\npublishedAt: 2026-08-11\nupdatedAt: 2026-08-12\ntags:\n  - markdown\n  - writing\ndraft: false\n---\n","yaml",[22,61,62,71,85,95,106,117,126,135,143,154],{"__ignoreMap":33},[63,64,67],"span",{"class":65,"line":66},"line",1,[63,68,70],{"class":69},"svObZ","---\n",[63,72,74,77,81],{"class":65,"line":73},2,[63,75,41],{"class":76},"s4JwU",[63,78,80],{"class":79},"s95oV",": ",[63,82,84],{"class":83},"sU2Wk","一篇文章的标题\n",[63,86,88,90,92],{"class":65,"line":87},3,[63,89,45],{"class":76},[63,91,80],{"class":79},[63,93,94],{"class":83},"供文章列表、搜索结果和订阅源使用的简短摘要。\n",[63,96,98,100,102],{"class":65,"line":97},4,[63,99,49],{"class":76},[63,101,80],{"class":79},[63,103,105],{"class":104},"sDLfK","2026-08-11\n",[63,107,109,112,114],{"class":65,"line":108},5,[63,110,111],{"class":76},"updatedAt",[63,113,80],{"class":79},[63,115,116],{"class":104},"2026-08-12\n",[63,118,120,123],{"class":65,"line":119},6,[63,121,122],{"class":76},"tags",[63,124,125],{"class":79},":\n",[63,127,129,132],{"class":65,"line":128},7,[63,130,131],{"class":79},"  - ",[63,133,134],{"class":83},"markdown\n",[63,136,138,140],{"class":65,"line":137},8,[63,139,131],{"class":79},[63,141,142],{"class":83},"writing\n",[63,144,146,149,151],{"class":65,"line":145},9,[63,147,148],{"class":76},"draft",[63,150,80],{"class":79},[63,152,153],{"class":104},"false\n",[63,155,157],{"class":65,"line":156},10,[63,158,70],{"class":69},[15,160,161],{"id":161},"标题与基础文本",[11,163,164],{},"页面会使用文章标题作为唯一的一级标题，因此正文从二级标题开始。按内容层次递进标题，不要为了调节字号跳级。",[166,167,168],"h3",{"id":168},"三级标题",[11,170,171,172,42,176,42,180,184,185,188,189,193,194,198,199,203,204,208,209,212],{},"段落使用空行分隔。行内可以组合 ",[173,174,175],"em",{},"强调",[177,178,179],"strong",{},"加粗",[181,182,183],"del",{},"删除线"," 和 ",[22,186,187],{},"inline code","；也可以使用 ",[190,191,192],"mark",{},"高亮","、H",[195,196,197],"sub",{},"2","O、2",[200,201,202],"sup",{},"10","，以及 ",[205,206,207],"kbd",{},"Ctrl"," + ",[205,210,211],{},"K"," 这类键盘标记。",[214,215,216],"h4",{"id":216},"四级标题",[11,218,219,220,227,228,231,232,236],{},"链接既可以写成 ",[221,222,226],"a",{"href":223,"rel":224},"https:\u002F\u002Fwww.markdownguide.org\u002F",[225],"nofollow","带说明的链接","，也可以直接使用 ",[221,229,223],{"href":223,"rel":230},[225],"。涉及站内页面时优先使用根路径，例如",[221,233,235],{"href":234},"\u002Fzh-cn\u002Fposts\u002F","文章列表","。",[238,239,240],"h5",{"id":240},"五级标题",[242,243,244],"blockquote",{},[11,245,246],{},"引用适合保留原话、结论或需要读者特别注意的上下文。它应该补充正文，而不应替代正常的段落结构。",[248,249,250],"h6",{"id":250},"六级标题",[11,252,253],{},"短横线可用于分隔两段相对独立的内容：",[255,256],"hr",{},[15,258,259],{"id":259},"列表与表格",[11,261,262],{},"无序列表适合并列事项，缩进两个空格即可形成第二层：",[264,265,266,270],"ul",{},[267,268,269],"li",{},"先用一句话说明这一组项目的共同目标。",[267,271,272,273],{},"每个项目尽量使用相同的语法结构。\n",[264,274,275,278],{},[267,276,277],{},"第二层项目可以补充前一项。",[267,279,280,281,284],{},"行内代码仍然保持 ",[22,282,283],{},"monospace"," 字体。",[11,286,287],{},"有顺序的步骤应使用有序列表：",[289,290,291,294,297,300],"ol",{},[267,292,293],{},"新建语言对应的 Markdown 文件。",[267,295,296],{},"填写 Frontmatter 并编写正文。",[267,298,299],{},"运行内容校验或本地开发服务器。",[267,301,302],{},"确认页面后提交发布。",[11,304,305],{},"任务列表适合记录尚未完成的写作工作。它用于表达状态，不作为交互控件：",[264,307,310,320,326],{"className":308},[309],"contains-task-list",[267,311,314,319],{"className":312},[313],"task-list-item",[315,316],"input",{"checked":317,"disabled":317,"type":318},true,"checkbox"," 明确文章的主题和读者。",[267,321,323,325],{"className":322},[313],[315,324],{"checked":317,"disabled":317,"type":318}," 为图片和图表提供替代文本。",[267,327,329,331],{"className":328},[313],[315,330],{"disabled":317,"type":318}," 完成校对与链接检查。",[11,333,334],{},"表格适合比较结构一致的信息。单元格内容较长或列数较多时，读者可以只在表格区域横向滚动。",[336,337,338,357],"table",{},[339,340,341],"thead",{},[342,343,344,349,353],"tr",{},[345,346,348],"th",{"align":347},"left","写作元素",[345,350,352],{"align":351},"center","推荐写法",[345,354,356],{"align":355},"right","适用场景",[358,359,360,378,391,405],"tbody",{},[342,361,362,366,375],{},[363,364,365],"td",{"align":347},"标题",[363,367,368,371,372],{"align":351},[22,369,370],{},"##"," 至 ",[22,373,374],{},"######",[363,376,377],{"align":355},"组织章节层次",[342,379,380,383,388],{},[363,381,382],{"align":347},"链接",[363,384,385],{"align":351},[22,386,387],{},"[说明](URL)",[363,389,390],{"align":355},"提供可追溯的来源",[342,392,393,396,402],{},[363,394,395],{"align":347},"代码",[363,397,398,401],{"align":351},[22,399,400],{},"`code`"," 或围栏",[363,403,404],{"align":355},"保留命令、标识符和示例",[342,406,407,410,415],{},[363,408,409],{"align":347},"图片",[363,411,412],{"align":351},[22,413,414],{},"![alt](src)",[363,416,417],{"align":355},"补充无法由文字准确表达的信息",[15,419,420],{"id":420},"代码与技术片段",[11,422,423,424,427],{},"短标识符、命令和文件名使用行内代码，例如 ",[22,425,426],{},"npm run content:check","。多行内容使用代码围栏；注明语言后会获得语法高亮。",[27,429,435],{"className":430,"code":431,"filename":432,"highlights":433,"language":434,"meta":33,"style":33},"language-ts shiki shiki-themes github-dark","interface ArticleMetadata {\n  title: string;\n  publishedAt: string;\n  tags: string[];\n}\n\nconst metadata: ArticleMetadata = {\n  title: '一篇文章的标题',\n  publishedAt: '2026-08-11',\n  tags: ['markdown', 'writing'],\n};\n","article-metadata.ts",[87,137],"ts",[22,436,437,449,464,477,489,494,499,516,528,538,555],{"__ignoreMap":33},[63,438,439,443,446],{"class":65,"line":66},[63,440,442],{"class":441},"snl16","interface",[63,444,445],{"class":69}," ArticleMetadata",[63,447,448],{"class":79}," {\n",[63,450,451,455,458,461],{"class":65,"line":73},[63,452,454],{"class":453},"s9osk","  title",[63,456,457],{"class":441},":",[63,459,460],{"class":104}," string",[63,462,463],{"class":79},";\n",[63,465,468,471,473,475],{"class":466,"line":87},[65,467],"highlight",[63,469,470],{"class":453},"  publishedAt",[63,472,457],{"class":441},[63,474,460],{"class":104},[63,476,463],{"class":79},[63,478,479,482,484,486],{"class":65,"line":97},[63,480,481],{"class":453},"  tags",[63,483,457],{"class":441},[63,485,460],{"class":104},[63,487,488],{"class":79},"[];\n",[63,490,491],{"class":65,"line":108},[63,492,493],{"class":79},"}\n",[63,495,496],{"class":65,"line":119},[63,497,498],{"emptyLinePlaceholder":317},"\n",[63,500,501,504,507,509,511,514],{"class":65,"line":128},[63,502,503],{"class":441},"const",[63,505,506],{"class":104}," metadata",[63,508,457],{"class":441},[63,510,445],{"class":69},[63,512,513],{"class":441}," =",[63,515,448],{"class":79},[63,517,519,522,525],{"class":518,"line":137},[65,467],[63,520,521],{"class":79},"  title: ",[63,523,524],{"class":83},"'一篇文章的标题'",[63,526,527],{"class":79},",\n",[63,529,530,533,536],{"class":65,"line":145},[63,531,532],{"class":79},"  publishedAt: ",[63,534,535],{"class":83},"'2026-08-11'",[63,537,527],{"class":79},[63,539,540,543,546,549,552],{"class":65,"line":156},[63,541,542],{"class":79},"  tags: [",[63,544,545],{"class":83},"'markdown'",[63,547,548],{"class":79},", ",[63,550,551],{"class":83},"'writing'",[63,553,554],{"class":79},"],\n",[63,556,558],{"class":65,"line":557},11,[63,559,560],{"class":79},"};\n",[11,562,563],{},"方括号中的文件名和花括号中的行号都是可选的。超长代码行会只在代码块自身内部滚动，不会撑宽整篇文章：",[27,565,567],{"className":430,"code":566,"language":434,"meta":33,"style":33},"const longLine = '这是一行刻意写得很长的示例代码，用于确认横向滚动被限制在代码块内部，并且不会让文章页面在窄屏上产生额外的水平滚动。';\n",[22,568,569],{"__ignoreMap":33},[63,570,571,573,576,578,581],{"class":65,"line":66},[63,572,503],{"class":441},[63,574,575],{"class":104}," longLine",[63,577,513],{"class":441},[63,579,580],{"class":83}," '这是一行刻意写得很长的示例代码，用于确认横向滚动被限制在代码块内部，并且不会让文章页面在窄屏上产生额外的水平滚动。'",[63,582,463],{"class":79},[11,584,585],{},"没有对应语言的纯文本也可以使用普通围栏：",[27,587,590],{"className":588,"code":589,"language":32},[30],"第一行保持原样。\n    缩进和空格同样会保留。\n",[22,591,589],{"__ignoreMap":33},[15,593,594],{"id":594},"图片与图注",[11,596,597],{},"Markdown 图片必须提供有意义的替代文本。独占段落中的图片默认是块级元素，默认宽度适应正文；点击带替代文本的图片可以打开单图预览。",[599,600],"article-image",{"alt":601,"src":602,"layout":603},"Markdown 文章从源文件到静态页面的构建流程","\u002Fimages\u002Fmarkdown-flow.svg","block",[11,605,606],{},"图片属性写在图片后的属性块中。下面的示例同时演示定宽、居中、图注、懒加载、异步解码，以及深色主题下替换图源的写法：",[599,608],{"alt":609,"src":602,"width":610,"align":351,"caption":611,"dark-src":602,"decoding":612,"loading":613,"layout":603},"带图注的 Markdown 构建流程","34rem","图 1：可控制尺寸、对齐方式与图注的块级图片","async","lazy",[11,615,616,617,625,626,629],{},"行内图片不会中断文字流：构建状态为 ",[618,619],"img",{"alt":620,"src":621,"width":622,"layout":623,"vertical-align":624},"文章构建状态标记","\u002Fimages\u002Farticle-image-marker.svg","1em","inline","middle"," 已通过。纯装饰图片使用空替代文本，并显式关闭预览： ",[618,627],{"alt":33,"src":621,"width":622,"layout":623,"vertical-align":624,"preview":628},"false"," 。",[11,631,632,633,636],{},"原始 HTML 的 ",[22,634,635],{},"\u003Cimg>"," 也会进入同一套图片组件，适合从已有内容迁移；新文章仍优先使用 Markdown 写法：",[599,638],{"src":602,"alt":639,"width":640,"align":641,"preview":628,"layout":603},"使用 HTML img 元素插入的构建流程图","24rem","end",[11,643,644,645,42,648,42,651,42,654,42,657,42,660,42,663,184,666,669,670,46,672,675,676,678],{},"块级图片可使用 ",[22,646,647],{},"width",[22,649,650],{},"height",[22,652,653],{},"align",[22,655,656],{},"caption",[22,658,659],{},"dark-src",[22,661,662],{},"loading",[22,664,665],{},"decoding",[22,667,668],{},"preview","。行内图片使用 ",[22,671,647],{},[22,673,674],{},"vertical-align","；图注和 ",[22,677,653],{}," 只适用于块级图片。",[15,680,681],{"id":681},"脚注与公式",[11,683,684,685,694],{},"脚注适合补充不应打断正文的来源或说明。",[200,686,687],{},[221,688,693],{"href":689,"ariaDescribedBy":690,"dataFootnoteRef":33,"id":692},"#user-content-fn-content-boundary",[691],"footnote-label","user-content-fnref-content-boundary","1"," 同一篇文章可以有多条脚注，并会在文末自动汇总。",[11,696,697,698,701,702,827,828,831],{},"行内公式使用 ",[22,699,700],{},"$...$","，例如 ",[63,703,706,745],{"className":704},[705],"katex",[63,707,710],{"className":708},[709],"katex-mathml",[711,712,714],"math",{"xmlns":713},"http:\u002F\u002Fwww.w3.org\u002F1998\u002FMath\u002FMathML",[715,716,717,740],"semantics",{},[718,719,720,724,728,731],"mrow",{},[721,722,723],"mi",{},"E",[725,726,727],"mo",{},"=",[721,729,730],{},"m",[732,733,734,737],"msup",{},[721,735,736],{},"c",[738,739,197],"mn",{},[741,742,744],"annotation",{"encoding":743},"application\u002Fx-tex","E = mc^2",[63,746,750,777],{"className":747,"ariaHidden":749},[748],"katex-html","true",[63,751,754,759,765,770,774],{"className":752},[753],"base",[63,755],{"className":756,"style":758},[757],"strut","height:0.6833em;",[63,760,723],{"className":761,"style":764},[762,763],"mord","mathnormal","margin-right:0.0576em;",[63,766],{"className":767,"style":769},[768],"mspace","margin-right:0.2778em;",[63,771,727],{"className":772},[773],"mrel",[63,775],{"className":776,"style":769},[768],[63,778,780,784,787],{"className":779},[753],[63,781],{"className":782,"style":783},[757],"height:0.8141em;",[63,785,730],{"className":786},[762,763],[63,788,790,793],{"className":789},[762],[63,791,736],{"className":792},[762,763],[63,794,797],{"className":795},[796],"msupsub",[63,798,801],{"className":799},[800],"vlist-t",[63,802,805],{"className":803},[804],"vlist-r",[63,806,809],{"className":807,"style":783},[808],"vlist",[63,810,812,817],{"style":811},"top:-3.063em;margin-right:0.05em;",[63,813],{"className":814,"style":816},[815],"pstrut","height:2.7em;",[63,818,824],{"className":819},[820,821,822,823],"sizing","reset-size6","size3","mtight",[63,825,197],{"className":826},[762,823],"。单独成行的公式使用 ",[22,829,830],{},"$$...$$","：",[63,833,836],{"className":834},[835],"katex-display",[63,837,839,889],{"className":838},[705],[63,840,842],{"className":841},[709],[711,843,844],{"xmlns":713,"display":603},[715,845,846,886],{},[718,847,848,859,866,870,874,876,878],{},[849,850,851,854,857],"msubsup",{},[725,852,853],{},"∫",[738,855,856],{},"0",[738,858,693],{},[732,860,861,864],{},[721,862,863],{},"x",[738,865,197],{},[867,868,869],"mtext",{}," ",[721,871,873],{"mathvariant":872},"normal","d",[721,875,863],{},[725,877,727],{},[879,880,881,883],"mfrac",{},[738,882,693],{},[738,884,885],{},"3",[741,887,888],{"encoding":743},"\\int_0^1 x^2\\,\\mathrm{d}x = \\frac{1}{3}",[63,890,892,1015],{"className":891,"ariaHidden":749},[748],[63,893,895,899,961,965,996,999,1003,1006,1009,1012],{"className":894},[753],[63,896],{"className":897,"style":898},[757],"height:2.476em;vertical-align:-0.9119em;",[63,900,903,909],{"className":901},[902],"mop",[63,904,853],{"className":905,"style":908},[902,906,907],"op-symbol","large-op","margin-right:0.4445em;position:relative;top:-0.0011em;",[63,910,912],{"className":911},[796],[63,913,916,952],{"className":914},[800,915],"vlist-t2",[63,917,919,947],{"className":918},[804],[63,920,923,935],{"className":921,"style":922},[808],"height:1.564em;",[63,924,926,929],{"style":925},"top:-1.7881em;margin-left:-0.4445em;margin-right:0.05em;",[63,927],{"className":928,"style":816},[815],[63,930,932],{"className":931},[820,821,822,823],[63,933,856],{"className":934},[762,823],[63,936,938,941],{"style":937},"top:-3.8129em;margin-right:0.05em;",[63,939],{"className":940,"style":816},[815],[63,942,944],{"className":943},[820,821,822,823],[63,945,693],{"className":946},[762,823],[63,948,951],{"className":949},[950],"vlist-s","​",[63,953,955],{"className":954},[804],[63,956,959],{"className":957,"style":958},[808],"height:0.9119em;",[63,960],{},[63,962],{"className":963,"style":964},[768],"margin-right:0.1667em;",[63,966,968,971],{"className":967},[762],[63,969,863],{"className":970},[762,763],[63,972,974],{"className":973},[796],[63,975,977],{"className":976},[800],[63,978,980],{"className":979},[804],[63,981,984],{"className":982,"style":983},[808],"height:0.8641em;",[63,985,987,990],{"style":986},"top:-3.113em;margin-right:0.05em;",[63,988],{"className":989,"style":816},[815],[63,991,993],{"className":992},[820,821,822,823],[63,994,197],{"className":995},[762,823],[63,997],{"className":998,"style":964},[768],[63,1000,873],{"className":1001},[762,1002],"mathrm",[63,1004,863],{"className":1005},[762,763],[63,1007],{"className":1008,"style":769},[768],[63,1010,727],{"className":1011},[773],[63,1013],{"className":1014,"style":769},[768],[63,1016,1018,1022],{"className":1017},[753],[63,1019],{"className":1020,"style":1021},[757],"height:2.0074em;vertical-align:-0.686em;",[63,1023,1025,1030,1091],{"className":1024},[762],[63,1026],{"className":1027},[1028,1029],"mopen","nulldelimiter",[63,1031,1033],{"className":1032},[879],[63,1034,1036,1082],{"className":1035},[800,915],[63,1037,1039,1079],{"className":1038},[804],[63,1040,1043,1056,1067],{"className":1041,"style":1042},[808],"height:1.3214em;",[63,1044,1046,1050],{"style":1045},"top:-2.314em;",[63,1047],{"className":1048,"style":1049},[815],"height:3em;",[63,1051,1053],{"className":1052},[762],[63,1054,885],{"className":1055},[762],[63,1057,1059,1062],{"style":1058},"top:-3.23em;",[63,1060],{"className":1061,"style":1049},[815],[63,1063],{"className":1064,"style":1066},[1065],"frac-line","border-bottom-width:0.04em;",[63,1068,1070,1073],{"style":1069},"top:-3.677em;",[63,1071],{"className":1072,"style":1049},[815],[63,1074,1076],{"className":1075},[762],[63,1077,693],{"className":1078},[762],[63,1080,951],{"className":1081},[950],[63,1083,1085],{"className":1084},[804],[63,1086,1089],{"className":1087,"style":1088},[808],"height:0.686em;",[63,1090],{},[63,1092],{"className":1093},[1094,1029],"mclose",[11,1096,1097],{},"公式由构建期 KaTeX 处理；较宽的公式只在自身区域内横向滚动。",[15,1099,1101],{"id":1100},"mermaid-流程图","Mermaid 流程图",[11,1103,1104,1107,1108,1111,1112,42,1114,42,1116,184,1118,1120,1121,1124],{},[22,1105,1106],{},"mermaid"," 围栏会在构建期变成静态 SVG。它必须提供 ",[22,1109,1110],{},"alt","，也支持与块级图片相同的 ",[22,1113,656],{},[22,1115,647],{},[22,1117,653],{},[22,1119,668],{}," 属性。默认 ",[22,1122,1123],{},"color-scheme=\"auto\""," 会为浅色和深色页面生成对应图源。",[599,1126],{"alt":1127,"src":1128,"dark-src":1129,"layout":603,"caption":1130,"width":1131,"align":351,"loading":613,"decoding":612,"data-diagram-kind":1106,"diagram-source":1132},"文章从 Markdown 源文件到读者页面的构建流程","\u002F_diagram-assets\u002F2836b5eee00f79f284179cc218db9547529a91a8b558506de1f6e5a8b908ae51.light.svg","\u002F_diagram-assets\u002Ffce45f489fa8b58485f6ec42180feb1449fd5b1086310b06ce62f889deac3520.dark.svg","图 2：构建期转换的 Mermaid 流程图","42rem","flowchart LR\n  source[Markdown 源文件] --> content[Nuxt Content]\n  content --> page[静态文章页面]\n  page --> reader[读者]",[11,1134,1135],{},"图表源码应表达关系本身，不要在浏览器端依赖 Mermaid 运行时或手工嵌入 SVG。",[15,1137,1139],{"id":1138},"tikz-数学图","TikZ 数学图",[11,1141,1142,1145,1146,46,1149,1152,1153,1156],{},[22,1143,1144],{},"tikz"," 围栏同样在构建期生成静态 SVG，但必须包含完整的 ",[22,1147,1148],{},"\\begin{document}",[22,1150,1151],{},"\\end{document}","。下面的示例使用灰色填充，因此固定为 ",[22,1154,1155],{},"color-scheme=\"light\"","，让它在深色页面中仍保留浅色画布和足够的对比度。",[599,1158],{"alt":1159,"src":1160,"layout":603,"caption":1161,"width":1162,"align":351,"loading":613,"decoding":612,"data-diagram-kind":1144,"diagram-source":1163},"带极角标记的单位圆","\u002F_diagram-assets\u002Fe0442f5bd66dc98d21aad02389f6c1d88dc18de3adb28b052ab7ea42e6244336.fixed.svg","图 3：固定浅色画布的 TikZ 单位圆","26rem","\\begin{document}\n\\begin{tikzpicture}[scale=2]\n  \\draw[thick] (0,0) circle (1);\n  \\fill[gray!30] (0,0) circle (1);\n  \\draw[->] (-1.3,0) -- (1.3,0) node[right] {$x$};\n  \\draw[->] (0,-1.3) -- (0,1.3) node[above] {$y$};\n  \\draw (0,0) -- (60:1.2);\n  \\draw[->] (0.35,0) arc (0:60:0.35) node[midway, right] {$\\theta$};\n  \\node at (0.5,0.5) {$D$};\n\\end{tikzpicture}\n\\end{document}",[11,1165,1166,1169,1170,42,1173,1176,1177,1180],{},[22,1167,1168],{},"color-scheme"," 可取 ",[22,1171,1172],{},"auto",[22,1174,1175],{},"light"," 或 ",[22,1178,1179],{},"dark","。自动模式会随页面主题切换；固定模式只生成一份带背景的 SVG，适合需要稳定纸张色或包含浅灰填充的图。打开可预览的 Mermaid 或 TikZ 图表灯箱后，可以复制实际用于渲染的围栏内部源码；复制内容不包含 Markdown 围栏和展示属性。",[15,1182,1183],{"id":1183},"发布前检查",[11,1185,1186],{},"完成文章后，在本地至少执行一次内容校验：",[27,1188,1192],{"className":1189,"code":1190,"language":1191,"meta":33,"style":33},"language-bash shiki shiki-themes github-dark","npm run content:check\n","bash",[22,1193,1194],{"__ignoreMap":33},[63,1195,1196,1199,1202],{"class":65,"line":66},[63,1197,1198],{"class":69},"npm",[63,1200,1201],{"class":83}," run",[63,1203,1204],{"class":83}," content:check\n",[11,1206,1207],{},"准备发布时，再运行完整检查与静态生成：",[27,1209,1211],{"className":1189,"code":1210,"language":1191,"meta":33,"style":33},"npm run typecheck\nnpm run test:unit\nnpm run generate\n",[22,1212,1213,1222,1231],{"__ignoreMap":33},[63,1214,1215,1217,1219],{"class":65,"line":66},[63,1216,1198],{"class":69},[63,1218,1201],{"class":83},[63,1220,1221],{"class":83}," typecheck\n",[63,1223,1224,1226,1228],{"class":65,"line":73},[63,1225,1198],{"class":69},[63,1227,1201],{"class":83},[63,1229,1230],{"class":83}," test:unit\n",[63,1232,1233,1235,1237],{"class":65,"line":87},[63,1234,1198],{"class":69},[63,1236,1201],{"class":83},[63,1238,1239],{"class":83}," generate\n",[11,1241,1242],{},"写作质量最终来自清晰的结构、准确的替代文本、可验证的代码和必要的上下文。Markdown 只是一种表达工具；读者真正需要的是一篇可以顺畅阅读、引用和复查的文章。",[1244,1245,1248,1253],"section",{"className":1246,"dataFootnotes":33},[1247],"footnotes",[15,1249,1252],{"className":1250,"id":691},[1251],"sr-only","Footnotes",[289,1254,1255],{},[267,1256,1258,1259],{"id":1257},"user-content-fn-content-boundary","Frontmatter 描述文章metadata，Markdown正文表达内容；搜索、订阅和页面组件会在构建阶段读取各自需要的信息。 ",[221,1260,1265],{"href":1261,"ariaLabel":1262,"className":1263,"dataFootnoteBackref":33},"#user-content-fnref-content-boundary","Back to reference 1",[1264],"data-footnote-backref","↩",[1267,1268,1269],"style",{},"html pre.shiki code .svObZ, html code.shiki .svObZ{--shiki-default:#B392F0}html pre.shiki code .s4JwU, html code.shiki .s4JwU{--shiki-default:#85E89D}html pre.shiki code .s95oV, html code.shiki .s95oV{--shiki-default:#E1E4E8}html pre.shiki code .sU2Wk, html code.shiki .sU2Wk{--shiki-default:#9ECBFF}html pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}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 pre.shiki code .snl16, html code.shiki .snl16{--shiki-default:#F97583}html pre.shiki code .s9osk, html code.shiki .s9osk{--shiki-default:#FFAB70}",{"title":33,"searchDepth":73,"depth":73,"links":1271},[1272,1273,1276,1277,1278,1279,1280,1281,1282,1283],{"id":17,"depth":73,"text":17},{"id":161,"depth":73,"text":161,"children":1274},[1275],{"id":168,"depth":87,"text":168},{"id":259,"depth":73,"text":259},{"id":420,"depth":73,"text":420},{"id":594,"depth":73,"text":594},{"id":681,"depth":73,"text":681},{"id":1100,"depth":73,"text":1101},{"id":1138,"depth":73,"text":1139},{"id":1183,"depth":73,"text":1183},{"id":691,"depth":73,"text":1252},"面向本站作者的 Markdown 写作参考，覆盖基础排版、代码、图片、公式与静态图表。",false,"md",{},"\u002Fposts\u002Fguides\u002Fmarkdown-writing\u002Fzh-cn","2026-08-11",{"title":6,"description":1284},"posts\u002Fguides\u002Fmarkdown-writing\u002Fzh-cn",[1293,1294,1295],"markdown","writing","blog",null,"Gr3ZxDcUP7Ch_9kIKL1wh3K50EvQg9PJlg6lMdPOynw",1791307858879]