这篇文章基本上就是把 Fuwari 中的指南内容翻译过来，防止未来的自己忘了该怎么写文章（

封面： 負けヒロインが多すぎる！ by Ulrica.H

创建文章#

文章元数据#

---
title: 我的第一篇文章
published: 2024-08-28
description: 这是我在 Astro 上的第一篇文章.
image: ./cover.jpg
tags: [Foo, Bar]
category: Front-end
draft: false
---

发布文章的存放位置#

你发布的文章应当在 src/content/posts/ 目录下. 你也可以创建一个子目录，用来存放文章和文章中的资源。

src/content/posts/
├── post-1.md
└── post-2/
    ├── cover.png
    └── index.md

Markdown 语法#

这是一个 h1 标题#

段落之间用空行分隔。

这是第二段 斜体, 粗体, and 代码行。
下面是无序列表

• 这是一项
• 这是一项
• 这是另一项

请注意 --- 不考虑星号 --- 实际的文本 内容从 4 列开始。

区块引用
应该这么写。

如果你愿意，
它可以有多个段落

使用三个破折号 --- 表示一个长破折号。使用两个破折号 — 表示范围（例如，“它在第 12—14 章”）。三个点 … 将被转换为省略号。
支持 Unicode。☺

这是一个 h2 标题#

这是一个有序列表

1. 第一项
2. 第二项
3. 第三项

注意，实际文本从左侧开始有 4 列（从左侧移 4 个字符）。以下是一个代码示例：

# Let me re-iterate ...
for i in 1 .. 10 { do-something(i) }

正如你可能猜到的，缩进了 4 个空格。顺便提一下，你也可以使用分隔块来代替缩进块，如果你愿意的话：

define foobar() {
    print "Welcome to flavor country!";
}

（这让你可以更方便的复制）。你可以选择性地标记分隔块，以便 Pandoc 对其进行语法高亮：

import time
# Quick, count to ten!
for i in range(10):
    # (but not *too* quick)
    time.sleep(0.5)
    print i

这是一个 h3 标题#

下面是一个嵌套列表

1. 首先，准备这些食材

   • 胡萝卜
   • 芹菜
   • 扁豆

2. 烧水.

3. 把所有东西都倒进锅里，然后按照以下步骤操作：

    找到木勺
    揭开锅盖
    搅拌
    盖上锅盖
    将木勺平稳地放在锅柄上
    等待 10 分钟
    转到第一步（完成后关掉炉子）
   

   不要碰木勺，否则它会掉下来。

注意，文本总是对齐在 4 个空格的缩进上（包括上面第 3 项的最后一行）。

以下是你提供的内容的翻译：

这里有一个链接到 一个网站、本地文档 和 当前文档中的某个章节标题。这里有一个脚注 ¹。

表格可以是这样的：

大小 材料 颜色

9 皮革 棕色 10 麻布 布料 自然色 11 玻璃 透明

表格：鞋子、它们的尺码及其材料

（上述内容是表格的标题。）Pandoc 还支持多行表格：

关键词

红色夕阳、苹果和其他红色或红褐色的东西。

绿叶、草、青蛙及其他不易被定义的东西。

接下来是水平分隔线

这是一个定义列表：

apples : 适合制作苹果酱

oranges : 柑橘类！

tomatoes : ”tomatoe“里没有”e“

再次注意，文本缩进了 4 个空格。（在每对术语/定义之间放一个空行，以使内容更分散。）

行内数学方程式：$\omega = d\phi / dt$。
如果想要显示数学公式应单独占用一行，应当用双美元符号包围：

$I = \int \rho R^{2} dV$

注意，你可以使用反斜杠转义任何你希望字面显示的标点字符，例如：`foo`、*bar* 等。

Markdown 扩展语法#

GitHub 仓库卡片#

你可以添加一个链接到一个 GitHub 仓库的动态卡片。当页面加载时，将从 GitHub API 获取仓库信息。

创建一个 Github 仓库卡片，只需在 Markdown 文件中添加一行 ::github{repo="<owner>/<repo>"}。

::github{repo="saicaca/fuwari"}

警告#

支持这些类型的警告: note tip important warning caution

NOTE

突出显示用户在浏览时也应考虑的信息。

TIP

可选的信息，以帮助用户更顺利地理解。

IMPORTANT

用户完成任务所必需的关键信息。

WARNING

关键内容，由于潜在风险需要用户立即关注。

CAUTION

行动的负面潜在后果。

:::note
强调用户在浏览时也应考虑的信息。
:::

:::tip
可选的信息，以帮助用户更顺利地理解。
:::

警告的标题可以自定义

自定义标题

这是一个带有自定义标题的提示。

:::note[自定义标题]
这是一个带有自定义标题的提示。
:::

TIP

同时也支持 GitHub 语法。

> [!NOTE]
> 也支持 GitHub 语法。

> [!TIP]
> 也支持 GitHub 语法。

视频卡片#

只需从 YouTube 或其他平台复制嵌入代码，然后将其粘贴到 markdown 文件中。

---
title: 视频卡片
published: 2024-08-28
---

<iframe width="100%" height="468" src="https://www.youtube.com/embed/7ruRB3lpy3k?si=B5WLpyNmRsSalxyk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

YouTube#

Bilibili#