Separate single format example in its own file

examples/example-04-render-no-publish.md

@@ -0,0 +1,8 @@
+# Quarto Actions: Render without publishing
+
+If you need to render your project in a GitHub Action, but will use the output for something besides publishing (or publishing to a service not supported by `quarto publish`), then instead of `publish`, use the `render` action:
+
+```yaml
+- name: Render Quarto Project
+  uses: quarto-dev/quarto-actions/render@v2
+```

examples/example-05-non-top-level.md

@@ -1,4 +1,4 @@
-# Using Quarto Actions: non-top-level projects
+# Quarto Actions: non-top-level projects
 
 It's possible to have a quarto project in a large GitHub repository, where the quarto project does not reside at the top-level directory. In this case, add a `path` input to the invocation of the `render` or `publish` action. For example:
 

examples/example-06-no-render.md

@@ -1,4 +1,4 @@
-## Publishing without rendering
+# Quarto Actions: Publishing without rendering
 
 By default, the `quarto-actions/publish@v2` action will re-render your entire project before publishing.
 However, if you store the rendered project in version control, you don't need
@@ -12,23 +12,3 @@ to the `publish` action:
     target: gh-pages
     render: false
 ```
-
-## Rendering a single format
-
-The `render: false` choice is all-or-nothing. If you need to customize the rendering step, e.g. only render one format in CI before publishing, use a two step process: 
-
-* use the `quarto-actions/render@v2` action and provide a target output format (in this example YAML configuration, we use the HTML format)
-* use the `quarto-actions/publish@v2` action with `render: false` to skip rendering before publishing (in this example YAML configuration, we publish to GitHub Pages)
-
-```yaml
-- name: Render Book project
-  uses: quarto-dev/quarto-actions/render@v2
-  with:
-    to: html
-
-- name: Publish HTML book
-    uses: quarto-dev/quarto-actions/publish@v2
-  with:
-    target: gh-pages
-    render: false
-```

examples/example-07-publish-single-format.md

@@ -0,0 +1,19 @@
+# Quarto Actions: Rendering a single format
+
+With the `publish` action, it is either rendering all format by default, or none with  `render: false`. If you need to customize the rendering step, e.g. only render one format in CI before publishing, use a two step process: 
+
+* use the `quarto-actions/render@v2` action and provide a target output format (in this example YAML configuration, we use the HTML format)
+* use the `quarto-actions/publish@v2` action with `render: false` to skip rendering before publishing (in this example YAML configuration, we publish to GitHub Pages)
+
+```yaml
+- name: Render Book project
+  uses: quarto-dev/quarto-actions/render@v2
+  with:
+    to: html
+
+- name: Publish HTML book
+    uses: quarto-dev/quarto-actions/publish@v2
+  with:
+    target: gh-pages
+    render: false
+```