diff --git a/packages/babel-core/README.md b/packages/babel-core/README.md
index 3db09945ec..9dc2dac20c 100644
--- a/packages/babel-core/README.md
+++ b/packages/babel-core/README.md
@@ -9,7 +9,9 @@ import { transform } from 'babel-core';
 import * as babel from 'babel-core';
 ```
 
-## babel.transform(code: string, [options?](/docs/usage/api/#options): Object)
+All transformation will use your local configuration files (.babelrc or in package.json). See [options](#options) to disable it.
+
+## babel.transform(code: string, [options?](#options): Object)
 
 Transforms the passed in `code`. Returning an object with the generated code,
 source map, and AST.
@@ -27,7 +29,7 @@ result.map;
 result.ast;
 ```
 
-## babel.transformFile(filename: string, [options?](/docs/usage/api/#options): Object, callback: Function)
+## babel.transformFile(filename: string, [options?](#options): Object, callback: Function)
 
 Asynchronously transforms the entire contents of a file.
 
@@ -43,7 +45,7 @@ babel.transformFile("filename.js", options, function (err, result) {
 });
 ```
 
-## babel.transformFileSync(filename: string, [options?](/docs/usage/api/#options): Object)
+## babel.transformFileSync(filename: string, [options?](#options): Object)
 
 Synchronous version of `babel.transformFile`. Returns the transformed contents of
 the `filename`.
@@ -58,7 +60,7 @@ babel.transformFileSync(filename, options) // => { code, map, ast }
 babel.transformFileSync("filename.js", options).code;
 ```
 
-## babel.transformFromAst(ast: Object, code?: string, [options?](/docs/usage/api/#options): Object)
+## babel.transformFromAst(ast: Object, code?: string, [options?](#options): Object)
 
 Given, an [AST](https://astexplorer.net/), transform it.