【如何使用Docsify即时将你的文档转换成一个美观且易用的博客网站】

原创

wx60d2a462203aa 2025-01-02 12:02:48 ©著作权

文章标签 Docsify 二级子域名官网 文章分类 JavaScript 前端开发

©著作权归作者所有：来自51CTO博客作者wx60d2a462203aa的原创作品，请联系作者获取转载授权，否则将追究法律责任

💝💝💝欢迎来到我的博客，很高兴能够在这里和您见面！希望您在这里可以感受到一份轻松愉快的氛围，不仅可以获得有趣的内容和知识，也可以畅所欲言、分享您的想法和见解。
推荐:kwan 的首页,持续学习,不断总结,共同进步,活到老学到老
导航
檀越剑指大厂系列:全面总结 java 核心技术,jvm,并发编程 redis,kafka,Spring,微服务等
常用开发工具系列:常用的开发工具,IDEA,Mac,Alfred,Git,typora 等
数据库系列:详细总结了常用数据库 mysql 技术点,以及工作中遇到的 mysql 问题等
新空间代码工作室:提供各种软件服务,承接各种毕业设计,毕业论文等
懒人运维系列:总结好用的命令,解放双手不香吗?能用一个命令完成绝不用两个操作
数据结构与算法系列:总结数据结构和算法,不同类型针对性训练,提升编程思维,剑指大厂
非常期待和您一起在这个小小的网络世界里共同探索、学习和成长。💝💝💝 ✨✨ 欢迎订阅本专栏 ✨✨

博客目录

前言
1. 本地部署 Docsify
2. 使用 Docsify 搭建个人博客
3. 安装 Cpolar 内网穿透工具
4. 配置公网地址
5. 配置固定公网地址

前言

今天我要给大家推荐一款超级实用且方便的工具——Docsify，如果你是技术博主、开发者或者任何需要频繁撰写和分享文档的人，这款工具绝对能让你的工作变得更加轻松愉快。

在数字化时代，内容创作变得越来越重要，但如何高效地管理和发布这些内容却成了一个不小的挑战。传统的静态站点生成器如 GitBook 和 Hexo 虽然功能强大，但在使用过程中往往会遇到一些繁琐的步骤，比如需要生成大量的 HTML 文件、配置复杂的服务器设置等。这些问题不仅耗时费力，还容易出错。

而 Docsify 则完全颠覆了这一传统模式。它以 Markdown 为核心，能够即时将你的文档转换成一个美观且易用的网站，并通过 Cpolar 内网穿透工具轻松发布到公网。这意味着你不再需要复杂的路由器设置或昂贵的公网 IP 地址，只需几行简单的配置就能让你的内容瞬间触达全球。

【如何使用Docsify即时将你的文档转换成一个美观且易用的博客网站】_官网_02

接下来，讲解如何在本地部署 Docsify。

1. 本地部署 Docsify

本篇文章安装环境：Windows10

Docsify 项目 github 地址：GitHub - docsifyjs/docsify: 🃏 A magical documentation site generator.

Docsify 官方文档教程：https://docsify.js.org/#/zh-cn/

准备工具： node.js、Typora、cpolar 内网穿透

Node.js （官网）：https://nodejs.org/zh-cn

Typora（官网）：https://typoraio.cn

首先查看 node.js 是否已安装

node -v

查看 npm 是否已安装

npm -v

如未安装，进入到 node.js 官网下载安装

【如何使用Docsify即时将你的文档转换成一个美观且易用的博客网站】_官网_03

安装完后，接下来需要安装 Docsify 本地全局工具

npm i docsify-cli -g

【如何使用Docsify即时将你的文档转换成一个美观且易用的博客网站】_子域名_04

初始化 Docsify 本地项目

docsify init ./docs

【如何使用Docsify即时将你的文档转换成一个美观且易用的博客网站】_官网_05

启用本地网页预览

docsify serve docs

【如何使用Docsify即时将你的文档转换成一个美观且易用的博客网站】_二级_06

2. 使用 Docsify 搭建个人博客

打开此电脑——C 盘——用户——文档——docs 文件夹

初始化成功后，可以看到 ./docs 目录下创建的几个文件

index.html 入口文件
README.md 会做为主页内容渲染
.nojekyll 用于阻止 GitHub Pages 忽略掉下划线开头的文件

直接编辑 docs/README.md 就能更新文档内容，当然也可以[添加更多页面。

【如何使用Docsify即时将你的文档转换成一个美观且易用的博客网站】_二级_07

打开 README文档，做为主页内容渲染

【如何使用Docsify即时将你的文档转换成一个美观且易用的博客网站】_二级_08

在这个文档中进行修改，设计自己的个人博客，修改标题，添加文章内容，并保存

【如何使用Docsify即时将你的文档转换成一个美观且易用的博客网站】_Docsify_09

制作一个个人文档，我们只需要配置以下这几个基本文件就可以：

文件作用	文件
基础配置项（入口文件）	index.html
封面配置文件	_coverpage.md
侧边栏配置文件	_sidebar.md
导航栏配置文件	_navbar.md
主页内容渲染文件	README.md
浏览器图标	favicon.ico

还有很多配置项可以参考docsify文档中的定制化-配置项—小节，定制的东西越多，维护的难度就越大。侧边栏、导航栏和封面都建议采用默认的文件渲染：

这里举例官网的封面配置文件

封面配置文件（_coverpage.md）

封面的生成同样是从 markdown 文件渲染来的。开启渲染封面功能后在文档根目录创建 _coverpage.md 文件。渲染效果如本文档。

index.html

<!-- index.html -->

<script>
  window.$docsify = {
    coverpage: true,
  };
</script>
<script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script>
<!-- _coverpage.md -->

![logo](_media/icon.svg) # docsify <small>3.5</small>

> 一个神奇的文档网站生成器。 - 简单、轻便 (压缩后 ~21kB) - 无需生成 html 文件 -
众多主题 [开始使用 Let Go](/README.md)

【如何使用Docsify即时将你的文档转换成一个美观且易用的博客网站】_Docsify_10

继续回到我们刚才搭建的页面，打开一个新的浏览器，输入 localhost:3000，或者本机 IP 地址:3000

【如何使用Docsify即时将你的文档转换成一个美观且易用的博客网站】_Docsify_11

这样我们就在本地搭建了一个简单的个人文档博客，博客排版风格也可以自己随意设计，但是目前我们已经在本地搭建好了博客网站，如果没有公网 IP 的话，只能在本地局域网环境使用，有一定的局限性。如果出门在外想远程访问使用的话，可以结合 cpolar 内网穿透生成公网地址，免去了本地重新部署过程，只需要使用公网地址直接进就可以访问本地部署的 Docsify，随时管理网站。