diff --git a/R/reprex-undo.R b/R/reprex-undo.R
index c71824ff..8012764e 100644
--- a/R/reprex-undo.R
+++ b/R/reprex-undo.R
@@ -37,10 +37,9 @@ NULL
 #'   #' More text
 #'   y <- 2:5
 #'   x + y
-#' }, show = FALSE, advertise = FALSE)
-#' writeLines(x)
-#' x <- reprex_invert(x)
-#' writeLines(x)
+#' }, show = FALSE, advertise = FALSE, outfile = "roundtrip-input")
+#' x <- reprex_invert(x, outfile = "roundtrip-output")
+#' x
 #' }
 reprex_invert <- function(input = NULL,
                           outfile = NULL,
@@ -78,8 +77,8 @@ reprex_invert <- function(input = NULL,
 #'   "median(x)",
 #'   "#> [1] 2.5"
 #'   )
-#' out <- reprex_clean(x)
-#' writeLines(out)
+#' out <- reprex_clean(x, outfile = "commented-code")
+#' out
 #'
 #' ## round trip with reprex(..., venue = "R")
 #' code_in <- c("x <- rnorm(2)", "min(x)")
@@ -109,8 +108,8 @@ reprex_clean <- function(input = NULL,
 #'   "> median(x)",
 #'   "[1] 2.5"
 #' )
-#' out <- reprex_rescue(x)
-#' writeLines(out)
+#' out <- reprex_rescue(x, outfile = "live-transcript")
+#' out
 #' }
 reprex_rescue <- function(input = NULL,
                           outfile = NULL,
diff --git a/docs/reference/un-reprex.html b/docs/reference/un-reprex.html
index c81b2f06..a6c03325 100644
--- a/docs/reference/un-reprex.html
+++ b/docs/reference/un-reprex.html
@@ -177,10 +177,9 @@ <h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examp
   <span class='co'>#' More text</span>
   <span class='no'>y</span> <span class='kw'>&lt;-</span> <span class='fl'>2</span>:<span class='fl'>5</span>
   <span class='no'>x</span> + <span class='no'>y</span>
-}, <span class='kw'>show</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>, <span class='kw'>advertise</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>)
-<span class='fu'>writeLines</span>(<span class='no'>x</span>)
-<span class='no'>x</span> <span class='kw'>&lt;-</span> <span class='fu'>reprex_invert</span>(<span class='no'>x</span>)
-<span class='fu'>writeLines</span>(<span class='no'>x</span>)
+}, <span class='kw'>show</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>, <span class='kw'>advertise</span> <span class='kw'>=</span> <span class='fl'>FALSE</span>, <span class='kw'>outfile</span> <span class='kw'>=</span> <span class='st'>"roundtrip-input"</span>)
+<span class='no'>x</span> <span class='kw'>&lt;-</span> <span class='fu'>reprex_invert</span>(<span class='no'>x</span>, <span class='kw'>outfile</span> <span class='kw'>=</span> <span class='st'>"roundtrip-output"</span>)
+<span class='no'>x</span>
 <span class='co'># }</span><span class='co'># NOT RUN {</span>
 <span class='co'>## a displayed reprex can be cleaned of commented output</span>
 <span class='no'>x</span> <span class='kw'>&lt;-</span> <span class='fu'>c</span>(
@@ -190,8 +189,8 @@ <h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examp
   <span class='st'>"median(x)"</span>,
   <span class='st'>"#&gt; [1] 2.5"</span>
   )
-<span class='no'>out</span> <span class='kw'>&lt;-</span> <span class='fu'>reprex_clean</span>(<span class='no'>x</span>)
-<span class='fu'>writeLines</span>(<span class='no'>out</span>)
+<span class='no'>out</span> <span class='kw'>&lt;-</span> <span class='fu'>reprex_clean</span>(<span class='no'>x</span>, <span class='kw'>outfile</span> <span class='kw'>=</span> <span class='st'>"commented-code"</span>)
+<span class='no'>out</span>
 
 <span class='co'>## round trip with reprex(..., venue = "R")</span>
 <span class='no'>code_in</span> <span class='kw'>&lt;-</span> <span class='fu'>c</span>(<span class='st'>"x &lt;- rnorm(2)"</span>, <span class='st'>"min(x)"</span>)
@@ -208,8 +207,8 @@ <h2 class="hasAnchor" id="examples"><a class="anchor" href="#examples"></a>Examp
   <span class='st'>"&gt; median(x)"</span>,
   <span class='st'>"[1] 2.5"</span>
 )
-<span class='no'>out</span> <span class='kw'>&lt;-</span> <span class='fu'>reprex_rescue</span>(<span class='no'>x</span>)
-<span class='fu'>writeLines</span>(<span class='no'>out</span>)
+<span class='no'>out</span> <span class='kw'>&lt;-</span> <span class='fu'>reprex_rescue</span>(<span class='no'>x</span>, <span class='kw'>outfile</span> <span class='kw'>=</span> <span class='st'>"live-transcript"</span>)
+<span class='no'>out</span>
 <span class='co'># }</span></pre>
   </div>
   <div class="col-md-3 hidden-xs hidden-sm" id="sidebar">
diff --git a/man/un-reprex.Rd b/man/un-reprex.Rd
index 0e72e2cd..baa6b170 100644
--- a/man/un-reprex.Rd
+++ b/man/un-reprex.Rd
@@ -79,10 +79,9 @@ x <- reprex({
   #' More text
   y <- 2:5
   x + y
-}, show = FALSE, advertise = FALSE)
-writeLines(x)
-x <- reprex_invert(x)
-writeLines(x)
+}, show = FALSE, advertise = FALSE, outfile = "roundtrip-input")
+x <- reprex_invert(x, outfile = "roundtrip-output")
+x
 }
 \dontrun{
 ## a displayed reprex can be cleaned of commented output
@@ -93,8 +92,8 @@ x <- c(
   "median(x)",
   "#> [1] 2.5"
   )
-out <- reprex_clean(x)
-writeLines(out)
+out <- reprex_clean(x, outfile = "commented-code")
+out
 
 ## round trip with reprex(..., venue = "R")
 code_in <- c("x <- rnorm(2)", "min(x)")
@@ -112,7 +111,7 @@ x <- c(
   "> median(x)",
   "[1] 2.5"
 )
-out <- reprex_rescue(x)
-writeLines(out)
+out <- reprex_rescue(x, outfile = "live-transcript")
+out
 }
 }