你好，世界

发表于 | 分类于

我的第一篇文章

Markdown语法

  • md文件中可以使用html标签
  • ---代表分割线

图片调整

1
2
3
4
5
6
7
8
9
10
11
> 调整尺寸大小
![固定宽高(=前有一个空格)](https://example.com/test.png =600x600)
![固定宽度](https://example.com/test.png =600x)
![固定高度](https://example.com/test.png =x600)

> 调整对齐方式
![居中](https://example.com/test.png#pic_center =600x600)
![靠左对齐](https://example.com/test.png#pic_left =600x600)
![靠右对齐](https://example.com/test.png#pic_right =600x600)

> 或者使用img标签

代码块

1
2
- cluster.slaveCount: 2
+ cluster.slaveCount: 3

排版

  • 正文的第一级标题用h2(##)，标题和字段间要有换行

详细隐藏/展示

1
2
3
4
5
<details>
<summary>详细隐藏/展示的标题</summary>

<p>详细内容......</p>
</details>

列表

  • 列表（有序/无序）下面显示 代码、引用、图片 时：相对列表的该子项代码需要多缩进一个Tab（4个空格），且中间要空行，如：

    - 标题

  ```html
    ...
  ```
  • 引用需要上下都空一行，列表只需要在上面空一行
  • 子列表基于父列表要有一个Tab缩进(4个空格)，中间无需空行

链接

  • 图片格式如：![hello](/data/images/2017/07/hello.png)
  • 内部链接格式如：[《nginx》http://blog.aezo.cn/2017/01/16/arch/nginx/](/_posts/arch/nginx.md#基于编译安装tengine)，其中#后面为完整子标题
  • hexo转义字符
    • 如写vue代码的时会出现双大括号导致hexo编译失败，此时提示如Template render error: (unknown path) [Line 31, Column 21]。如果写成代码块则不会报错，或普通文本时使用&#123;&#123;&#125;&#125;进行转义
    • { 对应 &#123;
    • } 对应 &#125;
    • 不建议在一行中出现<xxx>字符
    • 相关转义符：https://www.dazhuanlan.com/2020/04/19/5e9be4c323d8a/
  • hexo文章元信息---后面不能有空格，否则容易报错YAMLException: bad indentation of a sequence entry
  • 锚链接和连接带空格案例 [MD 语法](#MD%20语法) MD 语法。连接中空格使用%20代替

脚注

脚注支持链接跳转，注意脚注与被批注文本之间有一个空格

标题或者文字 [^1]

---

参考文章

[^1]: [http://blog.aezo.cn](http://blog.aezo.cn)

表格

表头表头
单元格单元格
单元格单元格
  • 复制网页表格到markdown文件：先复制到typora，然后打开typora源码模式复制markdown表格代码

github-jeykll-markdown个人书写习惯

2017-07-01 之后使用hexo书写博客, 格式依然可用

元信息

  • categories和tage都可以有多个。其中---后面不能有空格
1
2
3
4
---
categories: [cat1, cat2]
tags: [tag1, tag2, tag3]
---

github-hexo-markdown个人书写习惯

修改文章后保存源码并更新博客

  • 更新步骤如下 (或者直接执行项目目录下的blog-deploy.sh文件)

    1
    2
    3
    4
    5
    6
    $ hexo clean # 有时候修改了静态文件需要先clean一下
    $ git add .
    $ git commit -am "update blog"
    # git push origin master:source # 如果本地master为源码分支，远程source为源码分支(远程master为发布分支)
    $ git push origin source:source # git push
    $ hexo g && gulp && hexo d

  • 其中gulp仅仅是压缩代码，提高访问速度

    • npm install --global gulp-cli
    • npm install gulp-htmlclean gulp-htmlmin gulp-minify-css gulp-uglify gulp-imagemin --save
    • mac在安装gulp-imagemin时，相关依赖安装失败，可去掉图片的压缩

博客源码管理和博客更新

  • 本地处于master分支，远程有master(为博客渲染后的代码)和source(博客源码, 可设为远程默认分支)两个分支

  • 更新博客 hexo d -g

    • _config.yml文件中需要指向master分支

      1
      2
      3
      4
      deploy:
        type: git
        repository: https://github.com/aezocn/aezocn.github.io.git
        branch: master

相关命令

  • hexo clean 清除缓存(如果未修改配置文件可不运行)
  • hexo g/hexo generate 静态文件生成(修改主题文件可不用重新启动服务)
  • hexo s -p 5000(hexo server) 启动本地服务器(本地测试)
  • hexo d/hexo deploy 部署到github

clone

  • clone远程source分支到本地master分支
  • npm install -g hexo-cli 全局安装hexo
  • npm install 初始化
  • 按照上述【修改文章后保存源码并更新博客】进行部署

功能

文章链接配置

搜索

  • NexT主题本地搜索
    • 安装：npm install --save hexo-generator-search
    • 开启local_search
    • 还可手动写本地搜索功能 ^1
    • 速度较慢，可搜索内容
  • 基于 Algolia 的搜索
    • 免费账户总共有 10,000 条记录，每月有 50,000 的可以操作数(操作索引)，可无限搜索
    • 速度较快但是只能搜索标题标签等，不能搜索内容
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# 参考：http://blog.langpz.com/Hexo-Next%E9%9B%86%E6%88%90Algolia%E6%90%9C%E7%B4%A2.html

# 注册 Algolia 账号
# 创建索引，手动创建KEY并设置权限

# 安装插件
npm install hexo-algolia --save

# 站点根目录打开_config.yml添加以下代码
# Algolia Search API Key
algolia:
  applicationID: '你的Application ID'
  apiKey: '你的Search-Only API Key'
  indexName: '输入刚才创建index name'

# 命令行执行，上传数据生成索引
export HEXO_ALGOLIA_INDEXING_KEY=a91f1b54121e881406b55730276f2384 # Search-Only API Key
hexo algolia

PlantUML

  • npm install --save hexo-filter-plantuml 安装插件(vscode可以再配合插件PlantUML使用)
  • markdown语法如下
```plantuml
@startuml
/' 样式(背景和波浪线条)和标题。这是代码注释，不会渲染 '/
skinparam backgroundColor #EEEBDC
skinparam handwritten true
title
  标题和水印 <img:http://blog.aezo.cn/aezocn.png>
end title

Bob->Alice : hello
@enduml
```

markdown标题编号(css实现)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
/* markdown标题编号 */
.post-body {
    /* 文章标题习惯从h2开始
    h1 {
        counter-increment: counter_h1;
        counter-reset: counter_h2;
    }
    h1:before {
        content: counter(counter_h1)"　";
    } 
    */
    h2 {
        counter-increment: counter_h2;
        counter-reset: counter_h3;
    }
    h2:before {
        content: counter(counter_h2)"　";
    }
    h3 {
        counter-increment: counter_h3;
        counter-reset: counter_h4;
    }
    h3:before {
        content: counter(counter_h2)"."counter(counter_h3)"　";
    }
    h4 {
        counter-increment: counter_h4;
        counter-reset: counter_h5;
    }
    h4:before {
        content: counter(counter_h2)"."counter(counter_h3)"."counter(counter_h4)"　";
    }
    h5 {
        counter-increment: counter_h5;
        counter-reset: counter_h6;
    }
    h5:before {
        content: counter(counter_h2)"."counter(counter_h3)"."counter(counter_h4)"."counter(counter_h5)"　";
    }
    h6 {
        counter-increment: counter_h6;
    }
    h6:before {
        content: counter(counter_h2)"."counter(counter_h3)"."counter(counter_h4)"."counter(counter_h5)"."counter(counter_h6)"　";
    }
}

主题

next

  • 自定义代码在/themes/next/layout/_custom/目录下
  • footer代码修改 /themes/next/layout/_partials/footer.swig
  • 部分图片禁用fancybox，可在img上加class="nofancybox"。需要修改主题中的js文件，详细修改方法参考https://blog.csdn.net/cddchina/article/details/79764432

语雀使用

  • 可将一个知识库进行互联网密码分享
    • 分享后，新建的文章默认使用相同的密码进行查看
    • 可单独关闭某篇文章的共享功能(需在网页进行设置)，此时通过密码访问到知识库的用户可在目录中查看到该文章标题，但是无法查看内容

CSDN

参考文章

ChatGPT开源小程序