Markdown-Blog 是一款小而美的Markdown静态博客程序
2.0K
Markdown-Blog 是一款小而美的Markdown静态博客程序
如果你和我一样,平时喜欢使用markdown文件来记录自己的工作与生活中的点滴,又希望把这些记录生成个人博客,那Markdown-Blog再适合不过了。它简洁、轻快,部署简单,可以把markdown文件快速变为个人博客,它不需要管理后台,无需进行文章的二次发布。
| Style | Preveiw |
|---|---|
| Dark | ![]() |
| Light | ![]() |
| Dark | Light |
|---|---|
![]() | ![]() |
Windows、Linux、Mac OS
[v1.1.0] 2022-11-26
[v1.0.0] 2022-11-20
[v0.1.1] 2022-11-12
[v0.0.5] 2022-11-06
[toc] 会自动解析下载 release
解压
tar zxf markdown-blog-v0.0.5-linux-amd64.tar.gz
cd markdown-blog-linux-amd64
mkdir md
echo "### Hello World" > ./md/主页.md
./markdown-blog web
docker pull willgao/markdown-blog:latest
启动
docker run -dit --rm --name=markdown-blog \
-p 5006:5006 \
-v $(pwd)/md:/md -v $(pwd)/cache:/cache \
willgao/markdown-blog:latest
docker run -dit --rm --name=markdown-blog \
-p 5006:5006 \
-v $(pwd)/md:/md -v $(pwd)/cache:/cache \
willgao/markdown-blog:latest \
-e dev
其他用法
# 查看帮助
docker run -dit --rm --name=markdown-blog \
-p 5006:5006 \
-v $(pwd)/md:/md -v $(pwd)/cache:/cache \
willgao/markdown-blog:latest -h
# 设置 title
docker run -dit --rm --name=markdown-blog \
-p 5006:5006 \
-v $(pwd)/md:/md -v $(pwd)/cache:/cache \
willgao/markdown-blog:latest \
-t "TechMan'Blog"
# 设置 谷歌统计
docker run -dit --rm --name=markdown-blog \
-p 5006:5006 \
-v $(pwd)/md:/md -v $(pwd)/cache:/cache \
willgao/markdown-blog:latest \
-t "TechMan'Blog" \
--analyzer-google "De44AJSLDdda"
支持从配置文件读取配置项,不过运行时指定参数优先于配置文件,配置内容参考
config/config.yml.tmp
新建配置文件 config/config.yml
启动时加载配置文件
./markdown-blog web --config ./config/config.yml
docker run -dit --rm --name=markdown-blog \
-p 5006:5006 \
-v $(pwd)/md:/md -v $(pwd)/cache:/cache -v $(pwd)/config:/config \
willgao/markdown-blog:latest --config ./config/config.yml
如果启动时未指定
index,程序默认以导航中的第一个文件作为首页
gitalk 配置项,启动时加载配置文件即可gitalk:
client-id: "你的 github oauth app client-id,必填。 如: ad549a9d085d7f5736d3"
client-secret: "你的 github oauth app client-secret,必填。 如: 510d1a6bb875fd5031f0d613cd606b1d"
repo: "你准备用于评论的项目名称,必填。 如: blog-issue"
owner: "你的Github账号,必填。"
admin:
- "你的Github账号"
labels:
- "自定义issue标签,如: gitalk"
0952befd5b7da358ad12fae3437515b1<script>
var _hmt = _hmt || [];
(function() {
var hm = document.createElement("script");
hm.src = "https://hm.baidu.com/hm.js?0952befd5b7da358ad12fae3437515b1";
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(hm, s);
})();
</script>
./markdown-blog web --analyzer-baidu 0952befd5b7da358ad12fae3437515b1
G-MYSMYSMYS<script async="" src="https://www.googletagmanager.com/gtag/js?id=G-MYSMYSMYS"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-MYSMYSMYS');
</script>
./markdown-blog web --analyzer-google G-MYSMYSMYS
默认读取与程序运行同一级目录的 favicon.ico 文件
博客导航默认按照
字典排序,可以通过@前面的数字来自定义顺序
Nginx 反向代理配置文件参考
server {
listen 80;
listen [::]:80;
server_name yourhost.com;
location / {
proxy_pass http://127.0.0.1:5006;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
server {
listen 80;
listen [::]:80;
server_name yourhost.com;
location / {
rewrite ^ https://$host$request_uri? permanent;
}
}
server {
listen 443 ssl;
server_name yourhost.com;
access_log /var/log/nginx/markdown-blog.access.log main;
#证书文件名称
ssl_certificate /etc/nginx/certs/yourhost.com_bundle.crt;
#私钥文件名称
ssl_certificate_key /etc/nginx/certs/yourhost.com.key;
ssl_session_timeout 5m;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
ssl_prefer_server_ciphers on;
location / {
proxy_pass http://127.0.0.1:5006;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
下载最新版 release
停止程序,解压替换 markdown-blog
重新启动程序
安装 Golang 开发环境
Fork 源码
启动 web服务
运行之后访问地址 http://localhost:5006,API请求会转发给 markdown-blog 程序
make run
编译
在 bin 目录生成当前系统的压缩包,如:markdown-blog-v1.1.0-darwin-amd64.tar
make
打包
在 package 目录生成当前系统的压缩包,如:markdown-blog-v1.1.0-darwin-amd64.tar
make package
生成 Windows、Linux、Mac 的压缩包
在 package 生成压缩包,如:markdown-blog-v1.1.0-darwin-amd64.tar markdown-blog-v1.1.0-linux-amd64.tar.gz markdown-blog-v1.1.0-windows-amd64.zip
make package-all
本项目采用 MIT 开源授权许可证,完整的授权说明已放置在 LICENSE 文件中。
Content type
Image
Digest
sha256:ae71d0fff…
Size
7.1 MB
Last updated
over 3 years ago
docker pull willgao/markdown-blog