前言
以前记录资料，用过各种博客、印象笔记、OneNote、苹果的备忘录，甚至包括QQ邮箱的记事本。
不同的平台，编辑文档内容，格式上需要做一些调整，如果能把本地Markdown等形式的文档直接转换成网页就好了。
图文页面需要购买图床服务、购买空间等等。
如果服务下架则需要搬迁历史文档或者修改文档中的网络图片地址。
这些因素，再加上懒，做原创文档的欲望就小了。
用Jekyll搭建个人网站
遇到Jekyll后，发现以前的烦恼都消失了。
Jekyll简介
Jekyll是一个简单的博客形态的静态站点生产工具。
它有一个固定的模板目录，在里面放入常规Markdown文档，Jekyll服务检测到文件变化便会解析生成相应的html静态网页。
Jekyll 也可以运行在 GitHub Page 上，可以用GitHub 的服务来搭建个人网站，而且是完全免费的、可以在一个平台内完成全部资源的托管。
快速搭建Jekyll环境
macOS 13及以后，官网默认步骤可能涉及ruby、gem等版本、路径问题，导致无法正常配置Jekyll。
重要： 先参考 jekyll DOCS完成环境配置。
以下是jekyll 官网步骤
gem install jekyll bundler
jekyll new my-awesome-site
cd my-awesome-site
bundle install
bundle exec jekyll serve
# => 打开浏览器 http://localhost:4000
发布到GitHub Pages
GitHub Pages 是由 GitHub 官方托管和发布的。 可以做个人博客，没有麻烦的配置。 使用标记语言如Markdown，不需自己搭建服务器，还可以绑定自己的域名。
配置个性化域名
GitHub Pages支持二级域名创建。
这个步骤比较简单，Github Pages官网首页就有图文说明。
Markdown工具
推荐使用 MWeb。
MWeb 是专业的 Markdown 写作、记笔记、静态博客生成软件，目前已支持 Mac，iPad 和 iPhone。MWeb 有以下特色：
软件本身
- 使用原生的 macOS 技术打造，追求与系统的完美结合。
- 原则上，首先是追求界面简洁和高性能，然后才是强大易用，功能全面。
Markdown 语法
- 使用 Github Flavored Markdown 语法，简称 GFM 语法。
- 支持表格、TOC、LaTeX、代码块、任务列表、脚注等。
- 画图库支持 mermaid, viz, echarts, plantuml, sequence, flow。
Markdown 辅助
- 支持截图并粘贴、复制并粘贴、拖拽等方式插入图片并直接显示在编辑器内。
- 在兼容 Markdown 语法的情况下支持设置图片宽度。
- 好用的表格插入和 LaTeX 书写辅助。
Markdown 输出
- 支持导出为图片、HTML、Epub、PDF、RTF、Docx。
- 支持发布到 Wordrpess、支持 Metaweblog API 协议的服务、Wordpress.com、印象笔记（Evernote）、Blogger、Medium、Tumblr。
- 图片上传服务（图床）支持 Google Photos、Imgur、七牛云、又拍云和自定义的图床服务。
Markdown 笔记
- 强大的文档库支持分类树和标签管理文档，文档可归类于多个分类，可以把分类整个导出为 Epub、PDF 和生成静态网站。非常合适用于笔记、个人知识收集、管理和输出。
- 快速笔记：随意增加笔记及图片等素材，支持以天为单位把增加的素材组合在一个文档内，方便整理及记录历史收集情况。
- 快速搜索：目前已支持全局快捷键调出搜索。
外部 Markdown 文档
- 外部 Markdown 文档使用外部模式管理。外部模式使用目录树的方式编辑和管理你的 markdown 文档，还能很好的支持 gitbook、JekyII、hexo 等等编辑和图片插入。
