aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichael Williamson <mike@zwobble.org>2026-05-24 10:48:10 +0100
committerMichael Williamson <mike@zwobble.org>2026-05-24 10:48:10 +0100
commit9e5bf4ce013d0e9fd25bcb446969d230af205045 (patch)
treed2bbe6eb26025e1eb15c482dc43dfce7c095876e
parent9adfa3431feb6d8b52b49f491aeb923a76459786 (diff)
Add note on performance
-rw-r--r--README.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/README.md b/README.md
index 7f40941..0455230 100644
--- a/README.md
+++ b/README.md
@@ -329,6 +329,13 @@ For instance:
To enable access when converting trusted source documents,
call `EnableExternalFileAccess()`.
+* The conversion may exhibit pathological performance on certain documents:
+ it's likely possible to craft a source document that causes high CPU or memory usage.
+ Depending on the performance constraints of your application and the likelihood of receiving untrusted input,
+ you may wish to consider isolating any calls to Mammoth,
+ such as running Mammoth in a separate thread with a timeout,
+ to prevent denial-of-service attacks.
+
## Writing style maps
A style map is made up of a number of style mappings separated by new lines.