Blog

• Markdown 效果展示
• 博客构架工具对比
• 测试Template中函数/变量的取值
• 项目说明

Markdown 效果展示

H1

H2 标题

H3

H4

H5

H6

####### H7

######## H8

emoji

👨🏻‍💻 🕵️‍♂️ 🦌 🐳 🙄 🤹 💲

表格

列表

• This is an unordered list following a header.
• This is an unordered list following a header.
• This is an unordered list following a header.

1. This is an ordered list following a header.
2. This is an ordered list following a header.
3. This is an ordered list following a header.

• It may seem strange to see a “Hello” post from a project that’s several years old
• but as Docsy matures as a community-driven project
• we thought it was time to (re)introduce ourselves and talk about what’s new with your favorite (we hope) Hugo documentation theme!

链接

Docsy now has a Project Steering Committee! The PSC members are @chalin, @LisaFC, @geriom, and @emckean. If you’re interested in serving on the PSC, open an issue and nominate yourself!

公式

数学公式

KaTeX LaTeX

内联公式：

When \(a \ne 0\), there are two solutions to \(ax^2 + bx + c= 0\) and they are \(x = {-b \pm \sqrt{b^2-4ac} \over 2a}\).

显示模式的公式：

The probability of getting \(k\) heads when flipping \(n\) coins is:

$$ \tag*{(1)} P(E) = {n \choose k} p^k (1-p)^{n-k} $$

化学方程式和物理单位的显示

mhchem

Precipitation of barium sulfate: \(\ce{SO4^2- + Ba^2+ -> BaSO4 v}\)

$$ \tag*{(2)} \ce{Zn^2+ <=>[+ 2OH-][+ 2H+] $\underset{\text{amphoteric hydroxide}}{\ce{Zn(OH)2 v}}$ <=>[+ 2OH-][+ 2H+] $\underset{\text{tetrahydroxozincate}}{\ce{[Zn(OH)4]^2-}}$} $$

• Scientific number notation: \(\pu{1.2e3 kJ}\) or \(\pu{1.2E3 kJ}\) \
• Divisions: \(\pu{123 kJ/mol}\) or \(\pu{123 kJ//mol}\)

绘制图表

​ Mermaid

graph TD
  Start --> Need{"Hugo version >= 0.93.0"}
  Need -- No --> Off["Set params.mermaid.enable = true"]
  Off --> Author
  Need -- Yes --> Author[Insert mermaid codeblock]

PlantUML

participant participant as Foo
actor       actor       as Foo1
boundary    boundary    as Foo2
control     control     as Foo3
entity      entity      as Foo4
database    database    as Foo5
collections collections as Foo6
queue       queue       as Foo7
Foo -> Foo1 : To actor
Foo -> Foo2 : To boundary
Foo -> Foo3 : To control
Foo -> Foo4 : To entity
Foo -> Foo5 : To database
Foo -> Foo6 : To collections
Foo -> Foo7: To queue

MarkMap

# markmap

## Links

- <https://markmap.js.org/>
- [GitHub](https://github.com/gera2ld/markmap)

## Related

- [coc-markmap](https://github.com/gera2ld/coc-markmap)
- [gatsby-remark-markmap](https://github.com/gera2ld/gatsby-remark-markmap)

## Features

- links
- **inline** ~~text~~ *styles*
- multiline
  text
- `inline code`
-
    ```js
    console.log('code block');
    ```
- Katex - $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$

博客构架工具对比

• dynamic | WordPress - PHP
  • 问题：
    • 环境。。。维护！维护！维护！
    • 插件。。。维护！维护！维护！
    • 安全警告？维护！维护！维护！
    • 性能。。。钱！钱！钱！
    • 备份！备份！备份！
• static | hugo - Go
  • github | 2023年10月23日 star=69k
  • themes
    • academic - 用途：个人博客
    • docsy - 用途：产品文档
    • docuapi - 用途：API文档
  • 问题：
    • 入门门槛相对高 (主要是概念多且相互关联。好在官方文档足够详细)
• static | jekyll - Ruby
  • github | 2023年10月23日 star=47k
  • 问题：
    • 环境复杂 (主要是不熟悉 Ruby 环境)
    • 中文资料不多
    • 构建时，插件需要同步更新
• static | hexo - node.js
  • github | 2023年10月23日 star=37k
  • 问题：
    • 默认提供的功能相对有限
    • 插件需要定期更新维护
• static | mkdocs - python
  • github | 2023年10月20日 star=17k
  • themes
    • mkdocs-material | 2023年10月20日 16k star
• static | mdBook - Rust
• ??? | Pelican - Python
• ??? | Rails - ???
• ??? | Express.js - node.js???
• ??? | gitbook - ???

测试Template中函数/变量的取值

This is Content!

使用 {{.Name}} 形式调用。

Shortcode

this Shortcode

Page

This Page

“Home” Page

Section Page

# ""

# “Blog”

# “Community”

Site

项目说明

Getting Started

1npm install

1npm run prepare
2npm run server
3npm run build
4npm run clean
5npm run build:production

Contribution Guidelines

markdown style

1# vscode
2code --install-extension DavidAnson.vscode-markdownlint