在使用 MD 進行文檔開發的時候,用的最多就是頁面共用。
docsify 已經提供了這個功能,你不僅僅可以嵌入 md 文件,你還可以嵌入一些不同的文件類型。
嵌入方式
可以使用下面的方式進行嵌入。
[filename](_media/example.md ':include')
在鏈接到 md 文件後,在文件的後端添加參數:’:include’ 就可以了。
需要注意的是 :include 需要單引號來進行包裹。
可以嵌入的文件類型
在當前情況下,一些特定的擴展文件名可以被自動識別,並自動使用類類型。
可以支持的嵌入類型爲:
- iframe
.html
,.htm
- markdown
.markdown
,.md
- audio
.mp3
- video
.mp4
,.ogg
- code 其他文件類型
當然,你也是可以強制指定嵌入文件的類型的。
例如下面的代碼:
[filename](_media/example.md ':include :type=code')
在執行後,將會得到下面的內容:
> This is from the `example.md`
這是因爲在上面的嵌入方式中,我們強制指定 example.md 的類型爲 代碼了。
如果不強制指定類似的話,docsify 將會自動將 example.md 中的內容合併到當前頁面中。
例如在代碼中使用的上面的代碼,就可以完成嵌入了。