diff --git a/semantic_conventions/.yardopts b/semantic_conventions/.yardopts
index fd17675afe..9f334b2d10 100644
--- a/semantic_conventions/.yardopts
+++ b/semantic_conventions/.yardopts
@@ -1,6 +1,7 @@
 --no-private
 --title=OpenTelemetry Semantic Conventions
 --markup=markdown
+--markup-provider=kramdown
 --main=README.md
 ./lib/opentelemetry/**/*.rb
 -
diff --git a/semantic_conventions/opentelemetry-semantic_conventions.gemspec b/semantic_conventions/opentelemetry-semantic_conventions.gemspec
index e09b108c86..1d642e75f8 100644
--- a/semantic_conventions/opentelemetry-semantic_conventions.gemspec
+++ b/semantic_conventions/opentelemetry-semantic_conventions.gemspec
@@ -30,6 +30,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'bundler', '>= 1.17'
   spec.add_development_dependency 'minitest', '~> 5.0'
   spec.add_development_dependency 'rake', '~> 12.0'
+  spec.add_development_dependency 'kramdown', '~> 2.3'
   spec.add_development_dependency 'rubocop', '~> 1.3'
   spec.add_development_dependency 'simplecov', '~> 0.17'
   spec.add_development_dependency 'yard', '~> 0.9'