\n\n\nTrafficMonitor 是一款 Windows 平台的桌面悬浮窗软件，支持实时显示网络、硬件等信息，并支持任务栏显示、多种皮肤和插件系统。
\n
如果觉得不错给个 Star 支持一下吧🌟
\n提示
\n如果无法访问 GitHub 网站，可以通过镜像站下载
\n将下载的 AIBalance.dll 放在 TrafficMonitor 的 plugins 目录下
运行 TrafficMonitor.exe 主程序
在程序右键菜单中勾选显示任务栏窗口
\n在程序右键菜单中点击插件管理，应该能显示 AIBalance 插件和加载成功信息
\n![](\"/images/traffic-monitor-plugin-ai-balance/plugin-management.png\")
\n右键插件点击选项，在选项窗口填写 API Key，可设置刷新频率（默认 5 分钟）
\n![](\"/images/traffic-monitor-plugin-ai-balance/AIBalance-options.png\")
\n任务栏鼠标悬浮框内也会显示余额
\n![](\"/images/traffic-monitor-plugin-ai-balance/hover.png\")
\n支持的提供商
\n注意
\n调用 Xiaomi MiMo 接口需要自行提供 Cookie，且只有 1 天时效
\n在程序右键菜单中点击显示设置，勾选需要显示的 AI 账单余额
\n感谢 zhongyang219 开发者开发出本软件并提供插件系统
\n", "url": "https://blog.jursin.top/blog/tutorials/traffic-monitor-plugin-ai-balance.html", "title": "用 AI 写了一个在任务栏显示 AI 账单余额的 TrafficMonitor 插件", "summary": "TrafficMonitor 是一款 Windows 平台的桌面悬浮窗软件，支持实时显示网络、硬件等信息，并支持任务栏显示、多种皮肤和插件系统。", "date_modified": "2026-06-16T13:49:45.000Z", "tags": [ "教程", "TrafficMonitor" ] }, { "id": "https://blog.jursin.top/blog/resources/beautiful-website.html", "content_html": "\n\n\n收录一些不错的网站，包括在线工具集、下载站、系统工具、设计资源、字体和文档站框架等。
\n
在线工具集
\n\n下载站
\n插件＆脚本
\n系统工具
\n设计
\n文档站框架
\n提示
\n如发现有链接不宜展示、变更或是错误的，请在下方评论区告知或联系我。
\n\n\n\n收录一些实用的软件，涵盖文件管理、日常工具、系统维护、开发工具等。
\n
文件相关
\n日常工具
\n信息查询
\n远控&模拟
\n\n系统相关
\n系统美化
\n开发工具
\n提示
\n如发现有链接不宜展示、变更或是错误的，请在下方评论区告知或联系我。
\n\n\n\n因缺乏动力且需要更专注于大学生活，Awesome-Class-Softwares 基本停更，网页版也会下线并重定向到该博客页面。不过同类项目 Awesome Iwb 收集得更全，且网页版已上线，你仍可以通过该项目了解更多软件。
\n
课程表类
\n多功能类
\n看板类
\n批注类
\n辅助类
\n抽选类
\n\n\n\n\n通过 Steam 官方接口获取游戏库列表并展示在个人网站，需要通过云函数解决 CORS 跨域和 API Key 暴露等问题。
\n
前端组件 → 云函数代理 → Steam API这样做的两个好处：
\napi.steampowered.com 会被拦截，通过配置了 CORS 的云函数中转即可重要
\n妥善保管密钥，不要出现在前端代码、公共仓库或浏览器网络请求中。
\n两种方式任选：
\nhttps://steamcommunity.com/profiles/xxxxx/ 的 xxxxx 即为 Steam ID如阿里云函数计算 (FC)、腾讯云云函数 (SCF)、Cloudflare Workers、Vercel Functions、Netlify Functions 等
\n接收前端请求 → 拼接 Steam API 参数 → 转发 → 返回结果
\n前端 GET ${PROXY}/IPlayerService/GetOwnedGames/v1/?include_appinfo=true&include_played_free_games=true\n ↓\n云函数拼接完整 URL：\nhttps://api.steampowered.com/IPlayerService/GetOwnedGames/v1/?key={KEY}&steamid={ID}&include_appinfo=true&include_played_free_games=true\n ↓\n请求 Steam API，返回 JSON 给前端隐藏 API Key
\n提前携带 Key 参数，完成认证且避免暴露
\nCORS 响应头
\n云函数需要返回正确的 CORS 头，否则浏览器会拦截响应：
\nAccess-Control-Allow-Origin: https://your_domain\nAccess-Control-Allow-Methods: GET, OPTIONS对于预检请求（OPTIONS 方法），直接返回 204 空响应即可
\n组件只请求自己的云函数地址，不直接接触 Steam API：
\nGET ${PROXY}/IPlayerService/GetOwnedGames/v1/?include_appinfo=true&include_played_free_games=true| 参数 | \n类型 | \n必需 | \n默认值 | \n说明 | \n
|---|---|---|---|---|
| include_appinfo | \nboolean | \n否 | \nfalse | \n如果需要各游戏的更多信息（如名称、图标等），为 true | \n
| include_played_free_games | \nboolean | \n否 | \nfalse | \n默认不包含免费游戏。若设置，将返回用户玩过的免费游戏 | \n
| appids_filter | \nuint32 | \n否 | \n— | \n若设置，将结果集限制在传入的应用。格式为 appids_filter[0]=xxx，一次传一个 | \n
{\n \"response\": {\n \"game_count\": 5,\n \"games\": [\n {\n \"appid\": 105600,\n \"name\": \"Terraria\",\n \"playtime_forever\": 213,\n \"img_icon_url\": \"858961e95fbf869f136e1770d586e0caefd4cfac\",\n \"has_community_visible_stats\": true,\n \"playtime_windows_forever\": 213,\n \"playtime_mac_forever\": 0,\n \"playtime_linux_forever\": 0,\n \"playtime_deck_forever\": 0,\n \"rtime_last_played\": 1772289546,\n \"playtime_disconnected\": 2\n },\n {\n \"appid\": 255710,\n \"name\": \"Cities: Skylines\",\n \"playtime_forever\": 62,\n \"img_icon_url\": \"6cf7b10dd29db28448ef79698ed2118a03617d63\",\n \"has_community_visible_stats\": true,\n \"playtime_windows_forever\": 62,\n \"playtime_mac_forever\": 0,\n \"playtime_linux_forever\": 0,\n \"playtime_deck_forever\": 0,\n \"rtime_last_played\": 1754831594,\n \"playtime_disconnected\": 0\n },\n {\n \"appid\": 322330,\n \"name\": \"Don't Starve Together\",\n \"playtime_forever\": 113,\n \"img_icon_url\": \"a80aa6cff8eebc1cbc18c367d9ab063e1553b0ee\",\n \"playtime_windows_forever\": 113,\n \"playtime_mac_forever\": 0,\n \"playtime_linux_forever\": 0,\n \"playtime_deck_forever\": 0,\n \"rtime_last_played\": 1772286418,\n \"playtime_disconnected\": 1\n },\n {\n \"appid\": 413150,\n \"name\": \"Stardew Valley\",\n \"playtime_forever\": 198,\n \"img_icon_url\": \"35d1377200084a4034238c05b0c8930451e2fb40\",\n \"has_community_visible_stats\": true,\n \"playtime_windows_forever\": 198,\n \"playtime_mac_forever\": 0,\n \"playtime_linux_forever\": 0,\n \"playtime_deck_forever\": 0,\n \"rtime_last_played\": 1759891823,\n \"playtime_disconnected\": 5\n },\n {\n \"appid\": 431960,\n \"name\": \"Wallpaper Engine\",\n \"playtime_2weeks\": 58,\n \"playtime_forever\": 100,\n \"img_icon_url\": \"72edaed9d748c6cf7397ffb1c83f0b837b9ebd9d\",\n \"has_community_visible_stats\": true,\n \"playtime_windows_forever\": 100,\n \"playtime_mac_forever\": 0,\n \"playtime_linux_forever\": 0,\n \"playtime_deck_forever\": 0,\n \"rtime_last_played\": 1779675749,\n \"playtime_disconnected\": 3\n }\n ]\n }\n}| 字段 | \n类型 | \n说明 | \n
|---|---|---|
| response.games.appid | \ninteger | \n游戏唯一标识 ID | \n
| response.games.name | \nstring | \n游戏名称 | \n
| response.games.playtime_2weeks | \ninteger | \n过去 2 周游玩时间（分钟） | \n
| response.games.playtime_forever | \ninteger | \n总游玩时间（分钟） | \n
| response.games.img_icon_url | \nstring | \n游戏图标的文件名 | \n
| response.games.has_community_visible_stats | \nboolean | \n是否公开社区统计数据 | \n
| response.games.playtime_windows_forever | \ninteger | \nWindows 平台总游玩时间（分钟） | \n
| response.games.playtime_mac_forever | \ninteger | \nMac 平台总游玩时间（分钟） | \n
| response.games.playtime_linux_forever | \ninteger | \nLinux 平台总游玩时间（分钟） | \n
| response.games.playtime_deck_forever | \ninteger | \nSteam Deck 平台总游玩时间（分钟） | \n
| response.games.rtime_last_played | \ninteger | \n上次游玩的 Unix 时间戳 | \n
| response.games.playtime_disconnected | \ninteger | \n离线状态下游玩的分钟数 | \n
\n\n\n欢迎补充~
\n
\n\n", "url": "https://blog.jursin.top/blog/resources/beautiful-android-app.html", "title": "一些好用的安卓开源应用", "summary": "欢迎补充", "date_modified": "2026-05-15T13:51:58.000Z", "tags": [ "资源", "Android" ] }, { "id": "https://blog.jursin.top/blog/tutorials/schedule-vela.html", "content_html": "其它闭源但好用的安卓应用
\n\n
\n\n\n我在 AI 辅助下开发了一个适用于 Vela 设备的课程表快应用，欢迎 Star 🌟
\n
![\"banner\"](\"/images/schedule-vela/banner.png\")
\n\n目前支持导入拾光课程表、WakeUp 课程表和 CSES 的配置文件
\n
![\"\"](\"/images/schedule-vela/Xiaomi-Band.png\")
![\"\"](\"/images/schedule-vela/Xiaomi-Band-10.png\")
![\"\"](\"/images/schedule-vela/Xiaomi-Band-Pro.png\")
重要
\n本手环端快应用根据Xiaomi Vela JS 应用开发文档开发，理论上支持小米 Vela 穿戴设备
\n打开 AstroBox-设备，连接设备
点击安装快应用，选择 rpk 文件
点击队列-安装队列的发送按钮，执行安装
![\"AstroBox\"](\"/images/schedule-vela/AstroBox.png\")
\n提示
\n根据文档在对应应用添加课程表或从教务系统导入再导出课表配置文件
\n先确保小米运动健康已连接到穿戴设备
打开腕上课程表同步器，会自动连接穿戴设备并打开快应用
点击选择配置文件按钮选择 json/wakeup_schedule 文件
点击确认导入按钮，手环端会提示导入成功
![\"Schedule-Sync\"](\"/images/schedule-vela/Schedule-Sync.png\")
\n\n\n\n由于需要启用无线调试，请确保 Android 版本在 11 及以上，且连接到 WLAN。
\n
打开 Termux，安装 android-tools 包
![](\"/images/schedule-vela/get-it-on-bandbbs.png\")
\n![](\"/images/schedule-vela/WakeUp课程表导出.png\")
\npkg install android-tools打开系统设置，连续点击系统版本，启用开发者模式
进入设置-更多设置-开发者选项-调试，启用无线调试并进入
![\"调试\"](\"/images/adb-termux/1.jpg\")
\n ![\"无线调试\"](\"/images/adb-termux/2.jpg\")
\n点击使用配对码配对设备
以小窗模式打开 Termux
运行配对命令
\nadb pair 192.168.0.xxx:xxxxx提示
\nIP 地址和端口替换为提示框中的实际内容
回车后输入提示框中的 WLAN 配对码再回车
运行连接命令
\nadb connect 192.168.0.xxx:xxxxx警告
\nIP 地址和端口替换为无线调试页面中的实际内容，不是提示框中的
连接成功，可运行以下命令查看连接设备
\nadb devices\n\n\nUnlock Music 是一个移除已购音乐加密保护的开源项目，支持多种格式。本文介绍如何在安卓手机上通过 Termux 应用使用 Unlock Music CLI 版，使用时请自觉遵守项目相关协议。
\n
解压 um-linux-arm64-vx.x.xx.tar.gz 并将 um 移动到合适目录
解压 um-linux-arm64-vx.x.xx.tar.gz
\n\n可用 MT 管理器解压
\n
设置外部存储访问权限
\ntermux-setup-storage在 Termux 中运行以下命令：
\nmv /storage/emulated/0/Download/um ~/.local/bin/注意
\n/storage/emulated/0/Download/um 是你解压 um 后的 um 实际文件路径~/.local/bin/ 添加到环境变量授予执行权限
\nchmod 550 ~/.local/bin/um检查是否安装成功
\num -hum -i /storage/emulated/0/Download/KuGouLite/Music -o /storage/emulated/0/Music提示
\n-i 参数指定你要解锁的歌曲目录，-o 参数指定你要输出的歌曲目录。
\n\n\nTermux 是一个适用于 Android 的终端模拟器，其环境类似于 Linux 环境, 无需 Root 或设置即可使用。
\n
![\"GitHub\"](\"https://termux.dev/assets/globals/hosts/get-it-on-github.png\")
\n![\"F-Droid\"](\"https://termux.dev/assets/globals/hosts/get-it-on-fdroid.png\")
Termux:Styling\n\n提示
\n警告
\n不同来源的 APK 文件使用不同的签名密钥进行签名，请勿尝试混用不同来源的 APK 文件。例如，不要尝试从 F-Droid 安装一个应用或插件（如 Termux:Styling），然后再从其他来源（如 Github ）安装另一个。
https://mirrors.tuna.tsinghua.edu.cn/fdroid/repo/?fingerprint=43238D512C1E5EB2D6569F4A3AFBF5523418B82E0A3ED1552770ABB9A9C9CCABtouch .hushlogintermux-setup-storagetermux-change-repopkg updatepkg upgrade\n\n可添加
\n-y参数自动确认
pkg install fastfetch oh-my-posh fishfastfetch // 隐藏 logo: fastfetch --logo none\nexec fishcurl -s https://ohmyposh.dev/install.sh | bash -sset -g fish_greeting \"\"\noh-my-posh init fish --config ~/.cache/oh-my-posh/themes/montys.omp.json | source\necho -ne \"\\e[5 q\" // 光标形状：下划线直接访问主目录：/data/user/0/com.termux/files/home/
注入文件提供器
\n通过 MT 管理器为下载的 Termux 安装包注入文件提供器，再安装注入好后的安装包
\n添加本地存储
\n点击 MT 管理器左侧右上角的更多按钮，点击添加本地存储，展开左侧面板后选择 Termux 应用
后续即可通过 MT 管理器访问 Termux 目录
\n\n\n\nMarkdown 是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。
\nMarkdown 的目标是实现「易读易写」。
\n
不过最需要强调的便是它的可读性。一份使用 Markdown 格式撰写的文件应该可以直接以纯文字发佈，并且看起来不会像是由许多标签或是格式指令所构成。Markdown 语法受到一些既有 text-to-HTML 格式的影响，\n包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText，然而最大灵感来源其实是纯文字的电子邮件格式。
\n因此 Markdown 的语法全由标点符号所组成，并经过严谨慎选，是为了让它们看起来就像所要表达的意思。像是在文字两旁加上星号，看起来就像*强调*。Markdown 的列表看起来，嗯，就是列表。假如你有使用过电子邮件，引言写法看起来就真的像是引用一段文字。
\nMarkdown 具有一系列衍生版本，用于扩展 Markdown 的功能 (如表格、脚注、内嵌 HTML 等等) ，\n这些功能原初的 Markdown 尚不具备，它们能让 Markdown 转换成更多的格式，例如 LaTeX，Docbook。\nMarkdown 增强版中比较有名的有 Markdown Extra、MultiMarkdown、 Maruku 等。这些衍生版本要么基于工具，如 Pandoc；要么基于网站，如 GitHub 和 Wikipedia，在语法上基本兼容，但在一些语法和渲染效果上有改动。
\nMarkdown 的语法有个主要的目的: 用来作为一种网络内容的写作用语言。Markdown 的重点在于，它能让文件更容易阅读、编写。因此，Markdown 的格式语法只涵盖纯文字可以涵盖的范围。
\nMarkdown 的语法简洁明了、学习容易，而且功能比纯文本更强，因此有很多人用它写博客。世界上最流行的博客平台 WordPress 能很好的支持 Markdown。
\n用于编写说明文档，并且以 README.md 的文件名保存在软件的目录下面。
除此之外，我们还可以快速将 Markdown 转化为演讲 PPT、Word 产品文档、LaTex 论文甚至是用非常少量的代码完成最小可用原型。在数据科学领域，Markdown 已经广泛使用，极大地推进了动态可重复性研究的历史进程。
\n不在 Markdown 涵盖范围之外的标签，都可以直接在文件里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown；只要直接加标签就可以了。
\n只有块元素 ── 比如 <div>、<table>、<pre>、<p> 等标签，必须在前后加上空行，以利与内容区隔。\n而且这些 (元素) 的开始与结尾标签，不可以用 tab 或是空白来缩进。Markdown 的解析器有智慧型判断，可以避免在块标签前后加上没有必要的 <p> 标签。
举例来说，在 Markdown 文件里加上一段 HTML 表格:
\nThis is a regular paragraph.\n\n<table>\n <tr>\n <td>Foo</td>\n </tr>\n</table>\n\nThis is another regular paragraph.请注意，Markdown 语法在 HTML 块标签中将不会被进行处理。例如，你无法在 HTML 块内使用 Markdown 形式的 *强调*。
在 HTML 文件中，有两个字元需要特殊处理: < 和 & 。 < 符号用于起始标签，& 符号则用于标记 HTML 实体，如果你只是想要使用这些符号，你必须要使用实体的形式，像是 < 和 &。
& 符号其实很容易让写作网络文件的人感到困扰，如果你要打「AT&T」 ，你必须要写成「AT&T」 ，还得转换网址内的 & 符号，如果你要链接到 http://images.google.com/images?num=30&q=larry+bird
你必须要把网址转成:
\nhttp://images.google.com/images?num=30&q=larry+bird才能放到链接标签的 href 属性里。不用说也知道这很容易忘记，这也可能是 HTML 标准检查所检查到的错误中，数量最多的。
Markdown 允许你直接使用这些符号，但是你要小心跳脱字元的使用，如果你是在 HTML 实体中使用 & 符号的话，它不会被转换，而在其它情形下，它则会被转换成 &。所以你如果要在文件中插入一个著作权的符号，你可以这样写:
©Markdown 将不会对这段文字做修改，但是如果你这样写:
\nAT&TMarkdown 就会将它转为:
\nAT&T类似的状况也会发生在 < 符号上，因为 Markdown 支持 行内 HTML ，如果你是使用 < 符号作为 HTML 标签使用，那 Markdown 也不会对它做任何转换，但是如果你是写:
4 < 5Markdown 将会把它转换为:
\n4 < 5不过需要注意的是，code 范围内，不论是行内还是块， < 和 & 两个符号都一定会被转换成 HTML 实体，\n这项特性让你可以很容易地用 Markdown 写 HTML code (和 HTML 相对而言， HTML 语法中，\n你要把所有的 < 和 & 都转换为 HTML 实体，才能在 HTML 文件里面写出 HTML code。)
一个段落是由一个以上相连接的行句组成，而一个以上的空行则会切分出不同的段落 (空行的定义是显示上看起来像是空行，便会被视为空行。比方说，若某一行只包含空白和 tab，则该行也会被视为空行) ，一般的段落不需要用空白或断行缩进。
\n「一个以上相连接的行句组成」这句话其实暗示了 Markdown 允许段落内的强迫断行，\n这个特性和其他大部分的 text-to-HTML 格式不一样 (包括 MovableType 的「Convert Line Breaks」选项) ，\n其它的格式会把每个断行都转成 <br /> 标签。
如果你真的想要插入 <br /> 标签的话，在行尾加上两个以上的空格 ( ) 或斜线 (/)，然后按 Enter。
是的，这确实需要花比较多功夫来插入 <br /> ，但是「每个换行都转换为 <br />」的方法在 Markdown 中并不适合， Markdown 中 email 式的 块引言 和多段落的 列表 在使用换行来排版的时候，不但更好用，还更好阅读。
标题能显示出文章的结构。
\nMarkdown 支持两种标题的语法，Setext 和 atx 形式。
\nSetext 形式是用底线的形式，利用 = (最高阶标题) 和 - (第二阶标题) ，例如:
# This is an H1\n\n## This is an H2任何数量的 = 和 - 都可以有效果。
Atx (推荐)形式则是在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶，例如:
# Header 1## Header 2### Header 3#### Header 4##### Header 5###### Header 6Markdown 使用 email 形式的块引言，如果你很熟悉如何在 email 信件中引言，你就知道怎么在 Markdown 文件中建立一个块引言，那会看起来像是你强迫断行，然后在每行的最前面加上 > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,\n> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.\n> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.\n>\n> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse\n> id sem consectetuer libero luctus adipiscing.Markdown 也允许你只在整个段落的第一行最前面加上 > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,\n> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.\n> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.\n\n> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse\n> id sem consectetuer libero luctus adipiscing.块引言可以有阶层 (例如: 引言内的引言) ，只要根据层数加上不同数量的 > :
> This is the first level of quoting.\n>\n> > This is nested blockquote.\n>\n> Back to the first level.引言的块内也可以使用其他的 Markdown 语法，包括标题、列表、代码块等:
\n> ## This is a header.\n>\n> 1. This is the first list item.\n> 1. This is the second list item.\n>\n> Here's some example code:\n>\n> return shell_exec(\"echo $input | $markdown_script\");任何标准的文字编辑器都能简单地建立 email 样式的引言，例如 BBEdit ，你可以选取文字后然后从选单中选择增加引言阶层。
\nMarkdown 支持有序列表和无序列表。
\n无序列表使用减号作为列表标记(也可使用星号、加号):
\n- Red\n- Green\n- Blue也可以(不建议):
\n- Red\n- Green\n- Blue\n\n* Red\n* Green\n* Blue有序列表则使用数字接着一个英文句点:
\n1. Bird\n2. McHale\n3. Parish很重要的一点是，你在列表标记上使用的数字并不会影响输出的 HTML 结果，上面的列表所产生的 HTML 标记为:
\n<ol>\n <li>Bird</li>\n <li>McHale</li>\n <li>Parish</li>\n</ol>如果你的列表标记写成:
\n1. Bird\n1. McHale\n1. Parish你都会得到完全相同的 HTML 输出。重点在于，你可以让 Markdown 文件的列表数字和输出的结果相同，或是你懒一点都写作 1 你可以完全不用在意数字的正确性。
列表项目标记通常是放在最左边，但是其实也可以缩进，最多三个空白，项目标记后面则一定要接着至少一个空白或 tab。
\n要让列表看起来更漂亮，你可以把内容用固定的缩进整理好:
\n- Lorem ipsum dolor sit amet, consectetuer adipiscing elit.\n Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,\n viverra nec, fringilla in, laoreet vitae, risus.\n- Donec sit amet nisl. Aliquam semper ipsum sit amet velit.\n Suspendisse id sem consectetuer libero luctus adipiscing.但是如果你很懒，那也不一定需要:
\n- Lorem ipsum dolor sit amet, consectetuer adipiscing elit.\n Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,\n viverra nec, fringilla in, laoreet vitae, risus.\n- Donec sit amet nisl. Aliquam semper ipsum sit amet velit.\n Suspendisse id sem consectetuer libero luctus adipiscing.如果列表项目间用空行分开， Markdown 会把项目的内容在输出时用 <p> 标签包起来，举例来说:
- Bird\n- Magic会被转换为:
\n<ul>\n <li>Bird</li>\n <li>Magic</li>\n</ul>但是这个:
\n- Bird\n\n- Magic会被转换为:
\n<ul>\n <li><p>Bird</p></li>\n <li><p>Magic</p></li>\n</ul>列表项目可以包含多个段落，每个项目下的段落都必须缩进 4 个空白或是一个 tab :
\n1. This is a list item with two paragraphs. Lorem ipsum dolor\n sit amet, consectetuer adipiscing elit. Aliquam hendrerit\n mi posuere lectus.\n\n Vestibulum enim wisi, viverra nec, fringilla in, laoreet\n vitae, risus. Donec sit amet nisl. Aliquam semper ipsum\n sit amet velit.\n\n2. Suspendisse id sem consectetuer libero luctus adipiscing.如果你每行都有缩进，看起来会看好很多，当然，再次地，如果你很懒惰，Markdown 也允许:
\n- This is a list item with two paragraphs.\n\n This is the second paragraph in the list item. You're\n only required to indent the first line. Lorem ipsum dolor\n sit amet, consectetuer adipiscing elit.\n\n- Another item in the same list.如果要在列表项目内放进引言，那 > 就需要缩进:
- A list item with a blockquote:\n\n > This is a blockquote\n > inside a list item.当然，项目列表很可能会不小心产生，像是下面这样的写法:
\n1986. What a great season.换句话说，也就是在行首出现数字-句点-空白，要避免这样的状况，你可以在句点前面加上反斜线。
\n1986\\. What a great season.和代码相关的写作或是标签语言原始码通常会有已经排版好的代码块，通常这些块我们并不希望它以一般段落文件的方式去排版，而是照原来的样子显示，Markdown 会用 <pre> 和 <code> 标签来把代码块包起来。
要在 Markdown 中建立代码块很简单，只要简单地缩进 4 个空白或是 1 个 tab 就可以，例如，下面的输入:
\nThis is a normal paragraph:\n\nThis is a code block.Markdown 会转换成:
\n<p>This is a normal paragraph:</p>\n\n<pre>\n <code>This is a code block.</code>\n</pre>这里的缩进 (4 个空白或是 1 个 tab) ，都会被移除，例如:
\nHere is an example of AppleScript:\n\ntell application \"Foo\"\nbeep\nend tell会被转换为:
\n<p>Here is an example of AppleScript:</p>\n\n<pre><code>tell application \"Foo\"\n beep\nend tell\n</code></pre>一个代码块会一直持续到没有缩进的那一行 (或是文件结尾) 。
\n在代码块里面， & 、 < 和 > 会自动转成 HTML 实体，这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码，只需要复制粘贴，再加上缩进就可以了，剩下的 Markdown 都会帮你处理，例如:
```\n<div class=\"footer\">\n © 2004 Foo Corporation\n</div>\n```会被转换为:
\n<pre>\n <code><div class=\"footer\">\n &copy; 2004 Foo Corporation\n</div></code>\n</pre>代码块中，一般的 Markdown 语法不会被转换，像是星号便只是星号，这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件。
\n如果你想要在代码块里输入用 Markdown 表示的代码库，你可以进行嵌套。
\n````md\n```js\nconst a = 1\n```\n````会渲染为
\n```js\nconst a = 1\n```你可以在一行中用三个或以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号中间插入空白。下面每种写法都可以建立分隔线:
\n---(建议) * * * *** ***** - - - ---------------------------------------Markdown 支持两种形式的链接语法: 行内和参考两种形式。
\n不管是哪一种，链接的文字都是用 [方括号] 来标记。
要建立一个行内形式的链接，只要在方块括号后面马上接着括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如:
\nThis is [an example](http://example.com/ \"Title\") inline link. [This\nlink](http://example.net/) has no title attribute.会产生:
\n<p>\n This is <a href=\"http://example.com/\" title=\"Title\"> an example</a> inline\n link.\n</p>\n\n<p><a href=\"http://example.net/\">This link</a> has no title attribute.</p>如果你是要链接到同样主机的资源，你可以使用相对路径:
\nSee my [About](/about/) page for details.参考形式的链接使用另外一个方括号接在链接文字的括号后面，而在第二个方括号里面要填入用以辨识链接的标签:
\nThis is [an example][id] reference-style link.接着，在文件的任意处，你可以把这个标签的链接内容定义出来:
\n[id]: http://example.com/ \"Optional Title Here\"链接定义的形式为:
\n下面这三种链接的定义相同:
\n[foo]: http://example.com/ \"Optional Title Here\"\n[foo]: http://example.com/ \"Optional Title Here\"\n[foo]: http://example.com/ \"Optional Title Here\"请注意: 有一个已知的问题是 Markdown.pl 1.0.1 会忽略单引号包起来的链接 title。
\n链接网址也可以用方括号包起来:
\n[id]: http://example.com/ \"Optional Title Here\"你也可以把 title 属性放到下一行，也可以加一些缩进，网址太长的话，这样会比较好看:
\n[id]: http://example.com/longish/path/to/resource/here \"Optional Title Here\"网址定义只有在产生链接的时候用到，并不会直接出现在文件之中。
\n链接辨识标签可以有字母、数字、空白和标点符号，但是并不区分大小写，因此下面两个链接是一样的:
\n[link text][a]\n[link text][a]预设的链接标签功能让你可以省略指定链接标签，这种情形下，链接标签和链接文字会视为相同，要用预设链接标签只要在链接文字后面加上一个空的方括号，如果你要让 "Google" 链接到 google.com，你可以简化成:
\n[Google][]然后定义链接内容:
\n[google]: http://google.com/由于链接文字可能包含空白，所以这种简化的标签内也可以包含多个文字:
\nVisit [Daring Fireball][] for more information.然后接着定义链接:
\n[daring fireball]: http://daringfireball.net/链接的定义可以放在文件中的任何一个地方，我比较偏好直接放在链接出现段落的后面，你也可以把它放在文件最后面，就像是注解一样。
\n下面是一个参考式链接的范例:
\nI get 10 times more traffic from [Google][1] than from\n[Yahoo][2] or [MSN][3].\n\n[1]: http://google.com/ \"Google\"\n[2]: http://search.yahoo.com/ \"Yahoo Search\"\n[3]: http://search.msn.com/ \"MSN Search\"如果改成用链接名称的方式写:
\nI get 10 times more traffic from [Google][] than from\n[Yahoo][] or [MSN][].\n\n[google]: http://google.com/ \"Google\"\n[yahoo]: http://search.yahoo.com/ \"Yahoo Search\"\n[msn]: http://search.msn.com/ \"MSN Search\"上面两种写法都会产生下面的 HTML。
\n<p>\n I get 10 times more traffic from\n <a href=\"http://google.com/\" title=\"Google\">Google</a> than from\n <a href=\"http://search.yahoo.com/\" title=\"Yahoo Search\">Yahoo</a>\n or <a href=\"http://search.msn.com/\" title=\"MSN Search\">MSN</a>.\n</p>下面是用行内形式写的同样一段内容的 Markdown 文件，提供作为比较之用:
\nI get 10 times more traffic from [Google](http://google.com/ \"Google\")\nthan from [Yahoo](http://search.yahoo.com/ \"Yahoo Search\") or\n[MSN](http://search.msn.com/ \"MSN Search\").参考式的链接其实重点不在于它比较好写，而是它比较好读，比较一下上面的范例，使用参考式的文章本身只有 81 个字元，但是用行内形式的链接却会增加到 176 个字元，如果是用纯 HTML 格式来写，会有 234 个字元，在 HTML 格式中，标签比文字还要多。
\n使用 Markdown 的参考式链接，可以让文件更像是浏览器最后产生的结果，让你可以把一些标记相关的资讯移到段落文字之外，你就可以增加链接而不让文章的阅读感觉被打断。
\nMarkdown 使用星号 (*) 和底线 (_) 作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用 <em> 标签包围，用两个 * 或 _ 包起来的话，则会被转成 <strong>，例如:
**double asterisks** (建议)\n\n**double underscores** (建议)\n\n_single asterisks_\n\n_single underscores_会转成:
\n<em>single asterisks</em>\n\n<em>single underscores</em>\n\n<strong>double asterisks</strong>\n\n<strong>double underscores</strong>你可以随便用你喜欢的样式，唯一的限制是，你用什么符号开启标签，就要用什么符号结束。
\n强调也可以直接插在文字中间:
\nun*frigging*believable但是如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号。
如果要在文字前后直接插入普通的星号或底线，你可以用反斜线:
\n\\*this text is surrounded by literal asterisks\\*如果要标记一小段行内代码，你可以用反引号把它包起来 (`) ，例如:
Use the `printf()` function.会产生:
\n<p>Use the <code>printf()</code> function.</p>如果要在代码内插入反引号，你可以用多个反引号来开启和结束行内代码:
\n``There is a literal backtick (`) here.``这段语法会产生:
\n<p><code>There is a literal backtick (`) here.</code></p>代码码区段的起始和结束端都可以放入一个空白，起始端后面一个，结束端前面一个，这样你就可以在区段的一开始就插入反引号:
\nA single backtick in a code span: `` ` ``\n\nA backtick-delimited string in a code span: `` `foo` ``会产生:
\n<p>A single backtick in a code span: <code>`</code></p>\n\n<p>A backtick-delimited string in a code span: <code>`foo`</code></p>在代码码区段内，& 和方括号都会被转成 HTML 实体，这样会比较容易插入 HTML 原始码，Markdown 会把下面这段:
Please don't use any `<blink>` tags.转为:
\n<p>Please don't use any <code><blink></code> tags.</p>你也可以这样写:
\n`—` is the decimal-encoded equivalent of `—`.以产生:
\n<p>\n <code>&#8212;</code> is the decimal-encoded equivalent of\n <code>&mdash;</code>.\n</p>很明显地，要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。
\nMarkdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式: 行内 和 参考。
\n行内图片的语法看起来像是:
\n\n\n![Alt text](/path/to/img.jpg \"Optional title\")详细叙述如下:
\n!参考式的图片语法则长得像这样:
\n![Alt text][id]「id」是图片参考的名称，图片参考的定义方式则和链接参考一样:
\n[id]: url/to/image \"Optional title attribute\"到目前为止， Markdown 还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的 <img> 标签。
~~delete~~Markdown 支持比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用方括号包起来， Markdown 就会自动把它转成链接，链接的文字就和链接位置一样，例如:
\n<http://example.com/>Markdown 会转为:
\n<a href=\"http://example.com/\">http://example.com/</a>自动的邮件链接也很类似，只是 Markdown 会先做一个编码转换的过程，把文字字元转成 16 进位码的 HTML 实体，这样的格式可以混淆一些不好的信箱地址收集机器人，例如:
\n<address@example.com>Markdown 会转成:
\n<a\n href=\"mailto:address@example.com\"\n >address@example.com</a\n>在浏览器里面，这段字串会变成一个可以点击的 address@example.com 链接。
\n(这种作法虽然可以混淆不少的机器人，但并无法全部挡下来，不过这样也比什么都不做好些。无论如何，公开你的信箱终究会引来广告信件的。)
\nMarkdown 可以利用反斜线来插入一些在语法中有其它意义的符号，例如: 如果你想要用星号加在文字旁边的方式来做出强调效果 (但不用 <em> 标签) ，你可以在星号的前面加上反斜线:
\\*literal asterisks\\*Markdown 支持在下面这些符号前面加上反斜线来帮助插入普通的符号:
\n\\ 反斜线` 反引号* 星号_ 底线{} 大括号[] 方括号() 括号# 井字号+ 加号- 减号. 英文句点! 惊叹号| 输出后的效果 | \nMarkdown | \n快捷键 | \n
|---|---|---|
| Bold | \n**text** | \nCtrl/⌘ + B | \n
| Emphasize | \n*text* | \nCtrl/⌘ + I | \n
Inline Code | \n`code` | \n选中后 ` | \n
| 居中 | \n右对齐 | \n左对齐 | \n
|---|---|---|
居中使用:-: | \n右对齐使用-: | \n左对齐使用:- | \n
| b | \naaaaaaaaa | \naaaa | \n
| c | \naaaa | \na | \n
\n\n\nVitePress 内置及本博客的 Markdown 扩展。
\n
信息
\n大部分内容来自 Markdown 扩展 | VitePress，部分扩展功能参考 VuePress Theme Plume。
\n标题会自动应用锚点。
\n要为标题指定自定义锚点而不是使用自动生成的锚点，请向标题添加后缀：
\n# 自定义锚点 {#my-anchor}这允许将标题链接为 #my-anchor，而不是默认的 #自定义锚点。
内部和外部链接都会被特殊处理。
\n内部链接将转换为单页导航的路由链接。此外，子目录中包含的每个 index.md 都会自动转换为 index.html，并带有相应的 URL /。支持绝对路径与相对路径。
[首页](/) <!-- 将用户导航至根目录下的 index.html -->\n\n[Markdown 基础](/blog/tutorials/markdown-basic) <!-- 可以省略扩展名 -->\n\n[Markdown 基础](./markdown-basic.md) <!-- 可以添加 .md -->\n\n[Markdown 基础](./markdown-basic.html) <!-- 可以添加 .html -->渲染为：
\n\n\n\n默认情况下，生成的页面和内部链接带有 .html 后缀。
外部链接带有 target="_blank" rel="noreferrer" ：
YAML 格式的 frontmatter 开箱即用：
\n---\ntitle: Markdown 基础\nlang: zh-CN\n---此数据将可用于页面的其余部分，以及所有自定义和主题组件。
\n更多信息，参见 frontmatter。
\n输入：
\n| Tables | Are | Cool |\n| ------------- | :-----------: | ----: |\n| col 3 is | right-aligned | $1600 |\n| col 2 is | centered | $12 |\n| zebra stripes | are neat | $1 |输出：
\n| Tables | \nAre | \nCool | \n
|---|---|---|
| col 3 is | \nright-aligned | \n$1600 | \n
| col 2 is | \ncentered | \n$12 | \n
| zebra stripes | \nare neat | \n$1 | \n
输入：
\n:tada: :100:输出：
\n🎉 💯
\n这里可以找到 所有支持的 emoji 列表。
\n输入：
\n[[TOC]]输出：
\n\n自定义容器可以通过它们的类型、标题和内容来定义。
\n输入：
\n::: note\n这是一个注意容器。\n:::\n\n::: info\n这是一个信息容器。\n:::\n\n::: tip\n这是一个提示容器。\n:::\n\n::: important\n这是一个重要容器。\n:::\n\n::: warning\n这是一个警告容器。\n:::\n\n::: caution\n这是一个危险容器。\n:::\n\n::: danger\n这是一个危险容器。\n:::\n\n::: details\n这是一个详细信息容器。\n:::输出：
\n注意
\n这是一个注意容器。
\n信息
\n这是一个信息容器。
\n提示
\n这是一个提示容器。
\n重要
\n这是一个重要容器。
\n警告
\n这是一个警告容器。
\n危险
\n这是一个危险容器。
\n危险
\n这是一个危险容器。
\n这是一个详细信息容器。
\n可以通过在容器的 "type" 之后附加文本来设置自定义标题。
\n输入：
\n::: caution STOP\n危险区域，请勿继续\n:::\n\n::: details 点我查看代码\n```js\nconsole.log('Hello, VitePress!')\n```\n:::输出：
\nSTOP
\n危险区域，请勿继续
\nconsole.log('Hello, VitePress!')VitePress 同样支持以标注的方式渲染 GitHub 风格的警报。它们和自定义容器的渲染方式相同。
\n输入：
\n> [!NOTE]\n> 强调用户在快速浏览文档时也不应忽略的重要信息。\n\n> [!INFO]\n> 用户可能需要的信息。\n\n> [!TIP]\n> 有助于用户更顺利达成目标的建议性信息。\n\n> [!IMPORTANT]\n> 对用户达成目标至关重要的信息。\n\n> [!WARNING]\n> 因为可能存在风险，所以需要用户立即关注的关键内容。\n\n> [!CAUTION]\n> 行为可能带来的负面影响。\n\n> [!DANGER]\n> 行为可能带来的负面影响。输出：
\n注意
\n强调用户在快速浏览文档时也不应忽略的重要信息。
\n信息
\n用户可能需要的信息。
\n提示
\n有助于用户更顺利达成目标的建议性信息。
\n重要
\n对用户达成目标至关重要的信息。
\n警告
\n因为可能存在风险，所以需要用户立即关注的关键内容。
\n危险
\n行为可能带来的负面影响。
\n危险
\n行为可能带来的负面影响。
\nVitePress 使用 Shiki 在 Markdown 代码块中使用彩色文本实现语法高亮。
\n输入：
\n```js\nexport default {\n name: 'MyComponent',\n // ...\n}\n``````html\n<ul>\n <li v-for=\"todo in todos\" :key=\"todo.id\">\n {{ todo.text }}\n </li>\n</ul>\n```输出：
\nexport default {\n name: 'MyComponent',\n // ...\n}<ul>\n <li v-for=\"todo in todos\" :key=\"todo.id\">\n {{ todo.text }}\n </li>\n</ul>在 Shiki 的代码仓库中，可以找到 合法的编程语言列表。
\n还可以在全局配置中自定义语法高亮主题、配置语言别名和自定义语言标签。有关详细信息，参见 markdown 选项得到更多信息。
输入：
\n```js{4}\nexport default {\n data () {\n return {\n msg: 'Highlighted!'\n }\n }\n}\n```输出：
\nexport default {\n data () {\n return {\n msg: 'Highlighted!'\n }\n }\n}除了单行之外，还可以指定多个单行、多行，或两者均指定：
\n{5-8}、{3-10}、{10-17}{4,7,9}{4,7-13,16,23-27,40}输入：
\n```js{1,4,6-8}\nexport default { // Highlighted\n data () {\n return {\n msg: `Highlighted!\n This line isn't highlighted,\n but this and the next 2 are.`,\n motd: 'VitePress is awesome',\n lorem: 'ipsum'\n }\n }\n}\n```输出：
\nexport default { // Highlighted\n data () {\n return {\n msg: `Highlighted!\n This line isn't highlighted,\n but this and the next 2 are.`,\n motd: 'VitePress is awesome',\n lorem: 'ipsum'\n }\n }\n}也可以使用 // [!code highlight] 注释实现行高亮。
输入：
\n```js\nexport default {\n data () {\n return {\n msg: 'Highlighted!' // [\\!code highlight]\n }\n }\n}\n```输出：
\nexport default {\n data() {\n return {\n msg: 'Highlighted!'\n }\n }\n}在某一行上添加 // [!code focus] 注释将聚焦它并模糊代码的其他部分。
此外，可以使用 // [!code focus:<lines>] 定义要聚焦的行数。
输入：
\n```js\nexport default {\n data () {\n return {\n msg: 'Focused!' // [\\!code focus]\n }\n }\n}\n```输出：
\nexport default {\n data() {\n return {\n msg: 'Focused!'\n }\n }\n}在某一行添加 // [!code --] 或 // [!code ++] 注释将会为该行创建 diff，同时保留代码块的颜色。
输入：
\n```js\nexport default {\n data () {\n return {\n remove: 'Removed', // [\\!code --]\n add: 'Added' // [\\!code ++]\n }\n }\n}\n```输出：
\nexport default {\n data() {\n return {\n remove: 'Removed', \n add: 'Added'\n }\n }\n}在某一行添加 // [!code warning] 或 // [!code error] 注释将会为该行相应的着色。
输入：
\n```js\nexport default {\n data () {\n return {\n error: 'Error', // [\\!code error]\n warning: 'Warning' // [\\!code warning]\n }\n }\n}\n```输出：
\nexport default {\n data() {\n return {\n error: 'Error', \n warning: 'Warning'\n }\n }\n}可以通过以下配置为每个代码块启用行号：
\nexport default {\n markdown: {\n lineNumbers: true\n }\n}查看 markdown 选项 获取更多信息。
可以在代码块中添加 :line-numbers / :no-line-numbers 标记来覆盖在配置中的设置。
还可以通过在 :line-numbers 之后添加 = 来自定义起始行号，例如 :line-numbers=2 表示代码块中的行号从 2 开始。
输入
\n```ts:no-line-numbers {1}\n// 禁用行号\nconst line2 = 'This is line 2'\nconst line3 = 'This is line 3'\n```\n\n```ts:line-numbers {1}\n// 启用行号\nconst line2 = 'This is line 2'\nconst line3 = 'This is line 3'\n```\n\n```ts:line-numbers=2 {1}\n// 行号已启用，并从 2 开始\nconst line3 = 'This is line 3'\nconst line4 = 'This is line 4'\n```输出
\n// 禁用行号\nconst line2 = 'This is line 2'\nconst line3 = 'This is line 3'// 启用行号\nconst line2 = 'This is line 2'\nconst line3 = 'This is line 3'// 行号已启用，并从 2 开始\nconst line3 = 'This is line 3'\nconst line4 = 'This is line 4'输入：
\n```ts\nexport function foo() { // [\\!code word:Hello]\n const msg = 'Hello World'\n console.log(msg) // prints Hello World\n}\n```输出：
\nexport function foo() { \n const msg = 'Hello World'\n console.log(msg) // prints Hello World\n}你还可以指定高亮显示的次数，例如 [!code word:options:2] 会高亮显示近两个 options。
输入：
\n```ts\n// [\\!code word:options:2]\nconst options = { foo: 'bar' }\noptions.foo = 'baz'\nconsole.log(options.foo) // 这个不会被高亮显示\n```输出：
\nconst options = { foo: 'bar' }\noptions.foo = 'baz'\nconsole.log(options.foo) // 这个不会被高亮显示可以通过下面的语法来从现有文件中导入代码片段：
\n<<< @/filepath此语法同时支持行高亮：
\n<<< @/filepath{highlightLines}输入
\n<<< @/snippets/snippet.js{2}Code file
\nexport default function () {\n // ..\n}输出
\nexport default function () { \n // ..\n}提示
\n@ 的值对应于源代码根目录，默认情况下是 VitePress 项目根目录，除非配置了 srcDir。或者也可以从相对路径导入：
<<< ../snippets/snippet.js也可以使用 VS Code region 来只包含代码文件的相应部分。可以在文件目录后面的 # 符号后提供一个自定义的区域名：
输入
\n<<< @/snippets/snippet-with-region.js#snippet{1}Code file
\n// #region snippet\nfunction foo() {\n // ..\n}\n// #endregion snippet\n\nexport default foo输出
\nfunction foo() { \n // ..\n}也可以像这样在大括号内({})指定语言：
<<< @/snippets/snippet.cs{c#}\n\n<!-- 带行高亮: -->\n\n<<< @/snippets/snippet.cs{1,2,4-6 c#}\n\n<!-- 带行号: -->\n\n<<< @/snippets/snippet.cs{1,2,4-6 c#:line-numbers}如果无法从文件扩展名推测出源语言，这将会很有帮助
\n可以像这样对多个代码块进行分组：
\n输入
\n::: code-group\n\n```js [config.js]\n/**\n * @type {import('vitepress').UserConfig}\n */\nconst config = {\n // ...\n}\n\nexport default config\n```\n\n```ts [config.ts]\nimport type { UserConfig } from 'vitepress'\n\nconst config: UserConfig = {\n // ...\n}\n\nexport default config\n```\n\n:::输出
\n/**\n * @type {import('vitepress').UserConfig}\n */\nconst config = {\n // ...\n}\n\nexport default configimport type { UserConfig } from 'vitepress'\n\nconst config: UserConfig = {\n // ...\n}\n\nexport default config也可以在代码组中导入代码片段：
\n输入
\n::: code-group\n\n<!-- 文件名默认用作标题 -->\n\n<<< @/snippets/snippet.js\n\n<!-- 也可以提供定制的代码组 -->\n\n<<< @/snippets/snippet-with-region.js#snippet{1,2 ts:line-numbers} [snippet with region]\n\n:::输出
\nexport default function () {\n // ..\n}function foo() {\n // ..\n}可以像这样在一个 markdown 文件中包含另一个 markdown 文件，甚至是内嵌的。
\n提示
\n也可以使用 @，它的值对应于源代码根目录，默认情况下是 VitePress 项目根目录，除非配置了 srcDir。
例如，可以这样用相对路径包含 Markdown 文件：
\n输入
\n# Docs\n\n## Basics\n\n<!--@@include: ./parts/basics.md-->Part file (parts/basics.md)
Some getting started stuff.\n\n### Configuration\n\nCan be created using `.foorc.json`.等价代码
\n# Docs\n\n## Basics\n\nSome getting started stuff.\n\n### Configuration\n\nCan be created using `.foorc.json`.它还支持选择行范围：
\n输入
\n# Docs\n\n## Basics\n\n<!--@@include: ./parts/basics.md{3,}-->Part file (parts/basics.md)
Some getting started stuff.\n\n### Configuration\n\nCan be created using `.foorc.json`.等价代码
\n# Docs\n\n## Basics\n\n### Configuration\n\nCan be created using `.foorc.json`.所选行范围的格式可以是： {3,}、 {,10}、{1,10}
警告
\n如果指定的文件不存在，这将不会产生错误。因此，在使用这个功能的时候请保证内容按预期呈现。
\n输入：
\nWhen $a \\ne 0$, there are two solutions to $(ax^2 + bx + c = 0)$ and they are\n$$ x = {-b \\pm \\sqrt{b^2-4ac} \\over 2a} $$\n\n**Maxwell's equations:**\n\n| equation | description |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |\n| $\\nabla \\cdot \\vec{\\mathbf{B}} = 0$ | divergence of $\\vec{\\mathbf{B}}$ is zero |\n| $\\nabla \\times \\vec{\\mathbf{E}}\\, +\\, \\frac1c\\, \\frac{\\partial\\vec{\\mathbf{B}}}{\\partial t} = \\vec{\\mathbf{0}}$ | curl of $\\vec{\\mathbf{E}}$ is proportional to the rate of change of $\\vec{\\mathbf{B}}$ |\n| $\\nabla \\times \\vec{\\mathbf{B}} -\\, \\frac1c\\, \\frac{\\partial\\vec{\\mathbf{E}}}{\\partial t} = \\frac{4\\pi}{c}\\vec{\\mathbf{j}} \\nabla \\cdot \\vec{\\mathbf{E}} = 4 \\pi \\rho$ | _wha?_ |输出：
\nWhen \n \n \n
Maxwell's equations:
\n| equation | \ndescription | \n
|---|---|
| \n \n \n | \ndivergence of \n \n \n | \n
| \n \n \n | \ncurl of \n \n \n | \n
| \n \n \n | \nwha? | \n
使用 == == 进行标记。
==Default== - Default
内置了以下的配置方案：
\n==Info=={.info} - Info==Note=={.note} - Note==Tip=={.tip} - Tip==Warning=={.warning} - Warning==Danger=={.danger} - Danger==Caution=={.caution} - Caution==Important=={.important} - Important输入：
\n!!需要隐秘的内容!!输出：
\n需要隐秘的内容
\n^ ^ 进行上角标标注。~ ~ 进行下角标标注。输入：
\n- 19^th^\n- H~2~O输出：
\n你可以使用特殊标记为 Markdown 元素添加属性。
\n为图片添加属性：
\n这将为图片添加 一个 名为 full-width 的 class 属性，以及一个 width 属性，值为 100%。
{.full-width width=\"100%\"}同时也支持其他属性:
\n一个包含文字的段落。 {#p .a .b align=center customize-attr=\"content with spaces\"}这将被渲染为：
\n<p id=\"p\" class=\"a b\" align=\"center\" customize-attr=\"content with spaces\">\n 一个包含文字的段落。\n</p>提示
\n链接后面添加 {.readmore} 可以显示为特殊样式：
输入：
\n[更多信息请阅读 **VitePress** 文档](https://vitepress.dev/zh/){.readmore}输出：
\n\n输入：
\n- [ ] 任务 1\n- [x] 任务 2\n- [ ] 任务 3输出：
\n\n\n\nEric S. Raymond 在 2004 年发表过一篇 How To Ask Questions The Smart Way 文章，最新版是 2014 年的 3.10 版。这篇文章写的非常好，令人深受启发。本文对原文做了大量的删减和本土化改造，更贴近中国程序员的实际情况。
\n
在你向社区或者其他非亲非故的同行咨询技术问题之前，你应该先做以下事情：
\nIssus 或者 FAQ 中尝试寻找答案。Baidu，应使用关键词搜索，而不是口语化表述。如果使用的是国外的技术或框架，优先用英文关键词搜索。如果你做了上述事情，你就 获得了向他人提问的资格。提问时，先说明你做了上述尝试，以及你从中发现了哪些关键信息，这会给对方留下一个好的印像。他们会觉得你是同道中人，也是一个努力上进的好青年。
审问之，慎思之。好的答案不是免费的，要么你付费咨询，要么请用一个好的问题来做交换。轻率的提问只能得到轻率的回答，或者如石沉大海。
\n在合适的地方提问，和提出一个好的问题同样重要，永远不要到肯德基里询问麦当劳怎么走。 GitHub Issus 和 Stack Overflow 通常是很合适的编程问题的论坛，如果你不明白 Stack Overflow 的含义的话，那就不适合在那提问了，百度贴吧才是你真正的朋友。
如果你用到 GitHub 上的开源项目，那你可以先到 GitHub 的项目官网中去搜索 Issus，看是否有类似的问题。如果没有的话，你可以提一个新的 Issus。在提 Issus 时，需要遵守官方对 Issus 定义的格式和内容要求，否则你很难得到回复。国内的开源项目，你被回复的可能性是比较低的。 毕竟国内程序员的压力都比较大，开源生态环境也有待改进。这不是某一个作者或者组织的责任，开源兴亡，匹夫有责，提出一个好的问题，就是一个好的开端。
Stack Overflow Stack Overflow 是 Stack Exchange 旗下的一个子站，谷歌对 Stack Exchange 的页面信息是实时索引的，如果你在谷歌中用英文关键词搜索的话，通常首页就会有 Stack Overflow 的搜索结果，如果没有的话，说明这个问题过于生僻或者关键词没用对。
如果你不会科学上网的话，你也可以用百度进行搜索，只不过多了一个步骤：
\nStack Overflow, 找到其官网并点击进入（注意避开广告）。Stack Exchange 已经发展到超过 100 个站点，以下是最常用的几个子站点：
Super User 是关于通用计算的问题。如果你的问题和代码无关，或者你说的只是程序在网络连接上的问题，九成在这里问。Stack Overflow 是关于编程问题。Server Fault 是关于服务器和网络管理的问题。有几个项目有自己的特定站点，包括 Android、Ubuntu、TeX/LaTeX 和 SharePoint。请检查一下 Stack Exchange 以确定现在具体有哪些站点。
很多商业和开源项目都提供了聊天群，国外通常是 Slack, 国内通常是 QQ 或 微信群。在这些群里提问的话，通常会很快得到响应，而且群里都会有官方的技术支持人员解答问题。
在提问时，请使用简洁、清晰、一针见血的标题，自觉抵制那些无意义的口水话。『请问有没有人能帮帮我！！』 基本上与在吗？ 同义。不要妄想用卑微、痛苦的语言去打动别人，技术社区不相信眼泪。
\n愚蠢：
\n\n\n救命啊！这个系统宕机了！
\n
明智：
\n\n\njava8 应用无响应，硬件资源正常
\n
更明智：
\n\n\nspringboot 项目启动阻塞，启动线程卡在 dubbo 注册方法
\n
一个粗心与草率的提问者，通常也是一个粗心和草率的程序员，工作如此，生活亦如此。自己不认真对待遇到的问题，又岂能期望他人会认真对待。用词正确简洁、条理清楚、详略得当，这样的问题更容易得到他人回复。所有的技术社区都支持 markdown 语法（如果不支持，那它就不是一个技术社区），恰当的使用 markdown 语法，如高亮、加粗、列表等，能让你的问题更容易被他人理解。
如果你需要在英文技术社区提问，你可以借助 Google 翻译将你的中文提问转成英文后进行提问。
\n尽最大努力预测别人会提到的问题，并提前备好答案，这样可以提高沟通的效率。
\n如果你认为是代码有问题，则应该提供可复现的测试代码和样例，这会让你得到回复的几率大幅增加。
\n西蒙 · 泰瑟姆（Simon Tatham）写过一篇如何有效报告 Bug 的文章，我强烈推荐各位阅读。
Bug 当你在一个软件或开源项目中遇到问题，除非你非常、非常的有把握，否则不要大声嚷嚷找到了 Bug，轻则被打脸，重则被社区拉入黑名单。
\n\n提示：除非你直接定位到代码中的问题，或者出现和前面版本不一样的测试结果，否则你大概率是错的。
\n
程序员听到别人声称找到 Bug 的第一反应是 "这不可能"，第二反应是 "你用错了吧"。就算你真的找到 Bug 了，也应礼貌友好的指出。大声嚷嚷："你这写的啥呀，是不是没测试就发出来了呀" 对于解决问题没有帮助，只会得到"你行你上"的回复。
直接要求他人帮你解决问题是愚蠢且自私的。在你遇到问题，寻求他人帮助时，你应抱着一定要自己解决的信念，别人只是给你提供解决思路和纠正错误。没有人有帮你解决问题的义务，合理有节制的提出请求，你才有可能得到他人的回复。
\n礼貌一点，使用『你好』、『请』、『谢谢』，让别人明白你感谢他们无偿的帮助。
\n有些人在他人帮助下解决了问题就销声匿迹，远走高飞。别人花费大量时间提供帮助，而他却在问题解决后不愿向帮助的人说明一下结果。
\n问题解决后向所有帮助过的人回一条消息，让他们知道问题是如何解决的并再次感谢。有来有往，来日方长。
\n如果问题比较复杂，可以梳理总结一篇文章发出来，一来可以自己巩固，二来可以帮助他人。前车之鉴，后事之师。
\nRTFM 和 STFW 意思是你的问题很傻很天真 STFW, 全名是 Search The F**king Web，它还有个弟弟叫 RTFM, 全名是 Read The F**king manual。STFW 还有一个温和点的说法，叫 Google is your friend, 对于不会科学上网的国内程序员，那就是 baidu is your friend。
如果你收到这样的回复，那这就是你能收到的最好的答案，你应该照做，去网上查一下，或者看一下手册。这样的回复虽然有些难以接受，但你不应该觉得被冒犯，因为别人已经给了你正确的答案。如果你还觉得难以接受，你应该把 STFW 设置为你的屏保，时刻提醒自己，别再提这么傻的问题了。
国内的评论区已基本被杠精占领，技术社区这一片唯一的净土也难以独善其身，肆意的谩骂、互相 diss 已是司空见惯。评论区的提示信息不是请遵守法律，就是善意的提醒善语结善缘，恶言伤人心。这是必须承受之痛，欲练此功。。欲带皇冠, 必承其重。
\n如果面对的是毫无意义的谩骂、轻视，这种纯粹的恶意仅仅是对方的一种发泄，目的就是引起你的愤怒。如果你愤怒了，那正中其下怀。
\n如果对方只是无礼的给出了有用的信息，那就说明他是一个刀子嘴豆腐心的人，嘴上说着不要，但想要帮助别人的心还是很诚实的。如果你愤怒了，反倒显的小气了。
\n技术上的争论应该是君子之争，就事论事，理越辩越明。谩骂、诋毁，或者是如祥林嫂般去知乎上宣称自己遭遇的不公正待遇，这样的回应只会让自己变成自己讨厌的那个人。
\n君子量不极, 胸吞百川流。不要做意气之争，不要把有限的精力放在无谓的争执上。 Big Endian or Small Endian, it's not a question.
前面都在说如何更好的提问，下面说说做为被提问的一方，如何更好的回答他人的问题。
\nFAQ 都不知道。回复别人 STFW 合理但不合情。rm -rf /* 当成重启指令。FAQ 文档以免再次解答同样的问题？』。对《How To Ask Questions The Smart Way》原文感兴趣的可以直接阅读英文版，也可以参考 GitHub 上这篇中文翻译。
\n", "url": "https://blog.jursin.top/blog/misc/smart-questions.html", "title": "提问的智慧-中国版", "summary": "Eric S. Raymond 在 2004 年发表过一篇 How To Ask Questions The Smart Way 文章，最新版是 2014 年的 3.10 版。这篇文章写的非常好，令人深受启发。本文对原文做了大量的删减和本土化改造，更贴近中国程序员的实际情况。", "date_modified": "2022-09-11T03:49:00.000Z", "tags": [ "杂谈", "提问" ] } ] }