如果你的博客是用markdown编辑的, 例如使用jekyll 或 gihtub page托管, 本文介绍的 md2zhihu 小工具可以帮你实现自动的markdown转换, 将jekyll的markdown转换成知乎兼容的markdown格式.
md | imported | |
---|---|---|
original | ||
converted |
md2zhihu 通过 github action来自动完成,
只需要在保存博客文章的git repo中添加一个action定义:
创建action配置文件
.github/workflows/md2zhihu.yml
:
name: md2zhihu
on: [push]
jobs:
md2zhihu:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- uses: drmingdrmer/md2zhihu@v0.4
env:
GITHUB_USERNAME: ${{ github.repository_owner }}
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
pattern: >
_posts/*.md
_posts/*.markdown
下次提交时, github action将自动把
_posts/
目录下的markdown 转换成可以在知乎一键导入的格式,
转换后的文件存储在另一个分支中:
_md2zhihu/md
.
例如我自己的blog drmingdrmer.github.io 就是用github page托管, 已经配置好了自动转换脚本: https://github.com/drmingdrmer/drmingdrmer.github.io/blob/master/.github/workflows/md2zhihu.yml
最新push后自动转换的文章可以直接在线上看到: https://github.com/drmingdrmer/drmingdrmer.github.io/tree/_md2zhihu/md/_md2zhihu
因为自动转换在github服务器上运行, 要使用转换后的文件,
可以直接 fetch then merge 分支
_md2zhihu/md
.
或直接在github上打开这个分支看到内容, 例如可以看到我blog中的一篇文章转换后的效果:
https://github.com/drmingdrmer/drmingdrmer.github.io/blob/_md2zhihu/md/_md2zhihu/dict-cmp.md
下面这些选项也可以使用with
来传入, 控制转换的行为:
-
pattern
:file pattern to convert
required: True default:
**/*.md
-
output_dir
:dir to store converted markdown
required: True default:
_md2zhihu
-
md_branch
:The branch name to push converted markdown to. A build overrides previous built branch. If you want to persist the built markdowns, merge this branch.
required: True default:
_md2zhihu/md
-
asset_branch
:The branch name in which assets are stored.
required: True default:
_md2zhihu/asset
-
target_platform
:The platform that the converted markdown should be compatible toṫCurrently supported platforms are zhihu, wechat, weibo, simple.
simple
converts almost everything to images and removes most text styles. E.g. inline code block is converted to normal text.required: True default:
zhihu