标签:文件 Markdown 渲染 静态 代码 md code include
1. 前言
在 GitHub 上写文档,很多时候要插入 uml,像 mermaid 这种可以直接在 GitHub/GitLab 中渲染的一般直接写个 code block 进去,但是这样造成一个问题就是如果要放在多个文档中则必须复制多份。于是有个想法油然而生,用注释提供一种静态渲染的方式将代码、uml 这种在 Commit 之前渲染到 Markdown 上,并可以进行更新。于是 ps-md-include 应运而生。
2. 系统需求
PowerShell 6 或更高版本
3. 用法
- 在文件中插入
md_include
文件块
# test
<!-- #md_include "Program.cs" from 1 to 3 as code lang csharp -->
<!-- #md_include end -->
- 在文件根目录运行 Sync-MarkdownInclude.ps1
- 然后 C# 文件就被渲染进去了
# test
<!-- #md_include "Program.cs" from 1 to 3 as code lang csharp -->
```csharp
using System;
using System.Linq;
```
<!-- #md_include end -->
3. 参数
<!-- #md_include "<file path>"[ from <number>[ to <number>]][ as <type>][ lang <lang>] --><!-- #md_include end -->
- "
":要包含的文件相对路径 - [ from
]:从第几行开始读取(默认第一行,非必须填写) - [ to
]:读到第几行(默认文件的最后一行,非必须填写,需要跟在 from
后面) - [ as
]:渲染类型,具有 raw
(文本,直接打印文本)、code
(代码,会渲染代码块)两种格式(默认raw
,非必须填写) - [ lang
]:代码块的文件类型(默认是 null,非必须填写,需要跟在 as code
后面)
4. 代码
https://github.com/SofiaXu/ps-md-include
标签:文件,Markdown,渲染,静态,代码,md,code,include 来源: https://www.cnblogs.com/aobaxu/p/16600832.html
本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享; 2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关; 3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关; 4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除; 5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。