73 lines
1.8 KiB
Markdown
73 lines
1.8 KiB
Markdown
#api/syscall
|
|
|
|
The Markdown API provides functions for parsing and rendering Markdown content.
|
|
|
|
## Markdown Operations
|
|
### markdown.parseMarkdown(text)
|
|
Parses a piece of markdown text into a ParseTree.
|
|
|
|
Example:
|
|
```lua
|
|
local text = [[
|
|
# Hello World
|
|
|
|
This is a **bold** statement.
|
|
]]
|
|
|
|
local tree = markdown.parseMarkdown(text)
|
|
print("Parsed markdown tree:", tree)
|
|
```
|
|
|
|
### markdown.renderParseTree(tree)
|
|
Renders a ParseTree back to markdown text.
|
|
|
|
Example:
|
|
```lua
|
|
local text = "# Title\n\nSome text"
|
|
local tree = markdown.parseMarkdown(text)
|
|
-- Modify tree if needed
|
|
local rendered = markdown.renderParseTree(tree)
|
|
print("Rendered markdown:", rendered)
|
|
```
|
|
|
|
### markdown.markdownToHtml(text)
|
|
Renders a piece of markdown text into HTML
|
|
|
|
Example:
|
|
```lua
|
|
local text = "# Title\n\nSome text"
|
|
local html = markdown.markdownToHtml(text)
|
|
print("Rendered html:", html)
|
|
```
|
|
|
|
### markdown.expandMarkdown(textOrTree, options?)
|
|
Expands custom markdown Lua directives and transclusions into plain markdown. Accepts either a markdown ParseTree or string.
|
|
|
|
Options (all default to `true`):
|
|
* `expandTransclusions`: Replace (markdown transclusions) with their content
|
|
* `expandLuaDirectives`: Replace Lua directives with their evaluated values
|
|
* `rewriteTasks`: Rewrite tasks to include references so that they can be updated
|
|
|
|
Example:
|
|
```lua
|
|
local text = "This is a some lua ${os.time()}"
|
|
print("Expanded markdown:", markdown.expandMarkdown(text))
|
|
```
|
|
|
|
### markdown.objectsToTable(data, options?)
|
|
Transforms a list of tables into a markdown table.
|
|
|
|
Supported options:
|
|
* `renderCell(val, key)` custom cell renderer
|
|
|
|
Example:
|
|
${markdown.objectsToTable({{name="Pete", age=20}, {name="Jane", age=32}}, {
|
|
renderCell=function(v, k)
|
|
if k == "age" and v > 20 then
|
|
return "*" .. v .. "*"
|
|
else
|
|
return v
|
|
end
|
|
end})}
|
|
|