This is a sample text snippet used to demonstrate paragraph formatting effects. The content holds no actual meaning; it serves solely to test the theme’s fonts, line spacing, and overall reading experience. You may replace it with actual document content. The text comprises multiple long paragraphs to simulate the reading scenario of a real article.

In this paragraph, we continue to showcase the effect of long paragraphs. Through a series of consecutive sentences, one can better observe how the theme performs regarding body text layout—including paragraph spacing, line width, alignment, and more.

Sub-section A

This is an example of a sub-section. It serves to demonstrate the hierarchical relationship between level-two and level-three headings. You may place more detailed explanations, steps, or supplementary content here.

This paragraph continues to demonstrate the body text formatting effects, including paragraph length, line spacing, and reading rhythm. You are free to replace the content as needed.

Sub-section B

This section is used to display another snippet of sample text. By utilizing paragraphs of varying lengths, one can observe how the theme performs in a multi-paragraph context.

You may insert explanations, examples, notes, or other content here. The text itself carries no actual meaning; it serves merely as a placeholder for layout demonstration purposes.

Part Two

This chapter is designed to showcase the combined effects of code blocks, images, and other components. You may replace the content with actual document material as required.

var a = 1;
var b = 2;
var c = 3;

Sub-section A

This is an example of a sub-section. It serves to demonstrate the hierarchical relationship between level-two and level-three headings. You may place more detailed explanations, steps, or supplementary content here.

This paragraph continues to demonstrate the body text formatting effects, including paragraph length, line spacing, and reading rhythm. You are free to replace the content as needed.

Sub-section B

This section is used to display another snippet of sample text. By utilizing paragraphs of varying lengths, you can observe how the theme performs within a multi-paragraph context.

You may insert explanations, examples, notes, or other content here. The text itself carries no actual semantic meaning; it serves solely as a placeholder for layout and formatting demonstration purposes.

Part Three

This section is designed to showcase the combined effect of code blocks, images, and other components. You may replace this content with actual documentation material as needed.

Sub-section A

This serves as an example of a sub-section, demonstrating the hierarchical relationship between level-two and level-three headings. You may place more detailed explanations, procedural steps, or supplementary information here.

This paragraph continues to demonstrate the formatting of the main body text—including paragraph length, line spacing, and reading rhythm. Feel free to replace this content as you see fit.

Sub-section B

This section presents another example of text content. By utilizing paragraphs of varying lengths, you can observe how the theme performs within a multi-paragraph context.

You may insert explanations, examples, notes, or other content here. The text itself carries no actual semantic meaning; it serves solely as a placeholder for layout and formatting demonstration purposes.

Welcome to Linen—a minimalist, elegant Hexo theme. This theme draws much of its inspiration from https://medium.com/blog.

Installation

Prerequisites

An existing Hexo project, or create a new one using https://hexo.io/docs/. Hexo version: "^8.1.1".

You can use the Linen theme in one of two ways:

1. Install via NPM

   npm install hexo-theme-linen -S
   

   Then, in your Hexo project’s configuration file (_config.yml), set theme: linen. Restart your Hexo project to enable the Linen theme.

2. Directly clone the theme files into the Hexo themes directory

   git clone https://github.com/LynanBreeze/hexo-theme-linen.git
   

   Then, in your Hexo project’s configuration file (_config.yml), set theme: hexo-theme-linen. Restart your Hexo project to enable the Linen theme.

Customization

Continue reading the Next Article to learn how to configure various customization options.

Edit the _config.linen.yml file located in your site’s root directory (create it if it doesn’t exist), and then add the following content format to the file:

logo:
src: '/img/linen-logo.svg'
width: 225
height: 42

Please replace src, width, and height with the corresponding file path and dimensions of your logo image.

Header Navigation Menu

Add the following content format to _config.linen.yml:

navItems:
- name: Archives
path: /archives/

Site Information

Add the following content format to _config.linen.yml:

info:
site_desc: Live Young n Act Now.
avatar: https://xxx.xxx/xx.jpg
siteCardBg: https://xxx.xxx/xx.jpg

The result looks like this:

Simply add content in the following format to your _config.linen.yml file:

topArticles:
- _posts/quick-start.md
- _posts/lorem.md

Restart Hexo to preview the changes.

It is worth noting that while you can list more than four entries under topArticles, the theme will only render the first four valid posts.

A “valid post” refers to an actual, existing article file; if you configure an entry pointing to a non-existent file, that specific record will be filtered out.

topArticles:
- _posts/fake-1.md
- _posts/fake-2.md
- _posts/quick-start.md
- _posts/lorem.md

In this example, since fake-1.md and fake-2.md do not actually exist, their presence in the list does not prevent quick-start.md from being recognized as the first valid post.

The default configuration is as follows:

feed:
path: /feed.xml
limit: 10
icon: /favicon.svg

You may modify the three RSS configuration options listed above.

If you wish to disable the RSS plugin (or use a different RSS plugin), you can add the following configuration to turn off the built-in RSS plugin:

feed: false

The Linen theme introduces a new “image container” feature, supporting the following image layout styles. Please click the Switch to Raw Markdown Content button on this page and refer to the page’s source code to implement these image layouts.

Landscape Layout

Portrait Layout

Mixed Layouts

Four specific mixed-ratio layouts are supported: r73, r37, r64, and r46.

To enable Gitalk, add the following configuration to _config.linen.yml:

comment:
type: gitalk
client_id: ****
client_secret: ***
repo: ***
owner: ***
admin:
- ***
per_page: 20
distraction_free_mode: false
pager_direction: last
create_issue_manually: false
proxy: https://cors-anywhere.lynanbreeze.workers.dev/?url=https://github.com/login/oauth/access_token
flip_move_options: null
enable_hotkey: true
language: zh-CN

Configuration Guide

The following content is adapted from the Icarus User Guide - Comment Plugins

1. Log in to GitHub and click here to register a new OAuth application. Fill in the “Application name,” “Homepage URL,” and “Application description” fields.
   Next, enter your blog’s root URL in the “Authorization callback URL” field.
   Click the “Register application” button to proceed to the application details page.

2. Copy the values ​​for “Client ID” and “Client Secret,” and paste them into the corresponding configuration fields within your theme settings.

For example, given the “Client ID” and “Client Secret” shown below:

Client ID
xxxxxxxxxxxxxxxxxxxx
Client Secret
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

The corresponding Gitalk configuration would be as follows:

comment:
type: gitalk
client_id: xxxxxxxxxxxxxxxxxxxx
client_secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
repo: Some-of-Your-GitHub-Repo
owner: you_github_name
admin:
- you_github_name
per_page: 20                    # Optional
distraction_free_mode: false    # Optional
pager_direction: last           # Optional
create_issue_manually: false    # Optional
proxy:                          # Optional
flip_move_options:              # Optional
enable_hotkey: true             # Optional
language: zh-CN                 # Optional

3. For details regarding the meaning and possible values ​​of the above configuration options, please refer to the Gitalk documentation or hexo-component-inferno.

In the bottom-right corner of the cover image, you can add either author credits or location information (choose one).

The format is as follows:

• Author Information

coverInfo:
author: freestocks
url: https://unsplash.com/photos/top-view-of-opened-magazine-near-up-of-coffee-VFs2fZEVkXo

• Location Information

coverInfo:
location: Macau · Municipal Affairs Bureau Building
url: https://maps.apple.com/place?address=Avenida%20de%20Almeida%20Ribeiro%20No.%20163,%20Macao%20SAR,%20China&coordinate=22.193346,113.539592&name=%E5%B8%82%E6%94%BF%E7%BD%B2&place-id=IC211FBD448B1E6C&map=explore

Hover Text

Sometimes you may wish to include explanatory notes, but you don’t want to constantly append parenthetical text (like this) after your content. By adding the configuration shown below, you can attach hoverable explanatory text to specific parts of your writing.

For example, right here:

customComments:
  - text: For example, right here
    index: 0
    comment: Do you see the hover text?

Hiding Posts

Adding the configuration below allows you to remove a post from the homepage or archive page (this does not prevent the post from being generated; the post page can still be accessed directly via its URL).

hide:
recent: true
archive: true

Setting recent: true ensures the post does not appear on the homepage.
Setting archive: true ensures the post does not appear in the archives.

PhotoSwipe Plugin

This plugin is sourced from https://photoswipe.com/. If you do not need it, you can disable it in the following ways:

Global Disable: Add photoswipe: false to _config.linen.yml.
Page-level Disable: Add photoswipe: false to the Front Matter of the specific post.

Note that if a post contains no images, the PhotoSwipe plugin will not be loaded—even if photoswipe: false has not been explicitly specified.

Table of Contents (TOC)

There are three configuration options for the Table of Contents within the Front Matter:

• Hidden: toc: false
• Expanded: toc: flat
• Automatic: (Leave blank/Add nothing)

Image Lazy Loading

This feature is enabled by default. If you do not need it, you can disable it in the following way:

Global Disable: Add the following to _config.linen.yml:

lazyload:
enable: false

After doing so, you must run npm run clean to clear the previously built posts; otherwise, the change will not take effect on posts that have already been generated.

If you wish to disable lazy loading for specific images only, you can reference those images using one of the following formats:

• ![no-lazy](https://abc.com/def.jpg)

• ![This is a image $no-lazy](https://abc.com/def.jpg)

• <img no-lazy src="https://abc.com/def.jpg" alt="def">

This Markdown cheat sheet provides a quick overview of all Markdown syntax elements. Since it is impossible to cover every edge case, if you need more information about any of these elements, please consult the reference guides for Basic Syntax and Extended Syntax.

Basic Syntax

The following are the elements outlined by John Gruber in his original design document. All Markdown applications support these elements.

Headings

H1

H2

H3

Bold

Bold text

Italic

Italic text

Blockquotes

Blockquote

Ordered Lists

1. First item
2. Second item
3. Third item

Unordered Lists

• First item
• Second item
• Third item

Horizontal Rules

Strikethrough

The world is flat. ~~

Links

Markdown Guide

Images

Tables

Code

const a = 1;

Code Blocks

{
"firstName": "John",
"lastName": "Smith",
"age": 25
}

Task Lists

• Write press release

• Update website

• Contact media