hexo-next 使用hexo-renderer-markdown-it

為了讓jupyternote轉換後的markdown可以在部落格使用
目前hexo的markdown引擎已經換成了hexo-renderer-markdown-it

之前使用jupyternote轉成markdown後的文章

之前的文章並沒有寫的很清楚，這次來完整紀錄一下

hexo-renderer-markdown-it

安裝

首先，先把hexo本身的markdown引擎卸載
npm un hexo-renderer-marked --save
安裝hexo-renderer-markdonw-it
npm i hexo-renderer-markdown-it --save

設定

詳細的設定可以依照文檔
把這個設置放在站點配置文件中

目前我有使用數據文件的方法統合配置文件，但是我還是要在站點的_config.yml更改才有效，在統合後的/_data/next.yml 中更改並沒辦法生效，暫時還不知道為什麼

markdown:
  markdown: 'default'
  render:
    html: true       #顯示html語法內容
    xhtmlOut: false  #Parser (not) produces fully XHTML compliant code
    breaks: true    #覺得蠻有用的，在原本撰寫markdown時只要有break line符號，就會在最後產生結果時幫你加入<br>換行
    linkify: true   #只要有像網址的詞出現，就會在結果顯示時幫你把網址轉換成超連結
    typographer: true   #圖像符號的顯示  例如©
    quotes: '“”‘’'

    plugins:    
        - markdown-it-footnote   #註腳
        - markdown-it-abbr    #可以做標註縮寫
        #以下啟用套件 需另外下載
        #+ markdown-it-abbr   
        #+ markdown-it-checkbox   
        #+ markdown-it-emoji    #表情符號
        #+ markdown-it-footnote
        #+ markdown-it-ins      
        #+ markdown-it-sub      
        #+ markdown-it-sup
    
    anchors:
    # Minimum level for ID creation. (Ex. h2 to h6)
    level: 2
    # A suffix that is prepended to the number given if the ID is repeated.
    collisionSuffix: 'v'           
    # If `true`, creates an anchor tag with a permalink besides the heading.
    permalink: false              
    # Class used for the permalink anchor tag.
    permalinkClass: header-anchor 
    # The symbol used to make the permalink
    permalinkSymbol: ¶    #如果permalink為true， next文章目錄的章節前面都會加一個這樣的符號

有三種markdown引擎

Zero
Default (GFM)
CommonMark

可以不寫markdown: ‘default’ 就會預設成為Default (GFM)

plugin

plugin效果可以去marked-it demo

目前只有使用兩個plugin

插件使用範例

範例取至marked-it demo

markdonw-it-footnote

1
2
3

This is HTML abbreviation example.
It converts "HTML", but keep intact partial entries like "xxxHTMLyyy" and so on.
*[HTML]: Hyper Text Markup Language

This is HTML abbreviation example.
It converts “HTML”, but keep intact partial entries like “xxxHTMLyyy” and so on.

markdown-it-footnote

Footnote 1 link[^first].

Footnote 2 link[^second].

Inline footnote^[Text of inline footnote] definition.

Duplicated footnote reference[^second].

[^first]: Footnote **can have markup**

    and multiple paragraphs.

[^second]: Footnote text.

Footnote 1 link^[1].

Footnote 2 link^[2].

Inline footnote^[3] definition.

Duplicated footnote reference^[2].

備註

好像不用裝checkbox 也有功能
只是有一些參數並不能用

1 2	- [x] test1 - [ ] test2

[x] test1
[ ] test2

Reference

hexo-renderer-markdown-it
文檔
 marked-it demo

本文地址： https://david6686.github.io/blog/silentink/13325/

Footnote can have markup
and multiple paragraphs. ↩
Footnote text. ↩ ↩
Text of inline footnote ↩