1 files changed, 28 insertions, 0 deletions
diff --git a/README.md b/README.md
index a35cd04..fc08977 100644
--- a/README.md
+++ b/README.md
@@ -27,6 +27,34 @@
 Use `make` to build a minimal test application, and `make test` to run
 the test suite.
 
+## Examples
+
+```c
+// sha3-256-example: print sha3-256 hash of data to standard output.
+#include <stdint.h>
+#include <stdio.h>
+#include "hex.h"
+#include "sha3.h"
+
+// test data
+static const uint8_t DATA[] = "this is some test data";
+
+int main() {
+  // hash data
+  uint8_t buf[32] = { 0 };
+  sha3_256(DATA, sizeof(DATA), buf);
+
+  // print result to stdout
+  printf("SHA3-256: ");
+  hex_write(stdout, buf, sizeof(buf));
+  printf("\n");
+
+  return 0;
+}
+```
+
+See the `examples/` directory for more examples.
+
 ## References
 
 * [FIPS 202 - SHA-3 Standard: Permutation-Based Hash and Extendable-Output Functions][FIPS 202]