最近更新

下一代主题插件 MaterialX
MaterialX for MkDocs，下一代 mkdocs-material，基于 mkdocs-material-9.7.0 衍生，取名为 X，由个人开发者继续维护。 由于 mkdocs-material 已进入维护模式，不再有新功能，而替代品 Zensical 目前还不完善，并且不兼容 MkDocs 原有的插件生态，这将导致原本的繁荣生态被打破而失去活力，用户原本稳定而又完善的站点如果要迁移到 Zensical，则有着较高的迁移成本和不稳定性的风险。 那有没有办法做到，既能拥有 mkdocs-material 的丰富生态和稳定性，又能拥有像 Zensical 一样的新特性呢？ 答案就是 MaterialX，并且 MaterialX 将有着以下全新的定位。 MaterialX 路线图 在我看来，技术的魅力在于让更多的人利用你提供的工具轻而易举就实现了他原来很难做到的事。 一个好的产品，在功能设计上，应该是恰到好处，适可而止，而不是提供更多的功能选择和眼花缭乱的配置项。说实话，无论是 mkdocs-material 还是 Zensical，都有点个性化过度了，配置项太多太复杂了，谁的配置项最后不是动辄几百行？哪个初次用 mkdocs-material 的人没折腾上好几天？ 而我希望把它做成一个傻瓜式的程序，用户只需要简单少量的配置，就能轻松把平时的笔记和文档转成自己的专业站点，方便传播分享与交流。 所以，MaterialX 将遵循以下目标和原则： - 目标：追求人人可用，人人都可拥有自己的网站，包括但不限于开发者、产品经理、运营人员、运维人员等，不再是技术人员的专利
下一代主题插件 MaterialX
开源 MacOS 剪贴板管理工具
点击链接加入群聊OneClip交流群 概览 OneClip 是一款专为 macOS 打造的专业级剪贴板管理工具。采用 100% SwiftUI 原生技术，实现更顺滑的动画、更自然的系统融合与更低的资源占用。 🎯 核心功能 - 📋 智能记录：自动保存剪贴板历史，支持文本、图片、文件等格式 - 🔎 极速搜索：随打随搜，多维筛选快速定位 - 🗂️ 全格式支持：图片/视频/音频/文档等，完整保留元数据 - ⌨️ 全局快捷键：⌘+⇧+V 呼出主界面，支持自定义组合 - 🔄 快捷回复: ⌘+⇧+R 呼出快捷回复界面，支持自定义组合 - 🎨 布局多样：支持列表/卡片双模式切换。支持Paste同款布局。
Markdown 实用技巧
一、什么是 Markdown Markdown 是一种轻量级的纯文本标记语言，用简单少量的符号对文字进行标注，从而实现 以最小的输入代价生成印刷级排版格式的文档。它在 流畅的书写 和 印刷级阅读体验 之间找到了平衡，让人只需专注内容而不是纠结排版。 常用的标记符号 不超过十个，好记好用好效果。(非程序员用户如产品、运营、运维 ... 也可以轻松搞定) 二、Markdown 编辑器 - Typora（Mac、Win、Linux），简约不简单，所见即所得；✓ - MWeb（Mac、iOS），一款专注于 Markdown 的写作、记笔记和发布软件； - Obsidian（Mac、Win、Linux、iOS、Android），一款支持 Zettelkasten 笔记法的笔记管理软件，非专业 Markdown 编辑器，只支持基础的 markdown 语法； - YankNote（Mac、Win、Linux），一款强大可扩展的 Markdown 编辑器，满足了所有幻想，还可以在线体验；✓ - mdx-notes（Mac、Win、Linux、Web），跨平台笔记软件，Web版 在线编辑器可作为网文排版工具； - markdown-online-editor，Arya - 在线 Markdown 编辑器，支持所有基础语法、数学公式、Mermaid 图表、Echarts 图表、五线谱，以及 PPT 模式、视频音频解析等；✓
笔记文档一把梭
在信息化时代，笔记文档的工具平台如雨后春笋般不断浮现，选择颇多，但是，现有的方案总有明显遗憾之处，比如： - Notion、语雀、石墨文档、思源笔记、印象笔记、Obsidian 等这样的第三方云端平台，最大问题是「你的内容不属于你」，数据始终是寄人篱下，不由你做主，不会让你迁移导出或不会轻易让你迁出，然后要注册、登录、收费、广告... 这就好比是租的房，这里的一切都不属于你，甚至你住这生产的商品也不属于你，你也带不走 - 专业的技术博客平台如 CSDN、博客园、知乎、掘金等不仅有上方平台的通病，而且限制更多，门槛更高，不适合普通笔记侠 - WordPress、Jekyll、Hugo、Hexo 等静态网站生成器，可理解成自建房，自由度高且你对其拥有所有权，但是较高的技术门槛和复杂操作容易打消人的创作和分享热情 而我需要的，仅仅是一个能方便我记录和展示笔记文档的简易平台，不追求花里胡哨的功能，而是应该大道至简，追求极简易用，人人可用，追求以下目标： 目标 - 最小的输入代价（我懒，不想输入... 🤐） - 印刷级阅读体验（又想要更好的输出效果） - 随处的排版展示（不同平台均能正常展示） - 丰富的格式输出（能输出常用的办公格式）
友情链接
如何交换友链 步骤： 1. 为自己的站点添加友链功能 2. 添加本站友链 3. 加入友链到本站（在下方留言申请） 期望您的站点： - 独立博客(不要求独立域名)，访问流畅 - 原创内容为主，原创内容5篇以上 - 处于活跃状态，有一定的更新频率 - 建站一个月以上
日期作者头像插件 - 英文
English | 简体中文 A new generation MkDocs plugin for displaying exact creation date, last updated date, authors, email of documents Features - Always displays exact meta information of the document and works in any environment (no-Git, Git environments, Docker, all CI/CD build systems, etc.) - Support list display of recently updated documents (in descending order of update date) - Support for manually specifying date and author in Front Matter - Support for multiple date formats (date, datetime, timeago) - Support for multiple author modes (avatar, text, hidden) - Support for manually configuring author's name, link, avatar, email, etc. - Flexible display position (top or bottom)
克隆此站
本站内容，全部是在本地使用 Markdown 编写，然后一键同步到各平台，你看到的此网站也是使用 MkDocs 一键生成的，非常方便。如果你也想拥有这样一个简约而不简单的站点平台，可直接拷贝和应用我特意给大家提供的 此网站模板，以简化使用门槛。 特色 - 基于 MaterialX for MkDocs 优化和美化，内置 Zensical 一样的现代主题 - 包含主题配色切换功能，支持自适应系统主题配色 - 包含多语言选择功能，支持自适应本地化语言 - 内置新一代日期作者头像插件 mkdocs-document-dates - 内置 GLightbox 插件，支持图像灯箱特效 - 内置 AI i18n 多语言插件，支持 100+ 语言自由切换 - 内置离线插件，可离线访问网站 - 内置搜索插件、博客插件
Markdown 生成静态网站
可将 Markdown 笔记文档一键生成专业的静态网站，你不需要技术开发，也不需要懂开发。 工具对比 - Hugo：由 Go语言实现的静态网站生成器； - Jekyll：由 GitHub 联创创建的基于 Ruby 的静态站点生成器； - Hexo：一个快速、简洁的基于 Node.js 的博客框架； - VuePress：Vue 驱动的静态网站生成器； - VitePress：Vite 和 Vue 驱动的静态站点生成器，比 VuePress 更轻更快； - Docusaurus：基于 React 的静态网站生成器； - GitBook：一个使用 Git 和 Markdown 来构建书籍的工具； - MkDocs：一款流行的、基于 Python 的静态网站生成器；
网站部署至 Netlify
在之前的一篇文档 使用 MkDocs 生成静态网站 中，我用 GitHub Pages 来托管 MkDocs 生成的静态网站，试用一番后发现国内访问不稳定，经常打不开，所以继续优化，只能换服务平台了。 一、可选平台 手工平台收集： Vercel、GitHub Pages、Netlify、Render、Surge。 二、AI 推荐平台 ChatGPT-4o 如果你想在国内部署 mkdocs 生成的静态网站，以下几个平台都不错，配置简单且支持免费使用： 1. GitHub Pages - 优点：免费、简单、支持自定义域名、与 GitHub 集成良好，全球都可以访问。 - 缺点：国内访问速度可能略慢，但你可以使用一些 CDN（比如 jsDelivr）来加速静态资源。 - 部署方式：只需要将生成的 site 文件夹推送到 GitHub 仓库的 gh-pages 分支即可。
网站部署 - SEO 优化
之前把 网站部署到 Netlify（免费、配置简单、支持全球访问），服务器和域名都由 Netlify 提供，但这个结构无法稳定支持国内搜索引擎收录，所以再优化一下 优化目标 内容能被国内外主流搜索引擎抓取并收录 影响因子 收录影响因素（国内引擎）： 收录概率（国内引擎）： 方案设计 1）方案（境外服务器 + 境内CDN + 备案域名） 采用 最具性价比、维护最轻量 的方案（无需购买国内服务器、无需重新部署程序）： - 境外（原有）：源服务器（例如 Netlify） + Netlify 域名

精选推荐

一劳永逸

其实，平时没有写作习惯，只不过有时候工作需要或记忆需要，总是要写点诸如文档笔记、思路灵感、幻灯片、思维导图、汇报总结 ... 啥的，随着文件的积攒，就想，那就系统化的整理和归纳一下吧，也方便形成自己的知识库。常规的办公软件、笔记工具、写作平台用起来很费劲，要么复杂，要么难用，要么限制多 ... 总之，要做一份不难看的文档，需要花费大量时间去调那些无关紧要的格式、样式与限制，使用体验那就是五个字：从入门到放弃。

于是，便有了此念头「Write Once, Show Anywhere」，你没看错，就是「一次编写，随处展示」，在任意地方以任意格式精美的展示。

而实现这样的目标的最佳方式就是：采用「Markdown 格式 + 专业工具本地编写」
( 细节可参考：笔记文档一把梭 )

  • 本地编写：你可以使用任意你喜欢的专业 Markdown 编辑器编写内容，无任何限制且支持全部的 Markdown 语法；
  • 通用格式：支持一键导出 PDF、Word、Image、HTML、ePub，也支持一键生成 PPT 幻灯片、思维导图、静态网站（比如此网站）；
  • 任意发布：支持一键排版到 微信公众号、知乎、掘金、头条、Github、各类知识库 等平台；
  • 安全无患：内容存在本地，不受任何平台限制，使用无门槛，安全无广告，我的内容我做主；

这样，你就只需要专注于自己的内容，无需关心格式、排版，无需担心某些平台有什么限制 ...

( 以上所有技巧见上方精选推荐 )

克隆此站

本站内容，全部是在本地使用 Markdown 编写，然后一键同步到各平台，你看到的此网站也是使用 MkDocs 一键生成的，非常方便。如果你也想拥有这样一个简约而不简单的站点平台，可直接拷贝和应用我特意给大家提供的 此网站模板，以简化使用门槛。