Migration from Other

AI Migration Assistant ​

Select your source framework, copy the prompt to your AI assistant, and migrate quickly.

I'm migrating my blog from Hexo to Valaxy. Please help me with:

1. Migrate Markdown files from Hexo source/_posts to Valaxy pages/posts directory
2. Convert Hexo frontmatter format to Valaxy-supported format (date, tags, categories)
3. Convert Hexo _config.yml site configuration to Valaxy's site.config.ts and valaxy.config.ts
4. Migrate static assets (images, etc.) from source to public directory
5. Convert any Hexo tag plugins to Valaxy/Markdown equivalents

Migrate from Hexo to Valaxy ​

Migrate Contents ​

The relationship between Hexo blog directory and Valaxy blog directory is shown in the table below. Just copy the relevant contents to the corresponding folder.

For example: To migrate articles, just copy files from Hexo’s source/_posts to Valaxy’s pages/posts directory.

ContentsHexoValaxy
Posts (Markdown files)source/_postspages/posts
Pages (Markdown / Html files)sourcepages
Static assets (*.js / *.css / CNAME etc.)sourcepublic

Migrate Configurations ​

Refer to Valaxy Config to migrate configurations from Hexo’s _config.yml to Valaxy’s valaxy.config.ts.

Examples of configuration: demo/yun/valaxy.config.ts, yunyoujun.github.io/valaxy.config.ts. valaxy.config.ts provides a complete type prompt, which means that you can hover on configuration fields directly to view the comments in VSCode.

Example ​

For more complex migration examples, you can also compare hexo branch and valaxy branch in yunyoujun.github.io | GitHub to see the similarities and differences.

Migrate from any other blog framework ​

  • Copy your posts (Markdown files) to the Valaxy pages/posts directory.
  • Copy your custom pages (non-article Markdown/HTML files) to the Valaxy pages directory.
  • Copy your static resources (images, etc.) to the Valaxy public directory.
  • Configure your configuration file valaxy.config.ts/site.config.ts by referring to configuration.

Common Problems ​

Read More Separator ​

Default to <!-- more -->, there are spaces before and after more.

Newline in Markdown ​

Markdown rendering in Valaxy is based on markdown-it.

The default strategy of markdown-it does not wrap the rendered content when wrapping in Markdown:

md
first line
second line but not wrapped

first line second line but not wrapped

If you want to move the second line to a new line, add two spaces at the end of the first line:

md
first line (with two spaces at the end)  
second line got wrapped correctly

first line (with two spaces at the end)
second line got wrapped correctly

Contributors