This is a markdown tool to transform markdown codes to gist links, it will create gists from the embeded code blocks in your markdown blog posts. It saves embeded gist block in formats of dev.to, medium and hugo blogs. You can also publish your markdown post to dev.to and medium as well.
Pre-request
- .Net Core 3.1
- Github auth token
- Medium auth token (Optional, for publishing)
- Dev.to apikey (Optional, for publishing)
You can manage your blog posts in a github repository with markdown formats. And use these blogs to transform it with gist for better publishing.
-
parse command Discover mardown files for specified folder and transform all code blocks into gist link. It requires you to specify github auth token to create cosresponding gist files.
First you need to create a github access token.
To create the token, go to Github Create Access Token
And make sure you select the Gist scope.
$ md-gist parse -f=<Path> -t=<Github_Auth_Token>If the command successfully run, you would see a number of generated `.md` files. e.g.
create-dotnet-core-console-app-with-autofac-dependency-injection-[Dev.to].md
create-dotnet-core-console-app-with-autofac-dependency-injection-[Hugo].md
create-dotnet-core-console-app-with-autofac-dependency-injection-[Medium].md
create-dotnet-core-console-app-with-autofac-dependency-injection-[Jekyll].md
create-dotnet-core-console-app-with-autofac-dependency-injection.md
If you open any of them, you should see all the code blocks are replaced with a gist link (or embeded code).
e.g.
for Hugo blog, it replaces the code blocks as
{{< gist superwalnut b92assadasdb5e58301cab0c28d3cf34d08 >}}
for Dev.to, it replaces as,
{% gist https://gist.github.com/superwalnut/b92434ccbxxx01cab0c28d3cf34d08 %}
for Medium, it simply replaces as a gist link (when publishing to medium as markdown format, it will convert to proper embeded block)
https://gist.github.com/superwalnut/b92434xxx8301cab0c28d3cf34d08
for jekyll, it replaces as,
{% gist c08ee0f272xxxx09d %}
-
devto command Use this to publish your post to Dev.to blog
First you need to create dev.to api keys in your account settings
$ md-gist devto -f=<Files Path> -k=<Dev.to API key> -s=<Status draft/publish>
-
medium command Use this to publish your post to Medium
First you need to create medium integration token in account settings
$ md-gist medium -f=<Files Path> -t=<Medium Access Token> -s=<Status draft/publish>
- Using
dotnet tool install --global MD-Gistto install the console tool from nuget
$ dotnet tool install --global MD-GistI am using github as my blog source and save my posts in markdown format. Here is an example, tech blog
I created a sample post called "markdown.md".
Then I created github action that will automatically detect any .md files and convert the code blocks to gist embeded code and pushed these new files to the repository as well.
- name: Parse markdown
working-directory: ./Blogs
run: |
dotnet tool install --global MD-Gist
md-gist parse -t=${{secrets.GIST_TOKEN}}
git config --local user.email "action@github.com"
git config --local user.name "GitHub Action"
git add .
git commit -m "Add changes" -a
- name: Push changes
uses: ad-m/github-push-action@master
with:
github_token: ${{ secrets.GIST_TOKEN }}
It will create these files that you can publish directly in these blogging platforms
markdown-[Dev.to].md
markdown-[Hugo].md
markdown-[Jekyll].md
markdown-[Medium].md
Reach out to me at one of the following places!
