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