博客功能引用书写说明

博客功能引用书写说明

本篇文章是在 qinghub.top 站点在使用 Markdown 写作方面的说明以及常用功能代码模块。 本站基于开源项目 Hugo 搭建,在此之上进行了功能修改,以下为部分功能修改和添加的引用说明。

🔐 文章访问密码

设置打开文章需要输入密码才可查看的代码,代码弹窗样式已经配置在本站源代码后台,使用前需要将以下代码引用块放在需要设置密码的文章正文最前面,标题的后面。

更改双引号内的字符 123456 即可设置密码,不需要使用密码访问默认不需要添加。

{{< page-password "123456" >}}

需要注意的是:由于本站为静态网站,此密码设置只是在前端,通过技术手段可能会被破解,重要涉密资料不建议使用此方法设置加密!

🏙️ 文章插入图片

在文章中插入图片直接拖入到文章即可,图片需要放在文章所在的文件夹下即可,但需要注意的是:务必将图片所在位置设置正确,否则图片无法加载,会显示裂开的图片图标。

[ ] 内可以输入图片的命名,不输入空白也是可以的;( )内输入图片所在GitHub的位置,将图片放在文章同文件夹内,输入图片的命名即可,需要注意的是,图片的拓展名仍需要输入。

引用图片示例:

![示例图片](示例图片.png)

引用成功示例:

测试图片-8451166

🎞️ 引用内嵌视频

由于本站建设为 GitHub 部署于 Cloudflare 的静态网站,没有后台服务器,视频常规情况下不能存储在服务器内,采用引用第三方视频模块内嵌页面方法较为稳妥,这里以中国大陆本土视频平台 Bilibili哔哩哔哩 为例。

在文章内输入以下代码,视频链接 src= 引号内的链接替换为你想要的视频链接即可,输入好后自动适配页面宽度。

<div style="position:relative;padding-bottom:56.25%;height:0;overflow:hidden;border-radius:12px;">
  <iframe 
    src="https://player.bilibili.com/player.html?isOutside=true&aid=77876973&bvid=BV17J411q77r&cid=133231252&p=1"
    scrolling="no"
    border="0"
    frameborder="no"
    framespacing="0"
    allowfullscreen="true"
    style="position:absolute;top:0;left:0;width:100%;height:100%;">
  </iframe>
</div>

引用成功示例:

如果此方法失效,为哔哩哔哩技术调整,最稳定的方法是直接展示链接,让用户转移到外链观看,效果和稳定性是最佳的。示例:

> 本文配套演示视频已发布在 Bilibili  
> 点击下方链接跳转观看(推荐使用原站播放器)

👉 https://www.bilibili.com/video/BVxxxxxxxxx

💾 添加下载模块

本站 GitHub 后台已经配置了下载附件模块的样式,如果需要添加下载附件模块,直接在文章内引用代码块即可。

  • title= 引号内可以输入需要下载的文件名称。
  • sub= 引号内可以输入提示文字。
  • url= 引号内输入你的下载链接
  • pass= 引号内输入你的下载密码 如果不需要密码,可以将 pass="你的下载密码" 列删除

代码块如下:

{{< download-card
title="资料下载:文件名"
sub="OneDrive · 输入密码后下载"
url="https://你的OneDrive直链"
pass="你的下载密码"
>}}

引用成功示例

密码:qingtop123

📁
资料下载:示例文件
PDF文稿 · 输入密码后下载

需要注意的是:由于本站为静态网站,此密码设置只是在前端,通过技术手段可能破解密码,重要涉密资料不建议使用此方法设置加密!

📄 其他写作:

其他写作样式可使用 Markdown 本身的样式,这里推荐使用 Typora 软件,这款软件是一款非常不错的 Markdown 写作软件,写作可视化,像写 Word 文稿一样轻松简单。

由于 Markdown 写作样式代码过多,这里暂时不展示。后续如果有需要,我会随时添加内容在此文章下。

如有疑问或探讨,请在 关于 页面随时与我联系。