我正在尝试在 Markdown 中为 R 包编写文档,并将其转换为 Rd 文件。
我想另一种看待这个问题的方式是,我想要一个能够识别各种降价结构并允许我指定如何呈现这些结构的框架,例如:
`text in backticks`
转换为\code{text in backticks}
**text**
被转换为\bold{text}
- 降价列表转换为
\itemize{...}
等等。
有什么可以让我这样做吗?R 中的pander
包(环绕 pandoc)看起来很有希望,但我不确定我是否可以指定转换规则(例如,它使用\texttt
and I want转换反引号\code
),它还生成一个完整的独立文档,而不仅仅是我的输入片段转换。
R的markdown
包似乎只是做 markdown -> HTML。看起来它可能支持自定义渲染器,但我不确定如何编写(看起来我必须编写 C 代码?)
我追求的是这样的:
convertMarkdown(myTextSnippet,
backticks = function (txt) {
return(paste0('\\code{', txt, '}'))
},
bold = function(txt) {
return(paste0('\\bold{', txt, '}'))
},
unordered.list = function (items) {
itms <- paste('\\item', items, collapse='\n')
return(paste('\\itemize{', itms, '}', sep='\n'))
},
# ... and so on
)
这样的事情存在吗?
(奖励:我只是希望能够在我的roxygen
评论中嵌入 markdown,因此正在考虑将部分评论从 markdown 转换为 rd,然后在输出上运行 roxygen)。