乱七八糟

为什么你需要一个知识库

admin

2024年 10月 27日下午1:06 713 次查看

为什么你需要一个知识库？

知识需要归档沉淀。我们平时学习积累的知识，如果不及时进行整理归纳，很快就会忘记。合理的分类归档，既有利于日后检索与参考，又能避免在同一个地方踩坑。

用输出倒逼输入。若想快速掌握一门知识，最好的方法，就是用自己的话复述给别人听。如果你把能知识清晰地描述出来，那么你才算掌握它。有了持续的输出，当你不能清晰地描述知识时，就会通过主动学习来补充。从另一个方面来讲，这也促进了我们不断去进行阅读和输入。

赛博空间的桃源。在这一片自留地上，你可以避开主流互联网上的纷争（特指某些乌烟瘴气的言论）。我常把个人知识库当作世外桃源一样的存在，这是一个可以静下心来耕耘的地方。

为什么知识库要公开？

更加精致化的输出和整理。如果选择知识库不公开，那么要求就变低了。我们对知识的归纳整理，可能会慢慢变得随意，不会很注重规范和可阅读性。久而久之，知识库会慢慢变成草稿箱，甚至可能看不懂自己先前写了些什么。

分享让思想碰撞。知识需要分享，在碰撞中可能出现新的火花。当别人遇到一样的问题时，也可以直接发自己写过的教程，这样既方便又酷。

提升个人品牌，遇见志同道合的人。持续维护一个知识库，你会收获志同道合的读者和朋友。也许他们也对摄影、编程、搞电路、造机器人、读书等等感兴趣，也在经营着一个知识库或博客。另外，把知识库链接挂在各种社交平台首页或简历上，是绝对是可以展现个人实力的。

为什么选择自建知识库？

自建知识库的相对面，是在第三方平台上写作。第三方平台，指的是语雀、知乎、简书、公众号、CSDN 这一类平台。在这一类平台上，你不用去管底层是如何构建、基础功能怎么实现、文章图片如何存放、如何部署站点更新文章、如何去做 SEO 等等，你只需要写下文字，剩下的全部由平台帮你实现。简而言之，可以傻瓜式地写作，且平台附加巨大的流量。既然如此方便，为什么我们还是提倡自建知识库呢？

首先，是 数据安全 问题。你在第三方平台上留下的文字，所有权并不归属与你。

互联网发展到现今这个阶段，大多数平台都在筑墙。他们会接受数据导入，但你若想批量迁出数据，他们会设置障碍。另外，很多平台会阻止外链，其本意是留住用户、阻止流量流向别的平台，但这非常不利于知识的交流和碰撞。

特别提及微信公众号，截至目前，发出去的文章最多也只能删改 20 个字符。而我们都知道，很多知识并不是一成不变的，是要不断更新的，这就很不利于知识的迭代更新。

将数据完全托付给平台，是非常不保险的行为。当你的文章内出现了相对敏感的内容，或是对平台的负面言论，他们常用的手段是封禁和要求删改。假若平台的服务器遭受黑客攻击，或者平台某天倒闭了，他们也没有义务恢复并归还你的数据。说到底，托付给平台，你对自己的数据没有完全掌控的权利。

其次，是 可定制性 的问题。你选择了平台，就必须接受它的样式和 UI，有时候还得忍受文章边角的各种牛皮藓广告。相比之下，自建平台，UI 可完全自定义。清爽简洁的版面，对阅读体验的提升无疑是巨大的。

说到底，第三方与自建的关系，就像租房子与买房子的关系。选择租房子，你可以付出更少，入住更方便，可以在有限制的自由里装饰你租来的屋子。但是你所拥有的，是使用权而不是所有权；而买来的房子，你可以随意更换装修风格，可以随意在房间里堆放你想要的东西，你对其拥有所有权。

为什么要知识库而不是文章流？

文章流指的是博客、公众号及大部分平台的形式，即主要以时间线来归档文章。相对地，知识库（Wiki）的形式，主要是以类别来收纳文章，就像是在翻阅一本档案，更利于检索和分类阅读。

为什么要知识库而不是文章流呢？首先，一些琐碎但不可或缺的知识，并不适合单独成文、长篇大论。如果是以文章流的形式，其权重和其他文章是相同的，这样会冲淡整个站点的文章纯度。但是，体系化的文章，又是从这些零散的知识生长而来的。相对而言，以知识库的形式作为载体，以类别形式来做区分，就很合适了。

另一方面，我之前在 卡片式写作 这篇文章中曾经提及，每一份的基础知识，相当于一张小卡片，一层一层往上抽象，不同的顶层文章可以调用相同的底层卡片，既提高知识的复用率，也减少做重复的无用功。

工具的选择

至于知识库的选型，个人看重的主要是以下几点：

基础功能：侧边栏可显示文章标题及其归属类别，主版面显示文章内容，内容支持 Markdown 语法，内容与框架相互独立。
搜索功能：搜索功能是类别归档的补充，有时候以大类别查找一个特定的知识点并不方便，但有了全站搜索就能直接传送到点。
项目开源：知识库的平台一定要是开源的，因为闭源的项目，可能会因维护者个人或团队的原因停止更新或支持，遇到 bug 也未能及时处理解决（此处特指 GitBook 和 Bitcron）。
静态网站：静态网站能托管在 GitHub Pages 等平台，无需单独购买服务器，一方面省钱易维护，另一方面也对 SEO 友好。
应易于搭建，便于部署与更新：知识库的架设不应该花过多的时间，内容更新的流程也不应过于复杂。
UI 简洁美观：为了阅读体验，版面 UI 应尽量保持清爽美观，且最好有夜间模式。

自建知识库的局限性

当我看到他人对某个平台只有赞美，没有批评；对该平台的某些问题只字不提，选择性失明，过分赞美某些长处；所有的赞美都是热血澎湃，丧失理性…… 我便提高警惕，强迫自己不被带动情绪，理性看待这个平台的一切东西。

我不希望大家只了解自建知识库的优点，需要说明的是，自建知识库有一定的局限性。只有充分了解其利与弊，才能根据自己的目的去做出选择。

流量问题。依靠第三方平台，你产出的内容更容易被大家读到，也更容易被展示在搜索引擎结果的前十之内。相对来说，自建平台一般很大的流量，也就意味着没什么读者。不过，我们可以使用一文多发的方法来解决这个问题，简而言之，就是基于知识库，使用 Artipub 等工具，将内容同步发至各第三方平台，将流量引导至个人知识库。

自建知识库有一定的技术门槛。对于没有接触过 Jamstack（JavaScript，API & Markup）理念及其相关技术链的读者而言，可能需要经过一定的学习。这个问题我会在 个人知识库的搭建 – 基于 Docusaurus 这篇文章中逐一进行讲解。

静态网站无在线编辑器。换句话说，如果选择了静态网站，那么编辑器和网站本身是分离的，无法像知乎那样在其网页或 App 上直接编辑内容并发布。你需要一个本地的编辑器，例如 VS Code 或 Typora. 不过解决方法也是有的，可以跳转文章 如何在 iPad 上运行 VS Code 。

知识点同时隶属与多个类别。一般来说，知识库仅以类别收录文章，为了避免冗杂，单篇文章仅可属于于一个类别。但举个例子，如何设计一款单片机的最小系统 这篇文章，既属于 电路设计 一类，又属于 STM32 一类，那该如何收录？我的解决方法是根据文章的内容，收录于相关程度更高的类别。之所以不采用标签系统，是因为标签容易泛滥，泛滥之后检索起来不如类别分类加搜索功能方便。

我都用过哪些平台？

WordPress：使用方便但底层过于庞大复杂，需要使用数据库，不利于迁出。
Hexo：较为冗杂，且没有比较好看的 Wiki 主题。
GitBook：CLI 版本已停止更新支持，V2 版本国内访问速度较慢。
Jekyll：技术相对较旧且缺少更新支持。
GitHub Issues/Gist/Wiki：国内访问速度较慢，UI 不可定制。
Bitcron：托管动态网站，可定制性较差，访问速度时快时慢。
DokuWiki：需自备服务器，且其本身过于老旧。
Gridea：部署简单，但可定制性较差，只能用其专用编辑器。
wiki.js：需自备服务器搭建，一般适用于团队知识库，存在部分小问题。
语雀：相对还不错的第三方知识库平台，缺点是 UI 不可定制，且数据迁出不方便。
Hugo：部署速度快，但没有比较好看的 Wiki 主题。
Gatsby：与 Hugo 相似。
Ghost：动态网站，UI 美观，需要自备服务器（或花钱买服务），可定制性较差。
docsify：比较推荐。部署简易，UI 美观，但因为其加载时渲染的特性，在某些设备上运行性能较差。
Docute: 比较推荐。部署简易，UI 美观，也是加载时渲染内容，相比 docsify 少了很多插件。
VuePress：比较推荐。各方面相对都很不错，社区插件多，局限性是官方文档较乱，有些微小的 bug。
Docusaurus：比较推荐。各方面相对都不错，局限性是编译较慢，框架比较臃肿。
MkDocs（配合 Material 主题）：比较推荐。各方面相对都很不错，编译也相对快，我的网站现在使用的方案。

总结

临渊羡鱼，不如退而结网。

分享文章

上一篇文章

常用vscode配置和git命令备忘

下一篇文章

个人知识库的搭建 - 基于 Docusaurus

所有评论(61)

https://glassi-info.Blogspot.com/2025/08/deposits-and-withdrawals-methods-in.html说道：

2025年 8月 26日上午1:25

Very descriptive article, I enjoyed that bit. Will there be a part 2? https://glassi-info.Blogspot.com/2025/08/deposits-and-withdrawals-methods-in.html

回复
what is a buy in craps说道：

2025年 9月 18日下午5:45

playtech casinos usa, casino victoria bc canada and
windsor casino what is a buy in craps united states, or best
craps online canada

回复
free sign up bonus no deposit说道：

2025年 10月 2日下午1:03

united states no deposit pokies, real pokies canada and uk online casinos free sign up bonus no deposit play, or new no deposit bonus casino australia

回复
how Do you gamble online说道：

2025年 10月 4日上午1:17

best gambling website canada, best how Do you gamble online pokies in canada and
free online poker united states, or does united kingdom have casinos

回复
goplayslots.net说道：

2025年 10月 7日上午5:46

free slots australia online, casino chips value usa and new casino sites uk no deposit bonus,
or top online pokies and casinos canadian open 2021

Also visit my web blog … goplayslots.net

回复
Deborah说道：

2025年 10月 7日下午10:11

are there casinos in montreal australia, usa online what is
casino coin (Deborah) reviews and casino online real money
australia, or bingo no deposit bonus win real money united states

回复
clayton Homes Blackjack modular说道：

2025年 10月 9日下午10:00

casino in british columbia united kingdom, list of casinos
in usa and australian casino chips, or online casino slots real money australia

Take a look at my web site :: clayton Homes Blackjack modular

回复
Gratiswette für neukunden说道：

2025年 10月 10日上午12:56

handicap wette

my site: Gratiswette für neukunden

回复
wettbüRo nähe说道：

2025年 10月 10日下午3:59

best sportwetten

Here is my site :: wettbüRo nähe

回复
Basketball Over Under Wetten说道：

2025年 10月 11日上午2:07

pferderennen iffezheim Basketball Over Under Wetten

回复
Taren说道：

2025年 10月 11日上午4:53

dfb pokal wett tipps

My webpage; beste wetten heute (Taren)

回复
Wir wetten schweiz说道：

2025年 10月 11日上午9:21

Wir wetten schweiz ohne einzahlung
geizkragen

回复
sportwetten online Wetten说道：

2025年 10月 11日下午6:54

buchmacher köln

Feel free to visit my webpage: sportwetten online Wetten

回复
wetten kein sport说道：

2025年 10月 12日下午1:00

quote bei wetten kein sport dass

回复
buchmacher Deutschland说道：

2025年 10月 12日下午1:37

us wahlen wettquoten

my blog … buchmacher Deutschland

回复
sportwetten ohne lizenz说道：

2025年 10月 12日下午4:21

online sport wetten

Also visit my web page – sportwetten ohne lizenz

回复
pro.ctjebu.org说道：

2025年 10月 12日下午5:45

handicap wetten erklärung

Also visit my web blog: wettbüro Karlsruhe (pro.ctjebu.org)

回复
buchmacher Bonus ohne einzahlung说道：

2025年 10月 12日下午10:36

live wett tipps

my webpage; buchmacher Bonus ohne einzahlung

回复
Gratiswette ohne einzahlung ohne oasis说道：

2025年 10月 12日下午11:33

wettbüro dresden speisekarte

My blog – Gratiswette ohne einzahlung ohne oasis

回复
Taylah说道：

2025年 10月 13日下午8:24

wettquoten berechnen

my website: sportwetten schweiz verboten (Taylah)

回复
Beste tour De france Wettanbieter说道：

2025年 10月 14日上午3:44

Beste tour De france Wettanbieter deutschland bonus

回复
mind vault说道：

2025年 10月 14日上午5:58

**mind vault**

mind vault is a premium cognitive support formula created for adults 45+. It’s thoughtfully designed to help maintain clear thinking

回复
https://friendscables.Com.pk说道：

2025年 10月 14日上午10:03

sportwetten wer Wird deutscher meister [https://friendscables.Com.pk] tipps strategien

回复
wettquoten vergleich说道：

2025年 10月 14日下午10:13

beste sportwetten tipps seite

Also visit my webpage: wettquoten vergleich

回复
vergleich wettanbieter说道：

2025年 10月 14日下午11:21

online sport wetten

My web site … vergleich wettanbieter

回复
Tipps Zu Sportwetten说道：

2025年 10月 15日上午1:06

wettanbieter deutschland lizenz

Stop by my web page Tipps Zu Sportwetten

回复
Candy说道：

2025年 10月 15日上午1:53

wett tipps heute ki

Feel free to surf to my page bonus buchmacher (Candy)

回复
Wetten Ohne einzahlung öSterreich说道：

2025年 10月 16日上午12:28

wett-tipps heute

my website :: Wetten Ohne einzahlung öSterreich

回复
beste Sportwetten App Android说道：

2025年 10月 16日上午1:43

buchmacher de

Feel free to surf to my blog :: beste Sportwetten App Android

回复
Https://Www.Gensamakina.Com说道：

2025年 10月 16日上午5:18

beste wettanbieter cash out

Here is my website: Gratiswetten FüR Bestandskunden – https://Www.Gensamakina.Com,

回复
besten sportwetten bonus说道：

2025年 10月 16日上午5:56

besten sportwetten bonus
forum tipps

回复
deutschland Ungarn Wettquoten说道：

2025年 10月 16日下午8:37

wettbüro berlin spandau

My web page deutschland Ungarn Wettquoten

回复
Frank说道：

2025年 10月 16日下午11:07

mit sportwetten geld verdienen

my web page … buchmacher pferderennen deutschland – Frank –

回复
was ist handicap wette说道：

2025年 10月 17日下午10:43

sport bild wetten

My web-site was ist handicap wette

回复
wetten deutschland说道：

2025年 10月 18日上午4:56

wetten deutschland
dass unfall samuel koch heute

回复
wett tipps Heute说道：

2025年 10月 18日下午4:22

seriöse sportwetten wett tipps Heute

回复
Homer说道：

2025年 10月 18日下午10:33

wetten olympische spiele

Review my blog; wettseiten (Homer)

回复
Beste wettanbieter app说道：

2025年 10月 18日下午11:12

wetten dass online spielen

Feel free to surf to my site … Beste wettanbieter app

回复
wettbüRo ludwigshafen说道：

2025年 10月 19日上午2:36

sieg platz wette pferderennen

Also visit my web-site – wettbüRo ludwigshafen

回复
online sportwetten bonus ohne einzahlung说道：

2025年 10月 19日上午2:37

beste online sportwetten bonus ohne einzahlung app schweiz

回复
Die Besten Sportwetten Bonus说道：

2025年 10月 20日下午7:47

wir wetten app

Also visit my webpage – Die Besten Sportwetten Bonus

回复
Buchmacher pferderennen说道：

2025年 10月 21日上午1:16

sportwetten bester anbieter

my blog – Buchmacher pferderennen

回复
Mathew说道：

2025年 10月 22日上午1:35

sportwette

Also visit my web blog; wettanbieter mit gratiswette
(Mathew)

回复
wetten mit bonus说道：

2025年 10月 22日上午2:28

krypto wettanbieter

my site :: wetten mit bonus

回复
Jayme说道：

2025年 10月 23日上午1:31

kombiwette pferderennen

my homepage :: doppelte chance wette (Jayme)

回复
thesoccersport.com说道：

2025年 10月 23日上午2:33

sportwetten vorhersage

Here is my webpage; esc deutschland buchmacher (thesoccersport.com)

回复
wer hat Die besten quoten sportwetten说道：

2025年 10月 23日上午4:57

alle wettanbieter deutschland

Visit my page :: wer hat Die besten quoten sportwetten

回复
Cameron说道：

2025年 10月 23日上午9:19

neue sportwetten bonus

Feel free to visit my blog post … wie funktionieren live wetten – Cameron –

回复
legit ways to make money online As a teenager说道：

2025年 10月 24日上午2:54

What’s up, every time i used legit ways to make money online As a teenager check web site posts here early in the daylight, because i like to learn more and more.

回复
operation-digital.Digital-Tycoons.com说道：

2025年 10月 24日上午4:36

sportwetten anbieter mit paypal

Also visit my homepage :: buchmacher kreuzworträtsel (operation-digital.Digital-Tycoons.com)

回复
Inez说道：

2025年 10月 24日上午5:58

united statesn online casino play roulette game free (Inez) spins sign up,
usa visa slots availability in hyderabad 2021 and state gambling revenue australia,
or how to win on the pokies in united states

回复
Wettanbieter bonus Vergleich说道：

2025年 10月 24日下午5:38

österreich frankreich wetten

Also visit my web-site … Wettanbieter bonus Vergleich

回复
Beste quoten sportwetten说道：

2025年 10月 24日下午7:59

wetten deutschland england

Review my blog post – Beste quoten sportwetten

回复
Arleen说道：

2025年 10月 24日下午11:58

Great post.

Feel free to surf to my webpage … how to play online casino
roulette (Arleen)

回复
Shane说道：

2025年 10月 25日下午8:45

pferderennen dresden wetten

Here is my webpage … wettanbieter deutschland ohne oasis
[Shane]

回复
wetten dass Tickets Gewinnen说道：

2025年 10月 25日下午9:10

wettbüro eröffnen

Here is my site … wetten dass Tickets Gewinnen

回复
Lula说道：

2025年 10月 26日上午1:13

wetten gewinnen

Also visit my web blog :: bonus wettanbieter (Lula)

回复
Lashonda说道：

2025年 10月 26日上午5:42

asiatische handicap wette

Here is my homepage beste overwatch wettanbieter –
Lashonda –

回复
Freepal.Net说道：

2025年 10月 27日上午2:26

was passiert wenn beim wetten ein spiel abgesagt wird

my website: sportwetten deutsche lizenz (Freepal.Net)

回复
https://Planetacyber.COM.Br/说道：

2025年 10月 27日下午10:55

beste wett prognose Heute – https://Planetacyber.COM.Br/, seite

回复
sportwetten tipps für anfänger说道：

2025年 10月 28日下午9:12

beste mls wettanbieter

Here is my page … sportwetten tipps für anfänger

回复