first commit; migrate code from minimal/docs-server

src/render.ts

@@ -0,0 +1,68 @@
+
+import { marked } from 'marked';
+import { create_renderer } from './renderer';
+import { mark_ext } from './mark';
+import { section_ext } from './section';
+import { icon_ext } from './icon';
+import { sanitize_html } from './html-sanitize';
+import { katex_block_ext, katex_inline_ext } from './katex';
+import { footnote_list_ext, footnote_ref_ext } from './footnotes';
+import { description_list_ext } from './description-list';
+import { resolve_async_bindings } from './async-steps';
+
+export interface MarkdownOptions {
+	base_url?: string;
+	breaks?: boolean;
+	inline?: boolean;
+	katex_macros?: Record<string, string>;
+	extensions?: MarkdownExtension[];
+}
+
+export interface MarkdownExtension {
+	(renderer: marked.Renderer, opts: MarkdownOptions): marked.TokenizerExtension & marked.RendererExtension
+}
+
+export async function render_markdown_to_html(markdown: string, options: MarkdownOptions = { }) {
+	const marked_options: marked.MarkedOptions = {
+		baseUrl: options.base_url,
+		breaks: options.breaks || false,
+		renderer: create_renderer(options),
+	};
+
+	marked.use({
+		extensions: [
+			katex_block_ext(marked_options.renderer, options),
+			katex_inline_ext(marked_options.renderer, options),
+			footnote_ref_ext(marked_options.renderer, options),
+			footnote_list_ext(marked_options.renderer, options),
+			mark_ext(marked_options.renderer, options),
+			description_list_ext(marked_options.renderer, options),
+			section_ext(marked_options.renderer, options),
+			icon_ext(marked_options.renderer, options),
+			...(options.extensions || [ ]).map((ext) => {
+				return ext(marked_options.renderer, options);
+			}),
+		],
+		tokenizer: {
+			url(src) {
+				// disable auto-linking; more can be added here to auto-link only sometimes
+				// see: https://github.com/markedjs/marked/issues/882#issuecomment-781628889
+				return null;
+			}
+		},
+	});
+	
+	const unsafe_html = options.inline
+		? marked.parseInline(markdown, marked_options)
+		: await new Promise<string>((resolve, reject) => {
+			marked.parse(markdown, marked_options, (error, unsafe_html) => {
+				if (error) {
+					return reject(error);
+				}
+
+				resolve_async_bindings(unsafe_html).then(resolve, reject);
+			});
+		});
+
+	return sanitize_html(unsafe_html);
+}