页面内容在第二个 --- 后面。

基本用法

文本可以是粗体，斜体，或删除线。

你可以 链接到另一个页面。

你可以使用反引号高亮 内联代码。

单独显示图片, 但没有链接可以点击

显示图片,且增加链接

因为 Starlight 配置为自动使用页面标题作为一级标题 ,所以建议md内容从 ##即h2开始

---

右侧目录.

请见页面右侧

---

旁白

• Starlight 提供了一个自定义的 Markdown 语法来渲染旁白。旁白块使用一对三个冒号 ::: 来包裹你的内容，并且可以是 note，tip，caution 或 danger 类型。 效果如下:

• 可以在旁白类型后面的方括号中指定旁白的自定义标题，例如 :::tip[你知道吗？]。

Note

Starlight 是一个使用 Astro 构建的文档网站工具包。 你可以使用此命令开始：

npm create astro@latest -- --template starlight

主题内容

tip内容

Caution

caution内容

Danger

danger内容

---

块引用

这是块引用，通常在引用其他人或文档时使用。

块引用以每行开头的 > 表示。

---

代码块

// 带有语法高亮的 JavaScript 代码。
var fun = function lang(l) {
  dateformat.i18n = require('./lang/' + l);
  return true;
};

---

Expressive Code 功能

文本标记

在代码块中可以通过特别突出显示标记代码,分三种突出显示样式：中性用于突出显示代码，绿色用于表示插入的代码，红色用于表示删除的代码。

• 使用 { } 标记标出整行和行范围:

  function demo() {
  // 这一行 (#2) 以及下一行被高亮显示
  return '这是本代码段的第 3 行';
  }

• 使用 ” ” 标记或正则表达式标出文本字符串:

  // 单个词组也能被高亮显示
  function demo() {
  return '甚至支持使用正则表达式';
  }

• 使用 ins 或 del 来标记行或文本为插入或删除:

  function demo() {
  console.log('这是插入以及删除类型的标记');
  // 返回语句使用默认标记类型
  return true;
  }

• 混合语法高亮和类 diff 语法:

  function thisIsJavaScript() {
      // 这整个代码块都会被作为 JavaScript 高亮
      // 而且我们还可以给它添加 diff 标记！
     console.log('旧的不去')
     console.log('新的不来')
  }

给代码框添加边框和标题

• 通过注释添加一个文件名标签

  标题填写在这里

  // my-test-file.js
  console.log('Hello World!');

• 给终端窗口添加一个标题

  安装依赖…

  npm install

• 使用 frame=“none” 禁用边框

  echo "这个代码块即使使用了 bash 语言也不会被显示成终端窗口"

其它通用 Markdown 语法

Starlight 支持所有其他 Markdown 语法，例如列表和表格。 请参阅 Markdown 指南的 Markdown 速查表 以快速了解所有 Markdown 语法元素。

---

自动生成标题锚点链接

我可以链接到同一页下面的 返回到 基本用法 章节

返回首页