-ClickShowText: +clickShowText: enable: false text: - I - LOVEeeeeeeeeeeeee - YOU fontSize: 15px random: true mobile: false
CDN: option: - ClickShowText: + clickShowText:
內容
置頂圖標改為在標題左側
可配置打賞按鈕的文字
1 2 3 4
reward: enable: false + text: QR_code:
側邊欄增加系列文章顯示
1 2 3 4 5
aside: + card_post_series: + enable: true + orderBy: 'date' # Order by title or date + order: -1 # Sort of order. 1, asc for ascending; -1, desc for descending
增加 series 系列文章標籤外掛
1 2 3 4 5
+series: + enable: true + orderBy: 'title' # Order by title or date + order: 1 # Sort of order. 1, asc for ascending; -1, desc for descending + number: true
移除 addthis 分享
1 2 3
-addThis: - enable: false - pubid:
文章版權增加圖標顯示
getScript 增加 attribute 配置
文章文字左右對齊
1 2
+# Stretches the lines so that each line has equal width（文字向兩側對齊，對最後一行無效） +text_align_justify: true
preconnect 根據 CDN 配置引入
移除 anchor 的 button, 直接點擊標題跳轉
1 2 3 4 5 6 7 8
anchor: - button: - enable: false - always_show: false - icon: # the unicode value of Font Awesome icon, such as '\3423' auto_update: false # when you scroll in post, the URL will update according to header id. + # Click the headline to scroll and update the anchor + click_to_scroll: false
只需要配置 sort_order就行。（使用了 Flex 佈局的 order 屬性，具體可查看 mozilla 文檔。簡單來講，就是配置數字來實現排序，如果不配置，則默認為 0。數字越小，排序越靠前。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
aside: ... card_recent_post: sort_order:# Don't modify the setting unless you know how it works card_categories: sort_order:# Don't modify the setting unless you know how it works card_tags: sort_order:# Don't modify the setting unless you know how it works card_archives: sort_order:# Don't modify the setting unless you know how it works card_webinfo: sort_order:# Don't modify the setting unless you know how it works
newest_comments: enable:true sort_order:# Don't modify the setting unless you know how it works
/* Name: Duotone Light Author: Simurai, adapted from DuoTone themes for Atom (http://simurai.com/projects/2016/01/01/duotone-themes) Conversion: Bram de Haan (http://atelierbram.github.io/Base2Tone-prism/output/prism/prism-base2tone-morning-light.css) Generated with Base16 Builder (https://github.com/base16-builder/base16-builder) */
# Local search local_search: enable: false # Preload the search data when the page loads. preload: false + # Show top n results per article, show all results by setting to -1 + top_n_per_article: 1 + # Unescape html strings to the readable one. + unescape: false CDN:
升級 fancybox 到 v5
更新 facebook js 版本
CDN 配置了 version 為 true, 本地鏈接也會加上版本號
支持自定義 giscus 評論系統的 JS 地址
1 2 3
CDN: option: + giscus: xxxxx
新增自定義深淺模式切換時間
1 2 3 4 5
# dark mode darkmode: + # Set the light mode time. The value is between 0 and 24. If not set, the default value is 6 and 18 + start: # 8 + end: # 22
Fix
修復 safari 下，搜索內容被系統搜索框遮擋的 bug
修復 fullpage loading 顯示滾動條的 bug
修復 card_tags.color: true 時遇到 limit 失效問題
修復設置圖片時，圖片後綴大寫而導致識別錯誤的 bug
修復開啟 archor 後， pace.js 會隨着 archor 添加而觸發的問題
Improvement
當瀏覽器寬度大於2000px時，卡片寬度由 1500px 改為 1700px
當沒有開啟 beautify 時， hr 顯示默認的樣式
手機 safari 橫屏時，網頁全屏幕顯示
社交圖標的 hover 旋轉180度
優化 viewport seo
代碼優化
4.7.0 (2023/02/20)
4.7.0 (2023/02/20)
Feature
card_tags 可配置 orderby 和 order
1 2 3 4 5 6 7 8
aside: card_tags: enable: true limit: 40 # if set 0 will show all color: false + orderby: random # Order of tags, random/name/length + order: 1 # Sort of order. 1, asc for ascending; -1, desc for descending sort_order: # Don't modify the setting unless you know how it works
-anchor: false +anchor: + button: + enable: false + always_show: false + icon: # the unicode value of Font Awesome icon, such as '\3423' + auto_update: false # when you scroll in post, the URL will update according to header id.
Feature
更新 Facebook sdk 到 v15
Fix
修正 throttle 函數調用方式 #1075
修復控制枱報 loadFBComment error 的 bug #1066
修復屏幕寬度為 768px 時的佈局混用問題 #1032
Improvement
簡繁轉換增加部分字 #1076
本地預覽，友情鏈接頁面刷新，內容不會重複顯示
更新 plugins.yml
Remove
移除 meta keywords
4.4.0 (2022/08/18)
4.4.0 (2022/08/18)
Feature
在綫聊天新增 facebook 洽談外掛程式 messenger
1 2 3 4
+messenger: + enable: false + pageID: + lang: zh_TW # Language en_US/zh_CN/zh_TW and so on
CDN: + # The CDN provider of internal scripts (主題內部 js 的 cdn 配置) + # option: local/jsdelivr + # Dev version cannot choose jsdelivr (dev版的主題不能設置為 jsdelivr) + internal_provider: local + # The CDN provider of third party scripts (第三方 js 的 cdn 配置) + # option: local/jsdelivr + # when set it to local, you need to install hexo-butterfly-extjs + third_party_provider: jsdelivr + option:
disqusjs: - apikey: - api: - nocomment: # display when a blog post or an article has no comment attached - admin: - adminLabel: + option:
gitalk: - language: en # en, zh-CN, zh-TW, es-ES, fr, ru - perPage: 10 # Pagination size, with maximum 100. - distractionFreeMode: false # Facebook-like distraction free mode. - pagerDirection: last # Comment sorting direction, available values are last and first. - createIssueManually: false # Gitalk will create a corresponding github issue for your every single page automatically
valine: - pageSize: 10 # comment list page size - lang: en # i18n: zh-CN/zh-TW/en/ja - placeholder: Please leave your footprints # valine comment input placeholder (like: Please leave your footprints) - guest_info: nick,mail,link # valine comment header info (nick/mail/link) - recordIP: false # Record reviewer IP - bg: # valine background - emojiCDN: # emoji CDN - enableQQ: false # enable the Nickname box to automatically get QQ Nickname and QQ Avatar - requiredFields: nick,mail # required fields (nick/mail)
comments: ... count: false # Display comment count in post's top_img + card_post_count: false # Display comment count in Home Page
最新評論更新
<a> 標簽將會顯示 [鏈接]
<img>標簽將會顯示 [圖片]
<pre><code> 標簽將顯示 [代碼]
github-issues 獲取到的 url 改為對應文章地址，而不是issues地址
時間 time 增加 datetime屬性
waline 獲取到頭像會先匹配 waline數據庫是否有qq頭像屬性
部分評論顯示的時間改為更新時間
aside ‘查看更多’按鈕 改為 圖標顯示在右上角
可配置最新評論的緩存時間
1 2 3 4 5
newest_comments: enable: false sort_order: # Don't modify the setting unless you know how it works limit: 6 + storage: 10 # unit: mins, save data to localStorage
增加 post_pagination 配置(可關閉/配置分頁展示邏輯)
1 2 3 4 5 6
+# post_pagination (分頁) +# value: 1 || 2 || false +# 1: The 'next post' will link to old post +# 2: The 'next post' will link to new post +# false: disable pagination +post_pagination: 1
文章版權右上角改為 版權icon
增加配置 disable_top_img，禁用所有的top_img
1 2
+# Disable all banner image +disable_top_img: false
增加 文章編輯
1 2 3 4 5 6 7
+# Post edit +# Easily browse and edit blog source code online. +post_edit: + enable: false + # url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name/ + # For example: https://github.com/jerryc127/butterfly.js.org/edit/main/source/ + url:
Fix
修復 文章頁面上滑子菜單圖標文字無法顯示的 bug #481
修復在 chrome上，進入頁面時，頁面元素會出現模糊到清晰 的 bug #479
修復夜間模式下，閲讀模式代碼塊背景顔色的顯示bug
修復打賞按鈕字數過多導致Hover異常的bug #473
修復評論裏 行內元素（表情/圖片）變成塊級元素（換行）的bug
修復點擊toc後，滾動完toc的highlight在點擊的上一個元素
修復子目錄下，打賞圖片跳轉鏈接會錯誤的bug
修復文字點擊關閉random無效的bug
修復手持設備橫向翻轉時，menu 沒有進行判斷,而導致樣式錯亂的bug
修復pjax下不會跳轉404頁面的bug
修復twikoo 評論數獲取會因為地域問題報錯的bug
修復 background-image 遇到鏈接有括號時會無法顯示的bug
Improvement
meta description 限制在150字以內 #480
pug優化和結構調整
pug 判斷優化
友情鏈接界面增加title顯示（top_img設為false時）
升級facebook comment sdk版本
優化toc顯示，當向上滾動時，導航欄不會遮擋 toc #472
pangu 改為全站渲染
最新評論js優化
調整 Readmode 標題邊距
卡片 hover box-shadow 微調
404頁面卡片增加hover
刪除部分多餘的代碼
Remove
移除百度推送（百度已棄用）和百度轉碼
1 2 3 4 5
-# Disable Baidu transformation on mobile devices (禁止百度轉碼) -disable_baidu_transformation: true
-# Baidu Push (百度推送) -baidu_push: false
移除 fragment_cache 配置（默認開啟）
1 2
-# Caches the contents in a fragment, speed up the generation (開啟hexo自帶的緩存,加快生成速度) -fragment_cache: true
+# Microsoft Clarity +# https://clarity.microsoft.com/ +microsoft_clarity:
readmode 優化
aside 增加自定義 widget
aside widget 增加排序（只對page頁和sticky內的有效）
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
aside: ... card_recent_post: + sort_order: # Don't modify the setting unless you know how it works card_categories: + sort_order: # Don't modify the setting unless you know how it works card_tags: + sort_order: # Don't modify the setting unless you know how it works card_archives: + sort_order: # Don't modify the setting unless you know how it works card_webinfo: + sort_order: # Don't modify the setting unless you know how it works
newest_comments: enable: true + sort_order: # Don't modify the setting unless you know how it works
# Aside widget - Newest Comments newest_comments: ... - leancloud: - enable: false - appId: # leancloud application app id - appKey: # leancloud application app key - serverURL: # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in) - default_avatar: # mp/identicon/monsterid/wavatar/retro/robohash/blank + valine: false
3.4.2 (2020/12/27)
3.4.2 (2020/12/27)
Fix
修復開啟 gitalk 評論數後與 toc 衝突的 bug #462
修復 jquery 在一些介面仍然載入問題
修復 medium zoom 報錯的 bug
3.4.1 (2020/12/15)
3.4.1 (2020/12/15)
Fix
修復tabs 標簽外掛設為-1時，按鈕點擊沒反應的bugs
3.4.0 (2020/12/13)
3.4.0 (2020/12/13)
Breaking Change
去除 jQuery
Feature
可配置是否添加css前綴
1 2
+# Add the vendor prefixes to ensure compatibility +css_prefix: true
點擊文字特效增加隨機配置
1 2 3 4 5 6 7 8 9
ClickShowText: enable: false text: - I - LOVEeeeeeeeeeeeee - YOU fontSize: 15px + random: true mobile: false
# Display the article introduction on homepage # 1: description # 2: both (if the description exists, it will show description, or show the auto_excerpt) # 3: auto_excerpt (default) +# false: do not show the article introduction index_post_content: method: 3 length: 500 # if you set method to 2 or 3, the length need to config
+comments: + # Up to two comments system, the first will be shown as default + # Choose: Disqus/Disqusjs/Livere/Gitalk/Valine/Utterances/Facebook Comments + use: + # - Valine + # - Disqus + text: true # Display the comment name next to the button + # lazyload: The comment system will be load when comment element enters the browser's viewport. + # If you set it to false, the comment count will be invalid + lazyload: false + count: false # Display comment count in top_img
+# Displays outdated notice for a post (文章過期提醒) +noticeOutdate: + enable: false + style: flat # style: simple/flat + limit_day: 500 # When will it be shown + position: top # position: top/bottom + message_prev: It has been + message_next: days since the last update, the content of the article may be outdated.
增加mac light 代碼框配色
文章copyright 可單獨配置
card-category 中category名稱和數字限制一行顯示
簡繁轉換優化，placeholder也會被轉換
引入css變數，減少css體積
新增 Pjax #234
1 2 3 4
+# Pjax [Beta] +# It may contain bugs and unstable, give feedback when you find the bugs. +# https://github.com/MoOx/pjax +pjax: false
+# Yandex Webmaster tools verification setting +# see https://webmaster.yandex.com/ +yandex_site_verification:
post-meta可以配置是否顯示文字
1 2 3 4 5 6 7 8 9 10 11
post_meta: page: # Home Page date_type: created # created or updated or both 主頁文章日期是創建日或者更新日或都顯示 categories: true # true or false 主頁是否顯示分類 tags: false # true or false 主頁是否顯示標籤 + label: true # true or false 顯示描述性文字 post: date_type: both # created or updated or both 文章頁日期是創建日或者更新日或都顯示 categories: true # true or false 文章頁是否顯示分類 tags: true # true or false 文章頁是否顯示標籤 + label: true # true or false 顯示描述性文字
aside: card_categories: enable: true limit: 8 # if set 0 will show all + expand: none # none/true/false
更改auto_excerpt為index_post_content，並擁有三種方法可選
1 2 3 4 5 6 7 8 9 10 11 12
-# 自動節選 -auto_excerpt: - enable: true - length: 150 +# Display the article introduction on homepage +# 1: description +# 2: both (if the description exists, it will show description. or show the auto_excerpt) +# 3: auto_excerpt (default) +index_post_content: + method: 3 + length: 500 # if you set method to 2 or 3, the length need to config
文章/頁面font-matter 可設置highlight_shrink (true or false)
代碼框優化
調整部分代碼顔色
增加一款代碼主題 mac
代碼框主題支持自定義
閲讀模式下去掉代碼高亮
disqusjs更新js/css版本，增加nocomment配置
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
disqusjs: enable: false shortname: siteName: apikey: - api: https://disqus.skk.moe/disqus/ #一般情況下無需修改 API 地址 + api: + nocomment: # display when a blog post or an article has no comment attached admin: adminLabel: count: false # dispaly comment count in top_img
+ # anchor + # when you scroll in post , the url will update according to header id. + anchor: false
Fix
修復當menu沒設置圖標時，會報Cannot read property 'trim' of undefined 的bug
修復meta description 自動生成文章前200文字時部分沒有轉義的bug
修復開啟lazyload後，使用 無法顯示照片的bug
修復tags頁標籤只顯示8個的bug
修復當博客root不是'/'時,引用本地圖片會顯示不出的bug
修復替換url hash 導致頁面跳動的bug
2.3.0(2020/04/26)
2.3.0(2020/04/26)
Breaking Change
增加Facebook Comments
1 2 3 4 5 6 7 8 9 10
+# Facebook Comments Plugin +# https://developers.facebook.com/docs/plugins/comments/ +facebook_comments: + enable: false + app_id: + user_id: # optional + pageSize: 10 # The number of comments to show + order_by: social # social/time/reverse_time + lang: en_US # Language en_US/zh_CN/zh_TW and so on + count: false
aside: enable: true mobile: true # 手機頁面( 顯示寬度 < 768px )是否顯示aside內容 position: right # left or right - card_author: true - card_announcement: true - card_recent_post: true - card_categories: true - card_tags: true - card_archives: true + card_author: + enable: true + description: + card_announcement: + enable: true + content: This is my Blog + card_recent_post: + enable: true + limit: 5 # if set 0 will show all + card_categories: + enable: true + limit: 8 # if set 0 will show all + card_tags: + enable: true + limit: 40 # if set 0 will show all + color: false + card_archives: + enable: true + type: monthly # yearly or monthly + format: MMMM YYYY # eg: YYYY年MM月 + order: -1 # Sort of order. 1, asc for ascending; -1, desc for descending + limit: 8 # if set 0 will show all card_webinfo: true -# 網站公告 -announcement: - content: 感謝訪問本站，若喜歡請收藏 ^_^
valine: enable: false # if you want use valine,please set this value is true appId: # leancloud application app id appKey: # leancloud application app key notify: false # valine mail notify (true/false) Deprecated in v1.4.0+ verify: false # valine verify code (true/false) Deprecated in v1.4.0+ pageSize: 10 # comment list page size avatar: monsterid # gravatar style https://valine.js.org/#/avatar lang: en # i18n: zh-CN/zh-TW/en/ja placeholder: Please leave your footprints # valine comment input placeholder(like: Please leave your footprints ) guest_info: nick,mail,link #valine comment header info recordIP: false # Record reviewer IP serverURLs: # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in) + emojiCDN: # emoji CDN + enableQQ: false # enable the Nickname box to automatically get QQ Nickname and QQ Avatar + requiredFields: nick,mail # required fields nick/mail/link bg: /img/comment_bg.png # valine background count: false # dispaly comment count in top_img
gitalk: enable: false client_id: client_secret: repo: owner: admin: language: zh-CN # en , zh-CN , zh-TW + perPage: 10 # Pagination size, with maximum 100. + distractionFreeMode: false # Facebook-like distraction free mode. + pagerDirection: last # Comment sorting direction, available values are last and first. + createIssueManually: false # Gitalk will create a corresponding github issue for your every single page automatically count: true # top_img顯示評論數
valine: enable: false # if you want use valine,please set this value is true appId: # leancloud application app id appKey: # leancloud application app key notify: false # valine mail notify (true/false) https://github.com/xCss/Valine/wiki verify: false # valine verify code (true/false) pageSize: 10 # comment list page size avatar: monsterid # gravatar style https://valine.js.org/#/avatar lang: en # i18n: zh-cn/en placeholder: 記得留下你的暱稱和郵箱....可以快速收到回覆 # valine comment input placeholder(like: Please leave your footprints ) guest_info: nick,mail,link #valine comment header info + recordIP: false # Record reviewer IP + serverURLs: # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in) bg: /img/comment_bg.png # valine background count: true # top_img顯示評論數
darkmode配置整理
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
- # 夜間模式 - darkmode: - enable: true
-# 自動切換 dark mode和 light mode -# autoChangeMode: 1 跟隨系統而變化，不支持的瀏覽器/系統將按照時間晚上6點到早上6點之間切換為 dark mode -# autoChangeMode: 2 只按照時間晚上6點到早上6點之間切換為 dark mode -# autoChangeMode: false 取消自動切換 -autoChangeMode: false
post_meta: - date_type: both # or created or updated 文章日期是創建日或者更新日或都顯示 - categories: true # or false 是否顯示分類 - tags: true # or false 是否顯示標籤 + page: + date_type: both # created or updated or both 主頁文章日期是創建日或者更新日或都顯示 + categories: true # true or false 主頁是否顯示分類 + tags: true # true or false 主頁是否顯示標籤 + post: + date_type: both # created or updated or both 文章頁日期是創建日或者更新日或都顯示 + categories: true # true or false 文章頁是否顯示分類 + tags: true # true or false 文章頁是否顯示標籤
Feature
適配IE
增加一個Tag Plugins: 圖庫集
增加一個Tag Plugins: tag-hide 功能 inline/block
去除page頁開頭顯示與標題一樣的內容
aside 公告欄設置，支持html代碼
手機界面sidebar顯示進度條和加深對應的標題
主頁subtitle 的 hitokoto 顯示內容出處
footer 的hexo鏈接改為https
修改手機下，menus和toc的打開效果
手機頁面下，搜索界面全屏顯示
SEO優化，標題欄改為h1顯示
閲讀模式優化，可根據light mode 和darkmode調整背景
當屏蔽js時，header會出現(之前用js控制，會隱藏)
Fixed
修復Tencent Analytics的script加載為https #105
修復相關文章，日期顯示錯誤bug
修復gitalk報錯問題
修復當valine background 是絕對地址時無法顯示的bug
修復medium-zoom 無法使用的bug
修復在safari下，點擊或移動到首頁文章cover，圓角變成正方形的bug #114
修復在部分瀏覽器下，aside,友情鏈接頭像轉動變形的bug
修復在寬度限制下，表格內容溢出屏幕外而出現滾動條的bug #138
修復gitalk js 在一些沒有設置評論的page里加載的bug
修復tag plugins 的gist 在不同主題下的背景顏色問題(黑色主題下，文字不易觀看)
修復highlight figcaption 顯示不全的bug
修復disqus評論數無法獲取的bug
修復子目錄在觸摸屏下點擊,偶爾不出現的bug
修復a標籤太長(連續英文字母)不會換行的bug
修復toc滾動時，閲讀進度條也跟着滾動的bug
修復aside的圖片，可點擊顯示大圖bug
修復activate-power-mode設置參數無效bug
修復語言上的錯誤 #156
修復主頁在safari桌面端，首頁滾動卡頓的bug
2.1.0 (2019/12/20)
2.1.0 (2019/12/20)
Feature
可設置隱藏文章
適配 Hexo 的 Tag Plugins Code Block With marked lines 顯示
頁面只顯示 extends includes/layout.pug block content #recent-posts.recent-posts include includes/recent-posts.pug include includes/pagination.pug #aside_content.aside_content include includes/aside.pug
請下載安裝：npm install hexo-renderer-pug hexo-renderer-stylus --save or yarn add hexo-renderer-pug hexo-renderer-stylus
ERROR D:\Desktop\orxing-blog\themes\Butterfly\layout\flink.pug:2 1| .flink > 2| each i in site.data.link 3| p.comment-word= i.class_name 4| .post-cards 5| ul.md-links
Cannot read property 'length' of undefined TypeError: D:\Desktop\orxing-blog\themes\Butterfly\layout\flink.pug:2 1| .flink > 2| each i in site.data.link 3| p.comment-word= i.class_name 4| .post-cards 5| ul.md-links
Cannot read property 'length' of undefined at eval (eval at wrap (D:\Desktop\orxing-blog\node_modules\pug-runtime\wrap.js:6:10), <anonymous>:1890:32) at eval (eval at wrap (D:\Desktop\orxing-blog\node_modules\pug-runtime\wrap.js:6:10), <anonymous>:2017:4) at template (eval at wrap (D:\Desktop\orxing-blog\node_modules\pug-runtime\wrap.js:6:10), <anonymous>:10152:72) at Theme._View.View._compiled (D:\Desktop\orxing-blog\node_modules\hexo\lib\theme\view.js:123:48) at Theme._View.View.View.render (D:\Desktop\orxing-blog\node_modules\hexo\lib\theme\view.js:29:15) at D:\Desktop\orxing-blog\node_modules\hexo\lib\hexo\index.js:349:21 at tryCatcher (D:\Desktop\orxing-blog\node_modules\bluebird\js\release\util.js:16:23) at D:\Desktop\orxing-blog\node_modules\bluebird\js\release\method.js:15:34 at RouteStream._read (D:\Desktop\orxing-blog\node_modules\hexo\lib\hexo\router.js:123:3) at RouteStream.Readable.read (_stream_readable.js:457:10) at resume_ (_stream_readable.js:936:12) at processTicksAndRejections (internal/process/task_queues.js:84:9)
INFO Deleted database. INFO Start processing FATAL Something's wrong. Maybe you can find the solution here: https://hexo.io/docs/troubleshooting.html TypeError: Cannot read property 'enable' of undefined at Hexo.<anonymous> (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/themes/Butterfly/scripts/post-lazyload.js:5:23) at Hexo.tryCatcher (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/util.js:16:23) at Hexo.<anonymous> (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/method.js:15:34) at /Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/hexo/lib/extend/filter.js:60:50 at tryCatcher (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/util.js:16:23) at Object.gotValue (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/reduce.js:155:18) at Object.gotAccum (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/reduce.js:144:25) at Object.tryCatcher (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/util.js:16:23) at Promise._settlePromiseFromHandler (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/promise.js:517:31) at Promise._settlePromise (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/promise.js:574:18) at Promise._settlePromiseCtx (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/promise.js:611:10) at _drainQueueStep (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/async.js:142:12) at _drainQueue (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/async.js:131:9) at Async._drainQueues (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/async.js:147:5) at Immediate.Async.drainQueues [as _onImmediate] (/Users/qinkangdeid/Nextcloud/work/codes/personal/github/personal/qinkangdeid.github.io/node_modules/bluebird/js/release/async.js:17:14) at processImmediate (internal/timers.js:439:21)
請參照最新版的_config.yml, 比對後，把缺的配置複製到主題配置文件中去
wordcount is not a function / totalcount is not a function
報錯wordcount is not a function
請檢查是否安裝了 wordcount 插件 npm i --save hexo-wordcount
升級 2.0.0 後運行報錯
舊版本升級到 2.0.0 後報錯
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
INFO Start processing FATAL Something’s wrong. Maybe you can find the solution here: https://hexo.io/docs/troubleshooting.html Template render error: (unknown path) unexpected end of file at Object.prettifyError (F:\hexo\nodemodules\nunjucks\src\lib.js:36:11) at Template.render (F:\hexo\node_modules\nunjucks\src\environment.js:542:21) at Environment.renderString (F:\hexo\node_modules\nunjucks\src\environment.js:380:17) at Promise.fromCallback.cb (F:\hexo\node_modules\hexo\lib\extend\tag.js:123:48) at tryCatcher (F:\hexo\node_modules\bluebird\js\release\util.js:16:23) at Function.Promise.fromNode.Promise.fromCallback (F:\hexo\node_modules\bluebird\js\release\promise.js:185:30) at Tag.render (F:\hexo\node_modules\hexo\lib\extend\tag.js:123:18) at Object.onRenderEnd (F:\hexo\node_modules\hexo\lib\hexo\post.js:280:20) at Promise.then.then.result (F:\hexo\node_modules\hexo\lib\hexo\render.js:64:19) at tryCatcher (F:\hexo\node_modules\bluebird\js\release\util.js:16:23) at Promise.settlePromiseFromHandler (F:\hexo\nodemodules\bluebird\js\release\promise.js:517:31)
> 1| - 2| var algolia = 'undefined'; 3| var env = process.env; 4| if (theme.algolia_search.enable) {
Cannot read property 'appId' of undefined at eval (eval at wrap (F:\github\Blog\blog\node_modules\pug-runtime\wrap.js:6:10), <anonymous>:8:49) at template (eval at wrap (F:\github\Blog\blog\node_modules\pug-runtime\wrap.js:6:10), <anonymous>:329:53) at _View._compiledSync (F:\github\Blog\blog\node_modules\hexo\lib\theme\view.js:132:24) at _View.renderSync (F:\github\Blog\blog\node_modules\hexo\lib\theme\view.js:59:25) at F:\github\Blog\blog\node_modules\hexo\lib\plugins\helper\partial.js:31:52 at Cache.apply (F:\github\Blog\blog\node_modules\hexo\node_modules\hexo-util\lib\cache.js:27:46) at Object.fragmentCache (F:\github\Blog\blog\node_modules\hexo\lib\plugins\helper\fragment_cache.js:11:34) at Object.partial (F:\github\Blog\blog\node_modules\hexo\lib\plugins\helper\partial.js:31:17) at eval (eval at wrap (F:\github\Blog\blog\node_modules\pug-runtime\wrap.js:6:10), <anonymous>:149:46) at template (eval at wrap (F:\github\Blog\blog\node_modules\pug-runtime\wrap.js:6:10), <anonymous>:5213:93) at _View._compiled (F:\github\Blog\blog\node_modules\hexo\lib\theme\view.js:136:50) at _View.render (F:\github\Blog\blog\node_modules\hexo\lib\theme\view.js:39:17) at F:\github\Blog\blog\node_modules\hexo\lib\hexo\index.js:64:21 at tryCatcher (F:\github\Blog\blog\node_modules\hexo\node_modules\bluebird\js\release\util.js:16:23) at F:\github\Blog\blog\node_modules\hexo\node_modules\bluebird\js\release\method.js:15:34 at RouteStream._read (F:\github\Blog\blog\node_modules\hexo\lib\hexo\router.js:30:5) at RouteStream.Readable.read (_stream_readable.js:490:10) at resume_ (_stream_readable.js:975:12) at processTicksAndRejections (internal/process/task_queues.js:80:21) { path: 'F:\\github\\Blog\\blog\\themes\\Butterfly\\layout\\includes\\head.pug' }
algolia 插件安裝後還需要配置 查看插件文檔配置
頂部出現 Loading
生成前先 hexo clean
點擊中文目錄報錯的問題
這種情況出現在主題為 3.0.0以下版本，升級主題就行
Uncaught ReferenceError: regeneratorRuntime is not defined
note: # Note tag style values: # - simple bs-callout old alert style. Default. # - modern bs-callout new (v2-v3) alert style. # - flat flat callout style with background, like on Mozilla or StackOverflow. # - disabled disable all CSS styles import of note tag. style:simple icons:false border_radius:3 # Offset lighter of background in % for modern and flat styles (modern: -12 | 12; flat: -18 | 6). # Offset also applied to label tag variables. This option can work with disabled note tag. light_bg_offset:0
<div class="gallery-group-main"> {% galleryGroup name description link img-url %} {% galleryGroup name description link img-url %} {% galleryGroup name description link img-url %} </div>
This is my website, click the button {% btn 'https://butterfly.js.org/',Butterfly %} This is my website, click the button {% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right %} This is my website, click the button {% btn 'https://butterfly.js.org/',Butterfly,,outline %} This is my website, click the button {% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,outline %} This is my website, click the button {% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,larger %}
This is my website, click the button Butterfly This is my website, click the button Butterfly This is my website, click the button Butterfly This is my website, click the button Butterfly This is my website, click the button Butterfly
1 2 3
{% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,block %} {% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,block center larger %} {% btn 'https://butterfly.js.org/',Butterfly,far fa-hand-point-right,block right outline larger %}
除了计算机编程外，我想不出还有其他让我感兴趣的工作。 我可以无中生有地创造出精美的范式和结构， 在此过程中也解决了无数的小谜团。 I can't think of any other job other than computer programming that interests me. I can create beautiful paradigms and structures out of nothing, Countless small mysteries are also solved in the process.
# Display the article introduction on homepage # 1: description # 2: both (if the description exists, it will show description, or show the auto_excerpt) # 3: auto_excerpt (default) # false: do not show the article introduction index_post_content: method:3 # If you set method to 2 or 3, the length need to config length:500
# Post edit # Easily browse and edit blog source code online. post_edit: enable:false # url: https://github.com/user-name/repo-name/edit/branch-name/subdirectory-name/ # For example: https://github.com/jerryc127/butterfly.js.org/edit/main/source/ url:
相關文章
當文章封面設置為 false 時，或者沒有獲取到封面配置，相關文章背景將會顯示主題色。
相關文章推薦的原理是根據文章 tags 的比重來推薦
1 2 3 4
related_post: enable:true limit:6# 顯示推薦文章數目 date_type:created# or created or updated 文章日期顯示創建日或者更新日
文章分頁按鈕
當文章封面設置為 false 時，或者沒有獲取到封面配置，分頁背景將會顯示主題色。
可設置分頁的邏輯，也可以關閉分頁顯示
1 2 3 4 5 6
# post_pagination (分頁) # value: 1 || 2 || false # 1: The 'next post' will link to old post # 2: The 'next post' will link to new post # false: disable pagination post_pagination:false
# Displays outdated notice for a post noticeOutdate: enable:false # Style: simple / flat style:flat # When will it be shown limit_day:365 # Position: top / bottom position:top message_prev:Ithasbeen message_next:dayssincethelastupdate,thecontentofthearticlemaybeoutdated.
aside: enable:true hide:false # Show the button to hide the aside in bottom right button button:true mobile:true # Position: left / right position:right display: archive:true tag:true category:true card_author: enable:true description: button: enable:true icon:fabfa-github text:FollowMe link:https://github.com/xxxxxx card_announcement: enable:true content:ThisismyBlog card_recent_post: enable:true # If set 0 will show all limit:5 # Sort: date / updated sort:date sort_order: card_newest_comments: enable:false sort_order: limit:6 # Unit: mins, save data to localStorage storage:10 avatar:true card_categories: enable:true # If set 0 will show all limit:8 # Choose: none / true / false expand:none sort_order: card_tags: enable:true # If set 0 will show all limit:40 color:false # Order of tags, random/name/length orderby:random # Sort of order. 1, asc for ascending; -1, desc for descending order:1 sort_order: card_archives: enable:true # Type: monthly / yearly type:monthly # Eg: YYYY年MM月 format:MMMMYYYY # Sort of order. 1, asc for ascending; -1, desc for descending order:-1 # If set 0 will show all limit:8 sort_order: card_post_series: enable:true # The title shows the series name series_title:false # Order by title or date orderBy:'date' # Sort of order. 1, asc for ascending; -1, desc for descending order:-1 card_webinfo: enable:true post_count:true last_push_date:true sort_order: # Time difference between publish date and now # Formal: Month/Day/Year Time or Year/Month/Day Time # Leave it empty if you don't enable this feature runtime_date:
# dark mode darkmode: enable:true # dark mode和 light mode切換按鈕 button:true autoChangeMode:false # Set the light mode time. The value is between 0 and 24. If not set, the default value is 6 and 18 start:# 8 end:# 22
參數
解釋
button
是否在右下角顯示日夜模式切換按鈕
autoChangeMode
自動切換的模式 autoChangeMode: 1 跟隨系統而變化，不支持的瀏覽器/系統將按照時間 start 到 end 之間切換為 light mode autoChangeMode: 2 只按照時間 start 到 end 之間切換為 light mode ,其餘時間為 dark mode autoChangeMode: false 取消自動切換
start
light mode 的開始時間
end
light mode 的結束時間
滾動狀態百分比
1 2
# show scroll percent in scroll-to-top button rightside_scroll_percent:true
按鈕排序
可對右下角按鈕進行排序
注意： 不要重複
1 2 3 4 5 6 7
# Don't modify the following settings unless you know how they work (非必要請不要修改 ) # Choose: readmode,translate,darkmode,hideAside,toc,chat,comment # Don't repeat 不要重複 rightside_item_order: enable:false hide:# readmode,translate,darkmode,hideAside show:# toc,chat,comment
全局配置
頁面錨點
開啟頁面錨點後，當你在進行滾動時，頁面鏈接會根據標題 ID 進行替換 (注意: 每替換一次，會留下一個歷史記錄。所以如果一篇文章有很多錨點的話，網頁的歷史記錄會很多。)
1 2 3 4 5 6
# anchor anchor: # when you scroll, the URL will update according to header id. auto_update:false # Click the headline to scroll and update the anchor click_to_scroll:false
配置
解釋
auto_update
當滾動時，URL 將根據標題 id 更新。默認為 false。
click_to_scroll
點擊標題滾動並更新錨點。默認為 false。
圖片描述
可開啟圖片 Figcaption 描述文字顯示
優先顯示圖片的 title 屬性，然後是 alt 屬性
1
photofigcaption:true
複製相關配置
可配置網站是否可以複製、複製的內容是否添加版權信息
1 2 3 4 5 6
copy: enable:true # Add the copyright information after copied content copyright: enable:false limit_count:150
配置
解釋
enable
是否開啟網站複製權限
copyright
複製的內容後面加上版權信息
enable
是否開啟複製版權信息添加
limit_count
字數限制，當複製文字大於這個字數限制時，將在複製的內容後面加上版權信息
添加版權信息後
1 2 3 4 5 6 7
Lorem ipsum dolor sit amet, test link consectetur adipiscing elit. Strong text pellentesque ligula commodo viverra vehicula. Italic text at ullamcorper enim. Morbi a euismod nibh. Underline text non elit nisl. Deleted text tristique, sem id condimentum tempus, metus lectus venenatis mauris, sit amet semper lorem felis a eros. Fusce egestas nibh at sagittis auctor. Sed ultricies ac arcu quis molestie. Donec dapibus nunc in nibh egestas, vitae volutpat sem iaculis. Curabitur sem tellus, elementum nec quam id, fermentum laoreet mi. Ut mollis ullamcorper turpis, vitae facilisis velit ultricies sit amet. Etiam laoreet dui odio, id tempus justo tincidunt id. Phasellus scelerisque nunc sed nunc ultricies accumsan.
作者: Jerry 連結: http://localhost:4000/posts/bd3c650b/#Paragraph 來源: Butterfly 著作權歸作者所有。商業轉載請聯絡作者獲得授權，非商業轉載請註明出處。
# Need to install the hexo-wordcount plugin wordcount: enable:false # Display the word count of the article in post meta post_wordcount:true # Display the time to read the article in post meta min2read:true # Display the total word count of the website in aside's webinfo total_wordcount:true
# About the per_page # if you set it to true, it will load mathjax/katex script in each page # if you set it to false, it will load mathjax/katex script according to your setting (add the 'mathjax: true' or 'katex: true' in page's front-matter) math: # Choose: mathjax, katex # Leave it empty if you don't need math use: per_page:true hide_scrollbar:false
# Local Search local_search: # Preload the search data when the page loads. preload:false # Show top n results per article, show all results by setting to -1 top_n_per_article:1 # Unescape html strings to the readable one. unescape:false CDN:
comments: # Up to two comments system, the first will be shown as default # Leave it empty if you don't need comments # Choose: Disqus/Disqusjs/Livere/Gitalk/Valine/Waline/Utterances/Facebook Comments/Twikoo/Giscus/Remark42/Artalk # Format of two comments system : Disqus,Waline use: # Display the comment name next to the button text:true # Lazyload: The comment system will be load when comment element enters the browser's viewport. # If you set it to true, the comment count will be invalid lazyload:false # Display comment count in post's top_img count:false # Display comment count in Home Page card_post_count:false
valine: appId: appKey: avatar:monsterid # This configuration is suitable for domestic custom domain name users, overseas version will be automatically detected (no need to manually fill in) serverURLs: bg: # Use Valine visitor count as the page view count visitor:false option:
artalk: server: site: # Use Artalk visitor count as the page view count visitor:false option:
參數
解釋
server
你的 Server URL
site
你的 Site ID
visitor
是否顯示文章閲讀數
option
可選配置
開啟 visitor 後，文章頁的訪問人數將改為 Artalk 提供，而不是 不蒜子
在綫聊天
主題內置了多種在綫聊天工具。你可以選擇開啟一種，方便你與訪客的交流。
1 2 3 4 5 6 7 8 9
chat: # Choose: chatra/tidio/crisp # Leave it empty if you don't need chat use: # Chat Button [recommend] # It will create a button in the bottom right corner of website, and hide the origin button rightside_button:false # The origin chat button is displayed when scrolling up, and the button is hidden when scrolling down button_hide_show:false
# Global font settings # Don't modify the following settings unless you know how they work (非必要不要修改) font: global-font-size: code-font-size: font-family:-apple-system,BlinkMacSystemFont,"Segoe UI","Helvetica Neue",Lato,Roboto,"PingFang SC","Microsoft JhengHei","Microsoft YaHei",sans-serif code-font-family:consolas,Menlo,"PingFang SC","Microsoft JhengHei","Microsoft YaHei",sans-serif
# Font settings for the site title and site subtitle # 左上角網站名字 主頁居中網站名字 blog_title_font: font_link:https://fonts.googleapis.com/css?family=Titillium+Web&display=swap font-family:TitilliumWeb,'PingFang SC','Hiragino Sans GB','Microsoft JhengHei','Microsoft YaHei',sans-serif
canvas_nest: enable:false # Color of lines, default: '0,0,0'; RGB values: (R,G,B).(note: use ',' to separate.) color:'0,0,255' # The opacity of line (0~1) opacity:0.7 # The z-index property of the background zIndex:-1 # The number of lines count:99 mobile:false
參數
解釋
enable
是否開啟綵帶特效
color
綵帶的顏色
opacity
綵帶的透明度
zIndex
綵帶的層級
count
綵帶的條數
mobile
手機端是否顯示綵帶
鼠標點擊效果
1 2 3 4
fireworks: enable:true zIndex:9999# -1 or 9999 mobile:false
如果你並不想為某張圖片添加大圖查看模式，你可以使用 html 格式引用圖片，併為圖片添加 no-lightbox class 名
1 2 3 4 5
# Choose: fancybox / medium_zoom # https://github.com/francoischalifour/medium-zoom # https://fancyapps.com/fancybox/ # Leave it empty if you don't need lightbox lightbox:
# CDN Settings # Don't modify the following settings unless you know how they work CDN: # The CDN provider for internal and third-party scripts # Options for both: local/jsdelivr/unpkg/cdnjs/custom # Note: Dev version can only use 'local' for internal scripts # Note: When setting third-party scripts to 'local', you need to install hexo-butterfly-extjs internal_provider:local third_party_provider:jsdelivr
# Add version number to url, true or false version:false
# Custom format # For example: https://cdn.staticfile.org/${cdnjs_name}/${version}/${min_cdnjs_file} custom_format:
<divclass="gallery-group-main"> {%galleryGroup'壁紙''收藏的一些壁紙''/Gallery/wallpaper'https://i.loli.net/2019/11/10/T7Mu8Aod3egmC4Q.png%} {%galleryGroup'漫威''關於漫威的圖片''/Gallery/marvel'https://i.loli.net/2019/12/25/8t97aVlp4hgyBGu.jpg%} {%galleryGroup'OH MY GIRL''關於OH MY GIRL的圖片''/Gallery/ohmygirl'https://i.loli.net/2019/12/25/hOqbQ3BIwa6KWpo.jpg%} </div>
-author:Butterfly avatar:https://butterfly.js.org/img/avatar.png date:2024-06-21 23:33:26 key:key-1 content:| This is a sample content for **Author 1**.  tags: -tags1 -tags2 -author:Butterfly avatar:https://butterfly.js.org/img/avatar.png date:2024-06-20 23:33:26 key:key-2 content:| This is a sample content for **Author 2**.  tags: -tag2 -tag3
This is my website, click the button {% btn 'https://butterfly.js.org',Butterfly %} This is my website, click the button {% btn 'https://butterfly.js.org',Butterfly,,outline%}
This is my website, click the button {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,block larger %} This is my website, click the button {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,block center larger %} This is my website, click the button {% btn 'https://butterfly.js.org',Butterfly,far fa-hand-point-right,block right blue larger %}
]]>標籤外掛(Tag Plugins)Markdown Style testhttps://butterfly.js.org/posts/89757140/2018-07-24T15:31:06.000Z2025-12-10T12:49:37.075ZThis post is originated from here and is used for testing markdown style. This post contains nearly every markdown usage. Make sure all the markdown elements below show up correctly.
Headers
1 2 3 4 5 6 7 8 9 10 11 12 13 14
# H1 ## H2 ### H3 #### H4 ##### H5 ###### H6
Alternatively, for H1 and H2, an underline-ish style:
Alt-H1 ======
Alt-H2 ------
H1
H2
H3
H4
H5
H6
Alternatively, for H1 and H2, an underline-ish style:
Alt-H1
Alt-H2
Emphasis
1 2 3 4 5 6 7
Emphasis, aka italics, with *asterisks* or _underscores_.
Strong emphasis, aka bold, with **asterisks** or __underscores__.
Combined emphasis with **asterisks and _underscores_**.
Strikethrough uses two tildes. ~~Scratch this.~~
Emphasis, aka italics, with asterisks or underscores.
Strong emphasis, aka bold, with asterisks or underscores.
1. First ordered list item 2. Another item * Unordered sub-list. 1. Actual numbers don't matter, just that it's a number 1. Ordered sub-list 4. And another item.
You can have properly indented paragraphs within list items. Notice the blank line above, and the leading spaces (at least one, but we'll use three here to also align the raw Markdown).
To have a line break without a paragraph, you will need to use two trailing spaces. Note that this line is separate, but within the same paragraph. (This is contrary to the typical GFM line break behaviour, where trailing spaces are not required.)
* Unordered list can use asterisks - Or minuses + Or pluses - Paragraph In unordered list
For example like this.
Common Paragraph with some text. And more text.
First ordered list item
Another item
Unordered sub-list.
Actual numbers don't matter, just that it's a number
Ordered sub-list
And another item.
You can have properly indented paragraphs within list items. Notice the blank line above, and the leading spaces (at least one, but we'll use three here to also align the raw Markdown).
To have a line break without a paragraph, you will need to use two trailing spaces. Note that this line is separate, but within the same paragraph. (This is contrary to the typical GFM line break behaviour, where trailing spaces are not required.)
Unordered list can use asterisks
Or minuses
Or pluses
Paragraph In unordered list
For example like this.
Common Paragraph with some text. And more text.
Inline HTML
1
<p>To reboot your computer, press <kbd>ctrl</kbd>+<kbd>alt</kbd>+<kbd>del</kbd>.</p>
To reboot your computer, press ctrl+alt+del.
1 2 3 4 5 6 7
<dl> <dt>Definition list</dt> <dd>Is something people use sometimes.</dd> <dt>Markdown in HTML</dt> <dd>Does *not* work **very** well. Use HTML <em>tags</em>.</dd> </dl>
Definition list
Is something people use sometimes.
<dt>Markdown in HTML</dt><dd>Does *not* work **very** well. Use HTML <em>tags</em>.</dd>
Links
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
[I'm an inline-style link](https://www.google.com)
[I'm an inline-style link with title](https://www.google.com "Google's Homepage")
[I'm a reference-style link][Arbitrary case-insensitive reference text]
[I'm a relative reference to a repository file](../blob/master/LICENSE)
[You can use numbers for reference-style link definitions][1]
Or leave it empty and use the [link text itself]
Some text to show that the reference links can follow later.
Some text to show that the reference links can follow later.
Images
1 2 3 4 5 6 7 8 9 10
hover to see the title text:
Inline-style:
Reference-style: ![alt text][logo]
[logo]: https://hexo.io/icon/favicon-196x196.png "Logo Title Text 2"
hover to see the title text:
Inline-style:
Reference-style:
Code and Syntax Highlighting
Inline code has back-ticks around it.
1 2
var s = "JavaScript syntax highlighting"; alert(s);
1 2
s = "Python syntax highlighting" print s
1 2
No language indicated, so no syntax highlighting. But let's throw in a <b>tag</b>.
Tables
1 2 3 4 5
| |ASCII |HTML | |----------------|-------------------------------|-----------------------------| |Single backticks|`'Isn't this fun?'` |'Isn't this fun?' | |Quotes |`"Isn't this fun?"` |"Isn't this fun?" | |Dashes |`-- is en-dash, --- is em-dash`|-- is en-dash, --- is em-dash|
ASCII
HTML
Single backticks
'Isn't this fun?'
'Isn't this fun?'
Quotes
"Isn't this fun?"
"Isn't this fun?"
Dashes
-- is en-dash, --- is em-dash
-- is en-dash, --- is em-dash
Colons can be used to align columns.
1 2 3 4 5
| Tables | Are | Cool | | ------------- |:-------------:| -----:| | col 3 is | right-aligned | | | col 2 is | centered | | | zebra stripes | are neat |
Tables
Are
Cool
col 3 is
right-aligned
col 2 is
centered
zebra stripes
are neat
The outer pipes (|) are optional, and you don't need to make the raw Markdown line up prettily. You can also use inline Markdown.
You can find more information about LaTeX mathematical expressions here.
Blockquotes
Blockquotes are very handy in email to emulate reply text. This line is part of the same quote.
Quote break.
This is a very long line that will still be quoted properly when it wraps. Oh boy let's keep writing to make sure this is long enough to actually wrap for everyone. Oh, you can putMarkdown into a blockquote.
Horizontal Rule
Three or more...
1 2 3 4 5 6 7 8 9 10 11
---
Hyphens
*** Asterisks ___ Underscores
Hyphens
Asterisks
Underscores
Line Breaks
1 2 3 4 5 6
Here's a line for us to start with.
This line is separated from the one above by two newlines, so it will be a *separate paragraph*.
This line is also a separate paragraph, but... This line is only separated by a single newline, so it's a separate line in the *same paragraph*.
Here's a line for us to start with.
This line is separated from the one above by two newlines, so it will be a separate paragraph.
This line is also a separate paragraph, but... This line is only separated by a single newline, so it's a separate line in the same paragraph.
1 2 3 4 5 6 7 8 9
This is a regular paragraph.
<table> <tr> <td>Foo</td> </tr> </table> This is another regular paragraph.
This is a regular paragraph.
Foo
This is another regular paragraph.
Youtube videos
1 2 3 4 5 6 7
<ahref="https://www.youtube.com/watch?feature=player_embedded&v=ARted4RniaU "target="_blank"><imgsrc="https://img.youtube.com/vi/ARted4RniaU/0.jpg" alt="IMAGE ALT TEXT HERE"width="240"height="180"border="10" /></a>
Pure markdown version:
[](https://www.youtube.com/watch?v=ARted4RniaU)
Pure markdown version:
]]><p>This post is originated from <a href="https://gist.github.com/apackeer/4159268">here</a> and is used for testing markdown style. This post contains nearly every markdown usage. Make sure all the markdown elements below show up correctly.</p>
