本站 Hugo + Markdown 写作功能参考

content/notes/tools/我的新文章.md

hugo new 笔记目录/笔记名称.md

---
title: "我的新文章"
date: 2026-07-24T22:00:00+08:00
description: "一句话说明这篇文章写了什么。"
showTableOfContents: true
tags:
  - Hugo
  - Markdown
categories:
  - 博客
---

## 第一部分

正文从这里开始。

hugo server

hugo server -D

hugo --gc --minify

content/
└── notes/
    └── tools/
        └── docker.md

content/
└── life/
    └── travel/
        └── my-trip/
            ├── index.md
            ├── featured.jpg
            └── images/
                ├── 01.jpg
                └── 02.jpg

![第一天的风景](images/01.jpg)

---
title: "工具"
description: "命令行、Docker、网络和日常工具记录。"
---

content/notes/tools/docker.md       # 中文
content/notes/tools/docker.ja.md    # 日文

---
title: "Linux 文件描述符：fd、重定向与打开文件表"
date: 2026-07-24T22:00:00+08:00
lastmod: 2026-07-25T10:30:00+08:00
description: "从 shell 重定向开始，解释文件描述符和打开文件表之间的关系。"
summary: "一篇面向初学者的 Linux 文件描述符入门。"
tags:
  - Linux
  - 文件描述符
  - 重定向
categories:
  - Linux
slug: linux-fd
aliases:
  - /notes/linux/old-fd/
---

---
showTableOfContents: true
showMath: true
showComments: false
showViews: false
showLikes: false
showHero: true
showEdit: false
relatedContentLimit: 5
---

featureImage: "/img/kumiko_jump.png"

content/life/travel/my-trip/
├── index.md
└── featured.jpg

showHero: true
heroStyle: "background"

tags:
  - Docker
  - GitLab
  - 部署
categories:
  - DevOps
  - 计算机

# 一级标题

## 二级标题

### 三级标题

这是普通段落。段落之间空一行。

**粗体**

*斜体*

~~删除线~~

普通文本中的命令可以写成行内代码。

***粗体斜体***

[Hugo 官网](https://gohugo.io/)

<https://gohugo.io/>

[站内另一篇文章](../../linux/Linux文件描述符-fd.md)

[跳转到本文 Front Matter 部分](#三front-matter文章顶部配置)

- 第一项
- 第二项
  - 第二项的子项

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

- [x] 已完成
- [ ] 尚未完成

> 这是普通引用。
>
> 引用可以有多个段落。

> [!NOTE]
> 这是说明。

> [!TIP]
> 这是技巧。

> [!WARNING]
> 这是警告。

---

| 命令 | 作用 |
| --- | --- |
| hugo server | 启动预览 |
| hugo --gc | 生成并清理缓存 |
| git status | 查看工作区状态 |

| 左对齐 | 居中 | 右对齐 |
| :--- | :---: | ---: |
| A | B | C |

Hugo
: 静态网站生成器。

Markdown
: 纯文本标记语言。

![大阪城公园](images/osaka-castle.jpg)

<details>
<summary>点击展开</summary>

这是折叠内容。
</details>

~~~bash
mkdir -p content/notes/tools
hugo server
~~~

~~~go {hl_lines=["3", "5-6"]}
package main

import "fmt"

func main() {
    fmt.Println("hello")
}
~~~

{{< figure
  src="featured.png"
  alt="文章主视觉"
  caption="这是一段 **支持 Markdown** 的说明。"
>}}

{{< figure
  src="map.png"
  alt="路线图"
  caption="点击查看原图。"
  href="https://example.com/map"
  target="_blank"
  nozoom="true"
>}}

{{< gallery >}}
  <img src="01.jpg" class="grid-w50" alt="照片 1" />
  <img src="02.jpg" class="grid-w50" alt="照片 2" />
{{< /gallery >}}

{{< gallery >}}
  <img src="01.jpg" class="grid-w50 md:grid-w33" alt="照片 1" />
  <img src="02.jpg" class="grid-w50 md:grid-w33" alt="照片 2" />
  <img src="03.jpg" class="grid-w50 md:grid-w33" alt="照片 3" />
{{< /gallery >}}

{{< gallery >}}
  {{< figure
    src="01.jpg"
    alt="第一张"
    caption="第一天早晨。"
    figureClass="grid-w33"
  >}}
  {{< figure
    src="02.jpg"
    alt="第二张"
    caption="车站附近。"
    figureClass="grid-w33"
  >}}
{{< /gallery >}}

{{< carousel
  images="01.jpg,02.jpg,03.jpg"
  aspectRatio="16-9"
  interval="4000"
>}}

{{< carousel
  images="01.jpg,02.jpg,03.jpg"
  aspectRatio="4-3"
  interval="3000"
  captions="{01.jpg:第一天,02.jpg:车站,03.jpg:夜景}"
>}}

{{< youtubeLite
  id="5Ai4fRBZBbo"
  label="作品官方 PV"
>}}

{{< youtubeLite
  id="5Ai4fRBZBbo"
  label="作品官方 PV"
  params="start=130&controls=0"
>}}

{{< video
  src="movie.mp4"
  poster="movie-poster.jpg"
  caption="本地视频示例。"
  controls="true"
  playsinline="true"
  preload="metadata"
  ratio="16/9"
>}}

{{< video
  src="demo.webm"
  autoplay="true"
  muted="true"
  loop="true"
>}}

{{< bilibili
  url="https://www.bilibili.com/video/BV13h411k7Zk/"
  label="第一季 OP"
>}}

{{< video-link
  href="https://www.example.com/video"
  thumbnail="/img/video-cover.jpg"
  alt="官方视频封面"
  platform="官方网站"
  title="点击打开官方视频页面"
>}}

{{< alert icon="circle-info" >}}
这里是一条 **重要提示**，正文支持 Markdown。
{{< /alert >}}

> [!TIP]
> 这是一条技巧提示。

> [!WARNING]
> 这是一条警告。

{{< callou type="tip" title="写作建议" >}}
标题和正文都可以使用 Markdown。
{{< /callou >}}

{{< callou
  type="warning"
  title="点击查看注意事项"
  foldable="true"
>}}
这里的内容默认折叠。
{{< /callou >}}

{{< callou
  type="note"
  title="默认展开的说明"
  foldable="true"
  open="true"
>}}
说明内容。
{{< /callou >}}

{{< accordion mode="open" separated=true >}}
  {{< accordionItem title="Linux" open=true >}}
  Linux 安装步骤。
  {{< /accordionItem >}}

  {{< accordionItem title="macOS" >}}
  macOS 安装步骤。
  {{< /accordionItem >}}
{{< /accordion >}}

{{< link-card
  title="Hugo 官方文档"
  desc="Hugo 的官方文档和配置参考。"
  href="https://gohugo.io/documentation/"
  image="/img/logo.png"
  eyebrow="Official Documentation"
  cta="打开官方文档"
  alt="Hugo 文档"
>}}

{{< link-card
  title="项目仓库"
  desc="查看这个博客的源代码。"
  href="https://github.com/ice345/my-hugo-blog"
  cta="访问 GitHub"
>}}

{{< promo-grid >}}
  {{< promo-card
    href="https://gohugo.io/"
    image="/img/logo.png"
    title="Hugo"
    description="快速的静态网站生成器。"
    badges="Static Site,Go"
    badgeColors="violet,blue"
  >}}
{{< /promo-grid >}}

{{< katex >}}

欧拉公式：\(e^{i\pi}+1=0\)。

$$
f(x) = \int_{-\infty}^{+\infty} e^{-x^2}\,dx
$$

\[
a^2 + b^2 = c^2
\]

---
title: "数论知识"
showMath: true
---

{{< badge >}}
Beta
{{< /badge >}}

{{< button href="https://gohugo.io/" target="_blank" >}}
打开 Hugo
{{< /button >}}

{{< button pageRef="notes/tools/" >}}
浏览工具笔记
{{< /button >}}

{{< icon "github" >}}
{{< icon "openlist" >}}
{{< icon "obsidian" >}}

{{< lead >}}
这是一段放大的文章导语。
{{< /lead >}}

{{< keywordList >}}
  {{< keyword icon="code" >}}Markdown{{< /keyword >}}
  {{< keyword icon="github" >}}GitHub{{< /keyword >}}
{{< /keywordList >}}

{{< swatches "#64748b" "#3b82f6" "#06b6d4" >}}

{{< mermaid >}}
flowchart LR
  A["写 Markdown"] --> B["Hugo 构建"]
  B --> C["生成 HTML"]
  C --> D["发布网站"]
{{< /mermaid >}}

{{< chart >}}
type: 'bar',
data: {
  labels: ['一月', '二月', '三月'],
  datasets: [{
    label: '文章数',
    data: [3, 5, 4]
  }]
}
{{< /chart >}}

{{< tabs >}}
  {{< tab label="macOS" >}}
  ~~~bash
  brew install hugo
  ~~~
  {{< /tab >}}

  {{< tab label="Linux" >}}
  ~~~bash
  sudo pacman -S hugo
  ~~~
  {{< /tab >}}
{{< /tabs >}}

{{< timeline >}}
  {{< timelineItem
    icon="code"
    header="开始写博客"
    subheader="Hugo + Markdown"
    badge="2026"
  >}}
  从 Markdown 开始记录学习过程。
  {{< /timelineItem >}}
{{< /timeline >}}

{{< typeit tag="h3" speed="50" loop="true" >}}
Hugo + Markdown
{{< /typeit >}}

{{< list limit=5 title="最近更新" cardView=true >}}

{{< list
  title="最近的笔记"
  limit=6
  where="Section"
  value="notes"
>}}

{{< article
  link="/notes/tools/docker/"
  showSummary=true
  compactSummary=true
>}}

{{< email
  email="mailto:hello@example.com"
  text="给我发邮件"
  subject="关于博客的留言"
>}}

{{< gist "octocat" "6cad326836d38bd3a7ae" >}}

{{< mdimporter
  url="https://raw.githubusercontent.com/example/project/main/README.md"
>}}

{{< codeimporter
  url="https://raw.githubusercontent.com/example/project/main/main.go"
  type="go"
  startLine="10"
  endLine="30"
>}}

{{< github repo="ice345/my-hugo-blog" showThumbnail=true >}}
{{< gitlab projectID="278964" >}}
{{< codeberg repo="forgejo/forgejo" >}}
{{< gitea server="https://git.example.com" repo="user/project" >}}
{{< forgejo server="https://forgejo.example.com" repo="user/project" >}}
{{< huggingface model="google-bert/bert-base-uncased" >}}
{{< huggingface dataset="stanfordnlp/imdb" >}}
{{< ansible role="geerlingguy.docker" >}}

<div dir="rtl" class="text-right">
  
هذه فقرة من اليمين إلى اليسار

</div>

[homepage]
layout = "background"
homepageImage = "/img/background.svg"
showRecent = true
showRecentItems = 6
cardView = true
layoutBackgroundBlur = true

[outputs]
home = ["HTML", "RSS", "JSON"]

enableSearch = true
enableCodeCopy = true
enableImageCopy = true

[tableOfContents]
startLevel = 2
endLevel = 4

[firebase]
lowerCasePath = true

[comments]
enable = true

[comments.waline]
enable = true
serverURL = "waline-blowfish-blog.vercel.app"

[comments.giscus]
enable = false

defaultAppearance = "light"
autoSwitchAppearance = true

[footer]
showAppearanceSwitcher = true
showScrollToTop = true

[article]
showEdit = true
editURL = "https://github.com/ice345/my-hugo-blog/tree/master/content"
editAppendPath = true

我的文章/
├── index.md
├── featured.jpg
└── images/
    ├── 01.jpg
    └── 02.jpg

https://www.bilibili.com/video/BV13h411k7Zk/

---
title: "一篇示例文章"
date: 2026-07-24T22:00:00+08:00
description: "这是一篇展示本站写作功能的示例文章。"
showTableOfContents: true
showMath: true
featureImage: "/img/kumiko_jump.png"
tags:
  - 示例
  - Hugo
categories:
  - 博客
---

## 导语

这是一段普通正文，可以使用粗体、斜体、行内代码和链接。

> [!TIP]
> 先写清楚内容，再补充复杂样式。

## 图片

{{< figure
  src="feature.jpg"
  alt="示例图片"
  caption="这是一段图片说明。"
>}}

## 重点提示

{{< alert icon="circle-info" >}}
这里是需要读者注意的信息。
{{< /alert >}}

## 图片画廊

{{< gallery >}}
  <img src="01.jpg" class="grid-w50" alt="照片 1" />
  <img src="02.jpg" class="grid-w50" alt="照片 2" />
{{< /gallery >}}

## 数学公式

{{< katex >}}

行内公式：\(a^2+b^2=c^2\)。

$$
E = mc^2
$$

## 代码

~~~bash
hugo server -D
~~~

## 外部链接

{{< link-card
  href="https://gohugo.io/"
  image="/img/logo.png"
  title="Hugo"
  desc="静态网站生成器。"
  eyebrow="Official Website"
  cta="访问官网"
>}}