Introduce Miyano

Miyano 0.3


    1. macOS
    1. Bear
    1. Ruby >= 2.5.0

Quick Try

  1. $ gem install miyano

  1. $ cd ~/Document ( any place you prefer )

  1. Create a new blog depends on your markup language

For Default Polar Bear Markup Language

$ miyano new myblog

For Markdown Compatibility Mode

$ miyano new myblog -m

( myblog is a directory you want to create )

  1. $ cd myblog

  1. [myblog]$ miyano build

  1. [myblog]$ miyano try

  1. open Browser and go to localhost:8000, Ctrl + C to quit


├── layout
│── ├── default.scss
│── ├── index.html.erb
│── └── post.html.erb
└── post
    ├── *.bearnote

the post/ directory is the place where you export you bearnote

the layout/ directory contains the template files that control the way your blog looks.

read more about template on wiki page

Export Your Bear Notes

how to export

Export your notes - Bear - Faq and support

  1. In Bear App => File => Export Notes
  1. Export as Bear Note

What is the Export attachments option ?

>This option uses for other filetypes which cannot pack pictures or files. The Bear Note will take good care of all your files and pictures, so you don't need to worry about this option.


You can keep the default name of your bear note, and also can change whatever name you prefer.

The name of the bear note will be the part of the URL of your blog.

For example

foo bar.bearnote	-&gt

foo_bar.bearnote	-&gt

The Space in the filename will be translated to %20 in the URL.

If you don't like the %20 in the URL, change the space to _

If there's a page you want to share with others, then keeping the URL clear and meaningful is important.

By the way, you don't need to change the name every time you export the notes which will make you complex and trouble.


When you create a note in Bear App, it has a create_date. Every time you edit it, the modify_date changes.

The date information keeps after you export them.

So you don't worry about the date.

copying bearnotes in terminal

Use cp -p , the -p option will keep the date information, or you will lose all your date information.


The Bear Note will pack all of your attachments ( pictures, files, sketches) , and Miyano will unpack and put them in the right place.

Never worry about the files!

Github Pages

Deploy your blog on the Internet for free and stable.


    1. A Github Account
    1. Create a User Pages site, name the repository using the naming scheme:

 Just for your information:

Github Pages

User, Organization, and Project Pages

Not Support Project Pages


$ cd path/to/myblog

[myblog]$ miyano push

( the push cmd contains the build cmd )

If you are at the first time, the cmd will ask you for the Github Page's repo URL.

If you do not use git before, the username and password will be asked by git (not miyano).

CNAME - Use your own domain

cd path/to/myblog

[myblog]$ echo "" > _site/CNAME

Create CNAME at local to avoid git conflict

Read More

Using a custom domain with GitHub Pages

Recommend Free CDN Service


Just Miyano Tip

Specify your blog's root address and Save your time.

If you like miyano, and decide to use it for a long time.

This little trick will save you much time.

And the update action will not be so annoying.

$ cd path/to/myblog

[myblog]$ pwd > ~/.miyano

After that, whenever you want to do a update, open the terminal and type miyano, press Enter, done.

Because your root of your blog already had be specified, you don't need to care about the current directory of the terminal any more.

Just miyano.


Bugs & Need Help?

About Bear

Bear - Faq and support - Recommend

Bear - Twitter

Bear - Reddit

Bear - Contact by email

About Miyano

FAQ · wuusn/miyano Wiki · GitHub

You are my special,

Just contact me.

Join Telegram Group @M1yano

PM to me @o1chi

mail me: [email protected]

Source Code on Github

Give a Star ★ to support me!

Who is Miyano? ⬇️

“TRY~ ME~” she says.

#github #tips #blog #tech #ruby