hexo-theme-stellar 1.39.1 → 1.40.0

package/.claude/skills/stellar-theme-dev/SKILL.md

@@ -29,11 +29,11 @@ description: 主题仓库（hexo-theme-stellar）开发全流程：方案 →
 命令按需执行：
 
 - `scripts/` 有改动 → 必须在主工程（xaoxuu.com）执行 `npm run g` 全量验证（已含 `hexo clean && hexo generate && npx gulp minify`）；`npm run s` 是按需渲染，不能替代。
-- 新增/修改纯函数 → 补充单测并跑 `npm run check`（lint + 单测 + 知识库硬事实核查）。
+- 新增/修改纯函数 → 补充单测并跑 `npm run check`（lint + 单测 + 依赖声明检查 + 知识库硬事实核查）。
 - 知识库有改动 → `python3 docs/knowledge/tools/verify.py` 硬事实核查。
 - UI 方面（样式、模板、前端交互等）改动量不大时无需自检流程，除非用户明确要求。
 - 检查所有受影响页面类型（首页、文章页、Wiki 页等），验证结果记录在方案目录 `checklist.md`。
-- 完成条件：应执行的命令全部通过；首页、文章页、Wiki 页等受影响页面类型均检查通过。
+- 完成条件：应执行的命令全部通过；新增 `require` 均已声明或为 Node 内置模块（test/ 禁止幽灵依赖）；首页、文章页、Wiki 页等受影响页面类型均检查通过。
 
 ### 4. 提交
 

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 1.40.0
+
+> 发布日期：2026-08-14
+
+### 新功能
+- 文章页新增字数与预计阅读时长显示（`article.reading_time`，默认关闭）
+- 文章卡片新增标签展示（最多 5 个，`article.card_tags`，默认关闭）
+- 新增表格标签 `{% table style:scroll|wrap|compact %}`，支持滚动/换行/紧凑三种表格样式
+- 新增气泡注解标签 `{% tip text:... %}词句{% endtip %}`，桌面 hover、移动端点击显示
+- 远程 Markdown 渲染抽象：`{% md %}` 标签新增可选 `wrap` 参数；wiki 项目配置 `repo` 后可直接以仓库 README 作为首页正文
+
+### 修复
+- wiki 项目描述作为页面描述（OG / JSON-LD）的兜底，修复 SEO 描述缺失的问题
+- 声明 hexo-pagination / hexo-util 依赖并新增依赖声明检查门禁，修复幽灵依赖导致的构建问题
+- 时间线节点标题（header）不再渲染 markdown 的问题（#401）
+- 分类页三级及以上分类无法正确展示的问题，改为基于 parent 递归构建嵌套树（#564）
+- 亮暗切换后 topbar 与左栏颜色不同步的问题：navbar/sidebar 暗色样式统一跟随 `data-theme` 开关（#593、#663）
+- iOS Safari 下右下角悬浮控件在玻璃椭圆框中不对齐的问题（#599）
+- artalk 邮件通知链接携带 `?atk_*` 参数导致目录定位失效的问题（#598）
+- waline 最近评论接口返回结构兼容（数组 / `{ data: [...] }`）（#630）
+- memos 新版 v1 接口识别与渲染适配，识别失败仍回退 feature 兜底（#668）
+- new-note 命令生成 front-matter 的 date 对齐为 `YYYY-MM-DD HH:mm`（#594）
+
+### 升级注意（配置变更与破坏性改动）
+- 新增 `article.reading_time`（默认 `false`）与 `article.card_tags`（默认 `false`），需要时设为 `true`
+- 新增 `table`、`tip` 两个标签插件；`table` 默认使用 `scroll` 样式
+
+Full Changelog: [1.39.1...1.40.0](https://github.com/xaoxuu/hexo-theme-stellar/compare/1.39.1...1.40.0)
+
 ## 1.39.1
 
 > 发布日期：2026-08-13

package/_config.yml

@@ -1,6 +1,6 @@
 ######## Stellar info ########
 stellar:
-  version: '1.39.1'
+  version: '1.40.0'
   homepage: 'https://xaoxuu.com/wiki/stellar/'
   repo: 'https://github.com/xaoxuu/hexo-theme-stellar'
   main_css: /css/main.css
@@ -206,6 +206,10 @@ article:
   related_posts:
     enable: false
     max_count: 5
+  # 文章页是否显示字数和预计阅读时长（#302）
+  reading_time: false
+  # 文章卡片是否显示标签（最多 5 个，#580）
+  card_tags: false
 
 search:
   service: local_search # local_search, algolia_search, todo...
@@ -676,7 +680,7 @@ style:
     image-l: 24px # 非技术类文章插图圆角
     image: 16px # 技术类文章插图圆角
     image-s: 8px # 评论区图片圆角（部分评论支持）
-  corner-shape: superellipse(1.5) # 连续曲率圆角（仅 Chromium 139+ 支持，其余浏览器自动回退普通圆角）：superellipse(1.x) 开启，round 关闭
+  corner-shape: superellipse(1.25) # 连续曲率圆角（仅 Chromium 139+ 支持，其余浏览器自动回退普通圆角）：superellipse(1.x) 开启，round 关闭
   color:
     # 主题色配置（不会根据明暗动态调整，请设置为通用的颜色）
     theme: 'hsl(192 98% 55%)' # 主题色

package/languages/en.yml

@@ -37,6 +37,8 @@ meta:
   license: License
   share: Share
   contributors: Page Contributors
+  word_count: '%s words'
+  reading_time: '%s min read'
   date_suffix:
     just: Just
     min: minutes ago

package/languages/zh-CN.yml

@@ -37,6 +37,8 @@ meta:
   license: 许可协议
   share: 分享文章
   contributors: 本文贡献者
+  word_count: '%s 字'
+  reading_time: '预计阅读 %s 分钟'
   date_suffix:
     just: 刚刚
     min: 分钟前

package/languages/zh-TW.yml

@@ -37,6 +37,8 @@ meta:
   license: 授權條款
   share: 分享文章
   contributors: 本文貢獻者
+  word_count: '%s 字'
+  reading_time: '預計閱讀 %s 分鐘'
   date_suffix:
     just: 剛剛
     min: 分鐘前

package/layout/_partial/comments/artalk/script.ejs

@@ -39,6 +39,14 @@
               },
             <% } %>
           });
+          // artalk 邮件通知链接携带 ?atk_comment=... 等查询参数，
+          // 其 hash 监听会与主题目录定位冲突（#598）：
+          // 初始化并完成评论定位后清理查询参数，避免后续目录/锚点跳转被干扰。
+          if (window.location.search.indexOf('atk_') !== -1) {
+            window.setTimeout(function () {
+              window.history.replaceState(null, '', window.location.pathname + window.location.hash);
+            }, 300);
+          }
         });
       }
       

package/layout/_partial/head.ejs

@@ -23,14 +23,17 @@ function generate_description() {
   if (theme.open_graph && theme.open_graph.enable) {
     return '';
   }
+  if (page.description) {
+    return '<meta name="description" content="' + truncate(strip_html(page.description), {length: 150}) + '">';
+  }
   if (page.wiki) {
     const proj = theme.wiki.tree[page.wiki]
     if (proj?.description) {
       return '<meta name="description" content="' + proj.description + '">'
     }
   }
-  if (page.description || page.excerpt || page.content) {
-    return '<meta name="description" content="' + truncate(strip_html(page.description || page.excerpt || page.content), {length: 150}) + '">';
+  if (page.excerpt || page.content) {
+    return '<meta name="description" content="' + truncate(strip_html(page.excerpt || page.content), {length: 150}) + '">';
   }
   return '<meta name="description" content="' + config.description + '">';
 }
@@ -66,6 +69,12 @@ function og_args() {
   if (page.layout == 'post' && page.cover) {
     args.twitter_card = 'summary_large_image';
   }
+  if (page.wiki && !page.description) {
+    const proj = theme.wiki.tree[page.wiki];
+    if (proj && proj.description) {
+      args.description = proj.description;
+    }
+  }
   args.image = config.avatar || (config.email ? gravatar(config.email) : null);
   return Object.assign(args, page.open_graph);
 }

package/layout/_partial/main/navbar/article_banner.ejs

@@ -41,6 +41,13 @@ function layoutBreadcrumb() {
     } else {
       el += partial('breadcrumb/page')
     }
+  // 字数和预计阅读时长，置于面包屑行右侧（#302）
+  if (page.layout == 'post' && theme.article.reading_time) {
+    var _wc = word_count(page)
+    if (_wc > 0) {
+      el += `<span class="cap reading right">${__("meta.word_count", _wc)} · ${__("meta.reading_time", reading_time(page))}</span>`
+    }
+  }
   // end 3.left.top
   el += `</div>`
   // 3.left.bottom

package/layout/_partial/main/navbar/dateinfo.ejs

@@ -42,4 +42,4 @@ function layoutDiv() {
   return el
 }
 %>
-<%- layoutDiv() %>
+<%- layoutDiv() %>

package/layout/_partial/main/post_list/post_card.ejs

@@ -93,6 +93,17 @@ function div_default() {
     }
   }
   // 置顶文章由轮播（默认）或首页列表靠前展示（flat 平铺）承担，卡片内不显示 pin 图标。
+  // 文章标签（最多 5 个，#580）
+  if (theme.article.card_tags && post.tags && post.tags.length > 0) {
+    el += '<span class="card-tags">';
+    post.tags.forEach((tag, i) => {
+      if (i >= 5) {
+        return;
+      }
+      el += `<span class="cap tag-chip">#${escape_html(tag.name)}</span>`;
+    });
+    el += '</span>';
+  }
   el += '</div>';
   el += '</article>';
   return el;

package/layout/_partial/widgets/markdown.ejs

@@ -13,7 +13,7 @@ function layoutDiv() {
     el += markdown(item.content);
   }
   if (item.src) {
-    el += `<div class="data-service ds-mdrender" src="${item.src}"></div>`
+    el += mdrender_html(item.src)
   }
   if (item.linklist) {
     el += partial('components/linklist', {item: item.linklist})

package/layout/_partial/widgets/toc.ejs

@@ -38,9 +38,12 @@ function layoutToc(fallback) {
 function layoutDiv(fallback) {
   const tocBody = layoutTocBody()
   const hasToc = tocBody.trim().length > 0
+  // 远程 md 内容由客户端渲染，构建期正文无标题：
+  // 预留空 TOC 容器，渲染完成后由 mdrender.js 填充
+  const hasRemoteMd = has_remote_md(page)
   // 页面是否实际渲染评论区，由 _partial/comments/layout.ejs 标记
   const hasComments = page.cmt_rendered === true
-  if (!hasToc && !hasComments) {
+  if (!hasToc && !hasRemoteMd && !hasComments) {
     return ''
   }
   var el = ''
@@ -50,6 +53,10 @@ function layoutDiv(fallback) {
     el += `<div class="widget-body">`
     el += tocBody
     el += `</div>`
+  } else if (hasRemoteMd) {
+    el += layoutTocHeader()
+    el += `<div class="widget-body">`
+    el += `</div>`
   }
   el += `<div class="widget-footer">`
   el += `<a class="top" onclick="util.scrollTop()">`

package/layout/categories.ejs

@@ -10,14 +10,24 @@ if (page.menu_id == undefined) {
   <%- partial('_partial/main/navbar/nav_tabs_blog') %>
   <div class='post-list'>
     <article class='<%- scrollreveal("") %>' id='cats'>
-      <% site.categories.sort('path').each(function(category){ %>
-        <div>
-          <a class="<%= category.parent ? 'cat child' : 'cat'%>" href="<%= pretty_url(category.path) %>">
-            <span class='name'><%- icon('default:category') %><%- category.name %></span>
-            <span class='badge'>(<%- category.posts.length %>)</span>
-          </a>
-        </div>
-      <% }) %>
+      <%
+      function renderCategoryTree(nodes) {
+        var el = ''
+        nodes.forEach(function(node) {
+          el += `<div class="cat-item">`
+          el += `<a class="cat${node.parentId ? ' child' : ''}" href="${pretty_url(node.path)}">`
+          el += `<span class="name">${icon('default:category')}${escape_html(node.name)}</span>`
+          el += `<span class="badge">(${node.count})</span>`
+          el += `</a>`
+          if (node.children && node.children.length > 0) {
+            el += `<div class="cat-children">${renderCategoryTree(node.children)}</div>`
+          }
+          el += `</div>`
+        })
+        return el
+      }
+      %>
+      <%- renderCategoryTree(category_tree(site.categories)) %>
     </article>
   </div>
 <% } %>

package/layout/page.ejs

@@ -44,8 +44,12 @@ function layoutDiv() {
     el += partial('_partial/main/navbar/article_banner')
   }
   el += `<article class="${articleClass()}">`
-  if (page.content && page.content.length > 0) {
+  if (page.content && String(page.content).trim().length > 0) {
     el += page.content
+  } else {
+    // wiki 项目首页正文为空（剪裁空白后）且配置了 repo 时，
+    // 以该仓库 README.md 作为主页正文（应用层 helper，复用底层远程 md 渲染组件）
+    el += wiki_readme_html(theme.wiki.tree[page.wiki], page)
   }
   if (notebook) {
     el += partial('_partial/main/notebook/note_tags', { notebook: notebook })

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "hexo-theme-stellar",
-  "version": "1.39.1",
+  "version": "1.40.0",
   "description": "Elegant and powerful theme for Hexo.",
   "main": "package.json",
   "scripts": {
     "lint": "eslint .",
-    "test": "node --test",
+    "test": "node ci/check-require-decls.js && node --test",
     "check": "npm run lint && npm test && python3 docs/knowledge/tools/verify.py",
     "release": "node release.js",
     "release:dry": "node release.js --dry-run"
@@ -29,10 +29,12 @@
     "glob": "^10.4.0",
     "hexo-renderer-ejs": "^2.0.0",
     "hexo-renderer-stylus": "^3.0.1",
+    "hexo-pagination": "^3.0.0",
     "probe-image-size": "^7.2.3"
   },
   "homepage": "https://xaoxuu.com/wiki/stellar/",
   "devDependencies": {
-    "eslint": "^9.39.5"
+    "eslint": "^9.39.5",
+    "hexo-util": "^4.0.0"
   }
 }

package/scripts/commands/new-note.js

@@ -36,7 +36,7 @@ hexo.extend.console.register('new-note', 'Create a new note', {
   const frontMatter = [
     '---',
     `title: ${name}`,
-    `date: ${date.getFullYear()}-${String(date.getMonth()+1).padStart(2,'0')}-${String(date.getDate()).padStart(2,'0')} ${String(date.getHours()).padStart(2,'0')}:${String(date.getMinutes()).padStart(2,'0')}:${String(date.getSeconds()).padStart(2,'0')}`,
+    `date: ${date.getFullYear()}-${String(date.getMonth()+1).padStart(2,'0')}-${String(date.getDate()).padStart(2,'0')} ${String(date.getHours()).padStart(2,'0')}:${String(date.getMinutes()).padStart(2,'0')}`,
     `tags: [${tags.map(t => '"'+t+'"').join(', ')}]`,
     `notebook: ${book}`,
     '---',
@@ -46,4 +46,4 @@ hexo.extend.console.register('new-note', 'Create a new note', {
   fs.writeFileSync(filePath, frontMatter);
   console.log(`Created: ${filePath}`);
   callback();
-}); 
+}); 

package/scripts/helpers/category_tree.js

@@ -0,0 +1,11 @@
+/* global hexo */
+'use strict';
+
+const { buildCategoryTree } = require('../lib/category_tree');
+
+hexo.extend.helper.register('category_tree', function(categories) {
+  const list = categories && typeof categories.toArray === 'function'
+    ? categories.toArray()
+    : (categories || []);
+  return buildCategoryTree(list);
+});

package/scripts/helpers/json_ld.js

@@ -98,6 +98,11 @@ hexo.extend.helper.register('json_ld', function(args) {
 
       if (page.excerpt || page.description) {
         schema.description = this.strip_html(page.description || page.excerpt);
+      } else if (page.wiki) {
+        const proj = this.theme.wiki.tree[page.wiki];
+        if (proj && proj.description) {
+          schema.description = proj.description;
+        }
       } else {
         schema.description = util.truncate(this.strip_html(page.content), {length: 200});
       }

package/scripts/helpers/mdrender.js

@@ -0,0 +1,29 @@
+/* global hexo */
+'use strict';
+
+const { mdrenderHtml, PLACEHOLDER_CLASS } = require('../lib/mdrender_html');
+const { wikiReadmeHtml, isWikiReadmePage } = require('../lib/wiki_readme');
+
+// 远程 Markdown 渲染占位标记（底层组件服务端入口，供 EJS 模板复用）
+hexo.extend.helper.register('mdrender_html', function (src, options = {}) {
+  if (options.ghraw == null) {
+    options.ghraw = hexo.theme.config.api_host.ghraw;
+  }
+  return mdrenderHtml(src, options);
+});
+
+// wiki 项目 README 主页占位（首页正文为空且配置 repo 时输出，否则空串）
+hexo.extend.helper.register('wiki_readme_html', function (proj, page) {
+  return wikiReadmeHtml(proj, page, { ghraw: hexo.theme.config.api_host.ghraw });
+});
+
+// 页面是否包含客户端渲染的远程 md（供 TOC 预留空容器）
+hexo.extend.helper.register('has_remote_md', function (page) {
+  if (!page) {
+    return false;
+  }
+  if (page.content && page.content.indexOf(PLACEHOLDER_CLASS) >= 0) {
+    return true;
+  }
+  return isWikiReadmePage(hexo.theme.config.wiki.tree[page.wiki], page);
+});

package/scripts/helpers/reading_time.js

@@ -0,0 +1,12 @@
+/* global hexo */
+'use strict';
+
+const { countWords, readingMinutes } = require('../lib/reading_time');
+
+hexo.extend.helper.register('word_count', function(page) {
+  return countWords(page && (page.content || page._content || ''));
+});
+
+hexo.extend.helper.register('reading_time', function(page) {
+  return readingMinutes(page && (page.content || page._content || ''));
+});

package/scripts/lib/category_tree.js

@@ -0,0 +1,26 @@
+'use strict';
+
+// 分类嵌套树构建（#564）：基于 parent 关系递归组装，兼容 2/3/4 级
+function buildCategoryTree(list) {
+  const items = (list || []).map(c => ({
+    _id: c._id,
+    name: c.name,
+    path: c.path,
+    parentId: c.parent ? (typeof c.parent === 'object' ? c.parent._id : c.parent) : null,
+    count: (c.posts && c.posts.length) || 0,
+    children: []
+  }));
+  const byId = {};
+  items.forEach(item => { byId[item._id] = item; });
+  const roots = [];
+  items.forEach(item => {
+    if (item.parentId != null && byId[item.parentId]) {
+      byId[item.parentId].children.push(item);
+    } else {
+      roots.push(item);
+    }
+  });
+  return roots;
+}
+
+module.exports = { buildCategoryTree };

package/scripts/lib/mdrender_html.js

@@ -0,0 +1,97 @@
+/**
+ * mdrender_html.js v2 | https://github.com/xaoxuu/hexo-theme-stellar/
+ *
+ * 远程 Markdown 渲染底层组件（通用能力，不包含应用场景逻辑）：
+ * 统一生成 .data-service.ds-mdrender 占位标记。
+ *
+ * 行为：
+ * - src 为 GitHub raw 类地址时，host 替换为调用方传入的 ghraw
+ *   （主题配置 api_host.ghraw，代码不设默认值）；未传 ghraw 时保留 src 原 host；
+ * - 识别后输出 data-base（该 md 所在 raw 目录）；
+ * - 非 GitHub src 原样输出、不带 data-base；
+ * - replace=true 输出 data-replace（客户端原地替换，无外部容器）；
+ * - heading 缺省 true，输出 data-heading（客户端标题适配本地文章格式）。
+ */
+
+'use strict';
+
+// GitHub raw 规范 host：用于识别用户 src 中的规范 raw 地址（GitHub 固有事实，非配置默认值）
+const GITHUB_RAW_HOST = 'raw.githubusercontent.com';
+
+// 占位标记类名（组件契约：服务端生成、services 按需加载、客户端渲染共用）
+const PLACEHOLDER_CLASS = 'ds-mdrender';
+
+/**
+ * 解析 GitHub raw 地址（规范 raw host 或调用方传入的 ghraw 镜像 host）。
+ * 返回 { host, owner, repo, ref, rest }；无法识别时返回 null。
+ */
+function parseGitHubRaw(url, ghrawHost) {
+  if (typeof url !== 'string' || url.length === 0) {
+    return null;
+  }
+  let u;
+  try {
+    u = new URL(url);
+  } catch (e) {
+    return null;
+  }
+  const host = u.hostname || '';
+  if (host !== GITHUB_RAW_HOST && host !== ghrawHost) {
+    return null;
+  }
+  const segs = u.pathname.split('/').filter(s => s.length > 0);
+  if (segs.length < 3) {
+    return null;
+  }
+  return {
+    host: host,
+    owner: segs[0],
+    repo: segs[1],
+    ref: segs[2],
+    rest: segs.slice(3).join('/')
+  };
+}
+
+function escapeAttr(value) {
+  return String(value).replace(/&/g, '&amp;').replace(/"/g, '&quot;');
+}
+
+/**
+ * 生成远程 Markdown 渲染占位标记。
+ * options: { id, replace, heading, ghraw }
+ */
+function mdrenderHtml(src, options = {}) {
+  const parsed = parseGitHubRaw(src, options.ghraw);
+  let url = src;
+  let base = null;
+  if (parsed) {
+    // 未传 ghraw 时保留 src 原 host，不硬编码默认值
+    const ghraw = options.ghraw || parsed.host;
+    const dir = `${parsed.owner}/${parsed.repo}/${parsed.ref}/`;
+    url = `https://${ghraw}/${dir}${parsed.rest}`;
+    base = `https://${ghraw}/${dir}`;
+  }
+  let el = '<div class="data-service ds-mdrender"';
+  el += ` src="${escapeAttr(url)}"`;
+  if (base) {
+    el += ` data-base="${escapeAttr(base)}"`;
+  }
+  if (options.replace === true) {
+    el += ' data-replace="true"';
+  }
+  if (options.heading !== false) {
+    el += ' data-heading="true"';
+  }
+  if (options.id) {
+    el += ` id="${escapeAttr(options.id)}"`;
+  }
+  el += '></div>';
+  return el;
+}
+
+module.exports = {
+  GITHUB_RAW_HOST,
+  PLACEHOLDER_CLASS,
+  parseGitHubRaw,
+  mdrenderHtml
+};

package/scripts/lib/reading_time.js

@@ -0,0 +1,16 @@
+'use strict';
+
+// 阅读信息统计（#302）：中文字符按 1 字计，英文/数字按空格分词计词
+function countWords(content) {
+  const text = String(content || '').replace(/<[^>]*>/g, ' ');
+  const cjk = (text.match(/[\u4e00-\u9fff]/g) || []).length;
+  const latin = (text.replace(/[\u4e00-\u9fff]/g, ' ').match(/[A-Za-z0-9]+(?:[-'][A-Za-z0-9]+)*/g) || []).length;
+  return cjk + latin;
+}
+
+// 混合阅读速度约 300 字/分钟，最少 1 分钟
+function readingMinutes(content, speed = 300) {
+  return Math.max(1, Math.ceil(countWords(content) / speed));
+}
+
+module.exports = { countWords, readingMinutes };

package/scripts/lib/wiki_readme.js

@@ -0,0 +1,57 @@
+/**
+ * wiki_readme.js v1 | https://github.com/xaoxuu/hexo-theme-stellar/
+ *
+ * Wiki 应用层：项目首页正文为空（剪裁空白后）且配置 repo 时，
+ * 以该仓库 README.md 作为主页正文（复用底层远程 md 渲染组件）。
+ */
+
+'use strict';
+
+const { mdrenderHtml } = require('./mdrender_html');
+
+/**
+ * README 地址。host 由调用方从主题配置 api_host.ghraw 传入；
+ * branch 缺省用 GitHub HEAD（自动指向默认分支）。
+ */
+function readmeUrl(repo, branch, host) {
+  return `https://${host}/${repo}/${branch || 'HEAD'}/README.md`;
+}
+
+// 页面正文是否为空（剪裁多余空行、空格后判断）
+function isEmptyContent(page) {
+  return !page || !String(page.content || '').trim();
+}
+
+/**
+ * 判定是否 README 主页：配置了 repo 的项目首页且正文为空。
+ */
+function isWikiReadmePage(proj, page) {
+  if (!proj || !proj.repo || !page || !proj.homepage) {
+    return false;
+  }
+  if (!isEmptyContent(page)) {
+    return false;
+  }
+  return proj.homepage.path === page.path;
+}
+
+/**
+ * 生成 README 主页占位（原地替换模式）；不适用时返回空串。
+ * options: { ghraw }
+ */
+function wikiReadmeHtml(proj, page, options = {}) {
+  if (!isWikiReadmePage(proj, page)) {
+    return '';
+  }
+  return mdrenderHtml(readmeUrl(proj.repo, proj.branch, options.ghraw), {
+    ghraw: options.ghraw,
+    replace: true
+  });
+}
+
+module.exports = {
+  readmeUrl,
+  isEmptyContent,
+  isWikiReadmePage,
+  wikiReadmeHtml
+};

package/scripts/tags/index.js

@@ -48,6 +48,8 @@ hexo.extend.tag.register('audio', require('./lib/audio')(hexo))
 hexo.extend.tag.register('video', require('./lib/video')(hexo))
 hexo.extend.tag.register('rating', require('./lib/rating')(hexo))
 hexo.extend.tag.register('vote', require('./lib/vote')(hexo))
+hexo.extend.tag.register('table', require('./lib/table')(hexo), {ends: true})
+hexo.extend.tag.register('tip', require('./lib/tip')(hexo), {ends: true})
 
 // read 阅读类
 hexo.extend.tag.register('reel', require('./lib/read/reel')(hexo), true)

package/scripts/tags/lib/md.js

@@ -1,20 +1,28 @@
 /**
- * md.js v1.0 | https://github.com/volantis-x/hexo-theme-volantis/
- * contributor: @MHuiG
- * 
+ * md.js v2 | https://github.com/xaoxuu/hexo-theme-stellar/
+ *
  * 格式与官方标签插件一致使用空格分隔，中括号内的是可选参数（中括号不需要写出来）
  *
- * {% md src %}
+ * {% md src [wrap:true|false] %}
+ *
+ * wrap 默认 true：渲染结果保留在 .data-service.ds-mdrender 容器内（现状）；
+ * wrap:false：渲染后占位元素被原地替换，无外部容器（复用底层 data-replace）。
  *
+ * 复用底层组件（scripts/lib/mdrender_html.js）输出渲染占位；
+ * 容器结构与现状一致，标题默认适配本地文章格式（id + headerlink，h1 隐藏）。
  */
 'use strict'
 
+const { mdrenderHtml } = require('../../lib/mdrender_html')
+
 var md_index = 0
 
 module.exports = ctx => function(args) {
-  args = ctx.args.map(args, [''], ['src'])
+  args = ctx.args.map(args, ['wrap'], ['src'])
   const md_id = "md_" + ++md_index
-  return `
-  <div class="data-service ds-mdrender" src="${args.src}" id="${md_id}"></div>
-  `
-}
+  return mdrenderHtml(args.src, {
+    id: md_id,
+    ghraw: ctx.theme.config.api_host.ghraw,
+    replace: args.wrap === 'false'
+  })
+}