feat: custom pages support

README.md

@@ -191,6 +191,26 @@ This command also has a dry run mode, which can be useful for initial setup and
 rdme changelogs:single path-to-markdown-file
 ```
 
+### Custom Pages
+
+#### Syncing a Folder of Custom Pages to ReadMe
+
+Custom Pages has support for both Markdown and HTML files. These files will require YAML front matter with certain ReadMe documentation attributes. Check out [our docs](https://docs.readme.com/docs/rdme#markdown-file-setup) for more info on setting up your front matter.
+
+Passing in a path to a directory will also sync any HTML/Markdown files that are located in subdirectories.
+
+```sh
+rdme custompages path-to-markdown-files
+```
+
+This command also has a dry run mode, which can be useful for initial setup and debugging. You can read more about dry run mode [in our docs](https://docs.readme.com/docs/rdme#dry-run-mode).
+
+#### Syncing a Single Custom Page to ReadMe
+
+```sh
+rdme custompages:single path-to-markdown-file
+```
+
 ### Versions
 
 #### Get All Versions Associated With Your Project

__tests__/__fixtures__/custompages/existing-docs/simple-doc.md

@@ -0,0 +1,4 @@
+---
+title: This is the custom page title
+---
+Body

__tests__/__fixtures__/custompages/existing-docs/subdir/another-doc.md

@@ -0,0 +1,4 @@
+---
+title: This is another custom page title
+---
+Another body

__tests__/__fixtures__/custompages/failure-docs/fail-doc.md

@@ -0,0 +1 @@
+Body

__tests__/__fixtures__/custompages/failure-docs/new-doc.md

@@ -0,0 +1,6 @@
+---
+htmlmode: true
+title: This is the custom page title
+---
+
+Body

__tests__/__fixtures__/custompages/new-docs-html/new-doc.html

@@ -0,0 +1,5 @@
+---
+hidden: false
+---
+
+<div></div>

__tests__/__fixtures__/custompages/new-docs/new-doc.md

@@ -0,0 +1,6 @@
+---
+htmlmode: true
+title: This is the custom page title
+---
+
+Body

__tests__/__fixtures__/custompages/slug-docs/new-doc-slug.md

@@ -0,0 +1,7 @@
+---
+htmlmode: true
+title: This is the custom page title
+slug: marc-actually-wrote-a-test
+---
+
+Body