1 files changed, 27 insertions, 0 deletions
diff --git a/examples/borders_example.md b/examples/borders_example.md
new file mode 100644
index 00000000..d637681c
--- /dev/null
+++ b/examples/borders_example.md
@@ -0,0 +1,27 @@
+## Description
+
+Axlsx defines a thin border style, but you can easily create and use your own.
+
+## Code
+
+```ruby
+require 'axlsx'
+
+p = Axlsx::Package.new
+wb = p.workbook
+
+s = wb.styles
+red_border = s.add_style border: { style: :thick, color: 'FFFF0000', edges: [:left, :right] }
+blue_border = s.add_style border: { style: :thick, color: 'FF0000FF' }
+
+wb.add_worksheet(name: 'Custom Borders') do |sheet|
+  sheet.add_row ['wrap', 'me', 'up in red'], style: red_border
+  sheet.add_row [1, 2, 3], style: blue_border
+end
+
+p.serialize 'borders_example.xlsx'
+```
+
+## Output
+
+![Output](images/borders_example.png "Output")