diff --git a/doc/README.md b/doc/README.md
index 751e685b19b..d28ad499d3a 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -9,7 +9,7 @@
 - [GitLab Basics](gitlab-basics/README.md) Find step by step how to start working on your commandline and on GitLab.
 - [Importing to GitLab](workflow/importing/README.md).
 - [Importing and exporting projects between instances](user/project/settings/import_export.md).
-- [Markdown](user/project/markdown.md) GitLab's advanced formatting system.
+- [Markdown](user/markdown.md) GitLab's advanced formatting system.
 - [Migrating from SVN](workflow/importing/migrating_from_svn.md) Convert a SVN repository to Git and GitLab.
 - [Permissions](user/permissions.md) Learn what each role in a project (external/guest/reporter/developer/master/owner) can do.
 - [Profile Settings](profile/README.md)
diff --git a/doc/markdown/markdown.md b/doc/markdown/markdown.md
new file mode 100644
index 00000000000..4ac81ab3ee7
--- /dev/null
+++ b/doc/markdown/markdown.md
@@ -0,0 +1 @@
+This document was moved to [user/markdown.md](../user/markdown.md).
diff --git a/doc/user/project/img/markdown_logo.png b/doc/user/img/markdown_logo.png
similarity index 100%
rename from doc/user/project/img/markdown_logo.png
rename to doc/user/img/markdown_logo.png
diff --git a/doc/user/project/img/markdown_video.mp4 b/doc/user/img/markdown_video.mp4
similarity index 100%
rename from doc/user/project/img/markdown_video.mp4
rename to doc/user/img/markdown_video.mp4
diff --git a/doc/user/project/markdown.md b/doc/user/markdown.md
similarity index 100%
rename from doc/user/project/markdown.md
rename to doc/user/markdown.md