表現.md

0.14.0

インストール

npm install @b4moss/hyogen-md

Node.js >= 24 が必要です。

次のエントリを提供します。

エントリ用途
@b4moss/hyogen-mdNode — SSR / SSG / loader / build
@b4moss/hyogen-md/clientブラウザ — renderClient
@b4moss/hyogen-md/configCLI 設定 — defineConfig
hyogen-md（bin）CLI — create / dev / build

クイックスタート（CLI）

npx hyogen-md create my-site
cd my-site
npm install
npm run dev    # http://127.0.0.1:4173
npm run build  # Markdown を ./out へ

詳細は CLI を参照してください。

クイックスタート（サーバー）

SSR や Node 上でのレンダリングには renderServer を使います。loader を省略すると、ファイルシステムとリモート URL を読み込むデフォルト loader が使われます。

import { renderServer } from '@b4moss/hyogen-md'

const result = await renderServer('# Hello {{ name }}', {
  name: 'world',
})

console.log(result.markdown)
// # Hello world

ファイルパスを指定する場合:

import { renderServer, createNodeLoader } from '@b4moss/hyogen-md'

const result = await renderServer(
  { path: './pages/index.md' },
  { title: 'Hello' },
  { loader: createNodeLoader() },
)

クイックスタート（クライアント）

ブラウザでは @b4moss/hyogen-md/client から renderClient を import します。loader は必須です。

import { renderClient } from '@b4moss/hyogen-md/client'

const result = await renderClient(
  { path: '/src/index.md' },
  { siteName: 'Demo' },
  {
    loader: async (path) => {
      // 仮想 FS や fetch など、呼び出し側で実装
      return await readSomewhere(path)
    },
  },
)

クイックスタート（SSG）

複数ファイルを一括でレンダリングするには build を使います。

import { build } from '@b4moss/hyogen-md'

const { files, warnings } = await build({
  input: './src/**/*.md',
  outDir: './out',
  context: { siteName: 'Demo' },
})

次のステップ