mirror-kt / zenn-editor

Convert markdown to html in Zenn format

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Zenn Editor

利用方法

ご自身のWebサイトで使う場合

1. zenn-markdown-html によりMarkdownをHTMLに変換する

import markdownHtml from 'zenn-markdown-html';

以下のようにMarkdownをHTMLに変換します。この処理は、Node.jsでのみ実行できます。ブラウザで実行するとエラーになることにご注意ください。

const html = markdownHtml(markdown);

取得したHTMLを埋め込み親要素のクラス名にはzncという文字列を指定する必要があります。これは後述のCSSを適用するために必要です。

// Reactの場合
<div
  // "znc"というクラス名を指定する
  className="znc"
  // htmlを渡す
  dangerouslySetInnerHTML={{
    __html: html
  }}
/>

2. CSSを読み込む

import 'zenn-content-css';

3. 埋め込みコンテンツを有効にするためscriptを読み込む

以下のスクリプトを読み込むことで、TweetやMermaidなどの埋め込み記法が使用できるようになります。

<script src="https://embed.zenn.studio/js/listen-embed-event.js" ></script>

このスクリプトは<head>タグ内で読み込みます。また、defer属性やasync属性を指定するとSPA等でのページ遷移時に正しく埋め込みが行われない可能性があることにご注意ください。

(KaTeX記法を使う場合のみ)zenn-embed-elementsを読み込む

zenn-embed-elementsはSSRに対応していないため、クライアント側で読み込む必要があります。

// React で使う場合の例
import 'zenn-content-css';

export default function App(props) {

  useEffect(()=> {
    import("zenn-embed-elements")
  },[])

  return (
    <div 
      className="znc"
      dangerouslySetInnerHTML={{
        __html: props.html // markdownから変換されたHTMLを渡す
      }}
    />
  )
}

Licence

MIT

About

Convert markdown to html in Zenn format


Languages

Language:TypeScript 90.0%Language:HTML 4.8%Language:SCSS 3.7%Language:JavaScript 1.1%Language:CSS 0.5%