This is a Chinese article for authors who use this theme (hugo-nuo). Here are some examples about how to use the features of this theme.

这篇文章集中说明本人博客主题所支持的 Markdown 语法和 Hugo Shortcodes 插件,你也可以在这里预览到他们的样子。如果你不喜欢某些部分的样式,可以去修改 content.scssshortcodes.scss 这两个文件。预告一下,我所用的这个名为 NuoHugo 也将于近期发布,敬请期待。

1. 标题

H1

H2

H3

H4

H5
H6

2. 段落

使用单引号 * 或者单下划线 _ 标记 斜体强调 或者 斜体强调

使用两个引号 ** 或者两个下划线 __ 标记 加粗强调 或者 加粗强调

引号和下划线可叠加使用 → 只是加粗 斜体并加粗

使用两个波浪线 ~~ 标记 已删除文字

插入文字暂无 Markdown 标记,直接使用 HTML 标签 <ins> 标记 插入文字

行内代码使用反引号标记 → print("hello world")

上标 X2 / 下标 X2

按键 Ctrl

外链 chekun’s blog

页面内段落 图片

注意:你可以通过 {#section-id} 方式自定义段落锚点

参考资料 [1][2]

数字引用 编号为 1 的链接

3. 列表

以下的无序、有序和任务列表均支持二级嵌套,不建议使用二级以上嵌套。

3.1 无序列表

3.2 有序列表

  1. 有序列表
    1. 嵌套的有序列表
    2. 嵌套的有序列表
  2. 有序列表
    • 嵌套的无序列表
    • 嵌套的无序列表
  3. 有序列表

3.3 定义列表

CSS
层叠样式表

3.4 任务列表

4. 引用

野火烧不尽,春风吹又生。

– 白居易《赋得古原草送别》

5. 代码

以本站的一段 JavaScript 代码做演示。

// Initialize video.js player
if (document.getElementById('my-player') !== null) {
  /* eslint-disable no-undef */
  videojs('#my-player', {
    aspectRatio: '16:9',
    fluid: true,
  });
}

6. 分割线


中间能写字的分割线,如果你修改了分割线中字的内容,请配合修改 CSS 样式。

7. 图片

不带标题的图片,如下图👇

这是一只梅花鹿

带标题的图片(zoomable),如下图👇

这是一只梅花鹿

显然,这是一只梅花鹿

8. 表格

使用 Markdown 画的表格,如下表👇

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

使用 HTML 画的表格,如下表👇

注意:下表叠加应用了 is-centered is-striped is-bordered is-narrow 四种表格样式。

值班人员 星期一 星期二 星期三
李强 张明 王平

9. 数学公式

主题使用了 MathJax 开源库来实现对数学公式的支持,使用 $$ 标记。

$$ \left\{ \begin{aligned} N & = pq \\ \varphi(n) & = (p-1)(q-1)\\ \end{aligned} \right. \Rightarrow N - \varphi(n) + 1 = p + q $$

10. JSFiddle

引入 JSFiddle 网站的代码范例,在主题目录 layouts/shortcodes 文件夹下的 jsfiddle.html 对该标签进行定义。

11. Codepen

引入 Code Pen 网站的代码演示,在主题目录 layouts/shortcodes 文件夹下的 codepen.html 对该标签进行定义。

See the Pen 🐍 Snake Rush by Ritchie Zhu (@laozhu) on CodePen.

12. 声享 PPT

引入 声享 PPT 演示文稿,在主题目录 layouts/shortcodes 文件夹下的 shengxiang.html 对该标签进行定义。

13. 本地视频

主题使用了 video.js 播放视频文件,你还可以自己定义视频的封面,在主题目录 layouts/shortcodes 文件夹下的 video.html 对该标签进行定义。

To view this video please enable JavaScript, and consider upgrading to a web browser that supports HTML5 video

14. 网易云音乐

主题文章中可以轻松插入 网易云音乐 的指定音乐,你可以根据需要将音乐设置为自动播放,在主题目录 layouts/shortcodes 文件夹下的 music.html 对该标签进行定义。

注意:由于版权问题,网易已经禁止外站分享版权音乐,该 shortcode 已经无法正常使用。

15. Gist 代码片段

除了本地的代码片段,主题中可使用 GitHubGist 服务轻松插入代码片段。

16. Tweet

由于不明原因可能无法访问。

17. YouTube

由于不明原因可能无法播放。

18. Instagram

由于不明原因可能无法访问。

文章更新

2017年9月8日

支持行内的数学公式,使用标记 $ 包裹公式,如下:

When \(a \ne 0\), there are two solutions to $ax^2 + bx + c = 0$ and they are

\begin{align} \label{dfdf} x = {-b \pm \sqrt{b^2-4ac} \over 2a}. \end{align}

参考资料

  1. Markdown Cheatsheet

  2. Markdown 语法手册